migrate to uv and modern package structure

Author: slhck

.github/workflows/python-package.yml

@@ -19,13 +19,13 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
     - name: Cache ffmpeg download
-      uses: actions/cache@v3
+      uses: actions/cache@v4
       id: cache-ffmpeg
       with:
         path: /opt/ffmpeg/ffmpeg-n${{ env.FFMPEG_VERSION }}-latest-linux64-gpl-${{ env.FFMPEG_VERSION }}.tar.xz
@@ -45,13 +45,14 @@ jobs:
         sudo cp /opt/ffmpeg/extracted/bin/ffprobe /usr/bin/ffprobe
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -r requirements.dev.txt
-        pip install .
+        uv sync --group dev
+    - name: Lint with ruff
+      run: |
+        uv run ruff check .
+        uv run ruff format --check .
     - name: Type check with mypy
       run: |
-        mypy ffmpeg_normalize
+        uv run mypy .
     - name: Test with pytest
       run: |
-        pytest
+        uv run pytest tests/

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.11
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

CLAUDE.md

@@ -9,16 +9,16 @@ ffmpeg-normalize is a Python utility for audio normalization using ffmpeg. It su
 ## Development Commands
 
 ### Testing
-- `pytest` - Run all tests (requires installing requirements.dev.txt)
-- `python -m ffmpeg_normalize [args]` - Run the tool directly for testing
+- `uv run pytest` - Run all tests
+- `uv run python -m ffmpeg_normalize [args]` - Run the tool directly for testing
 
 ### Code Quality
-- `ruff` - Linting and code formatting
-- `mypy` - Type checking
+- `uv run ruff check .` - Linting
+- `uv run ruff format .` - Code formatting  
+- `uv run mypy src/ffmpeg_normalize` - Type checking
 
 ### Installation
-- `pip install -r requirements.txt` - Install runtime dependencies
-- `pip install -r requirements.dev.txt` - Install development dependencies
+- `uv sync --dev` - Install all dependencies (runtime and development)
 
 ### Documentation
 - `pdoc -d google -o docs-api ./ffmpeg_normalize` - Generate API documentation
@@ -56,7 +56,7 @@ The project uses:
 - `colorama` (Windows only) for colored terminal output
 
 ### File Structure
-- `ffmpeg_normalize/` - Main package directory
+- `src/ffmpeg_normalize/` - Main package directory
 - `tests/` - Test files and test media samples
 - `docs/` - MKdocs documentation source
 - `completions/` - Shell completion scripts

DEVELOPERS.md

@@ -4,13 +4,14 @@
 
 Tests are located in `tests/test_*.py`. To run them:
 
-- Install `requirements.txt` and `requirements.dev.txt`
-- Run `pytest`
+- Install `uv` (see [installation guide](https://github.com/astral-sh/uv#installation))
+- Run `uv sync --dev` to install all dependencies
+- Run `uv run pytest` to run the tests
 
 ## Creating API Docs
 
 ```bash
-pdoc -d google -o docs-api ./ffmpeg_normalize
+pdoc -d google -o docs-api ./src/ffmpeg_normalize
 ```
 
 ## Creating MKdocs Releases

LICENSE

@@ -0,0 +1,9 @@
+# License
+
+ffmpeg-normalize, Copyright (c) Werner Robitza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

LICENSE.md

@@ -24,9 +24,8 @@ This program normalizes media files to a certain loudness level using the EBU R1
 ## 🚀 Quick Start
 
 1. Install a recent version of [ffmpeg](https://ffmpeg.org/download.html)
-2. Run `pip3 install ffmpeg-normalize`
-3. Run `ffmpeg-normalize /path/to/your/file.mp4`
-4. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)
+2. Run `pip3 install ffmpeg-normalize` and `ffmpeg-normalize /path/to/your/file.mp4`, alternatively install [`uv`](https://docs.astral.sh/uv/getting-started/installation/) and run `uvx ffmpeg-normalize /path/to/your/file.mp4`
+3. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)
 
 ## 📓 Documentation
 

README.md

@@ -1,16 +1,36 @@
 # Installation
 
-## Python Package
+## Via `uv` (recommended)
 
-For Python 3 and pip:
+Install `uv` from [their website](https://docs.astral.sh/uv/getting-started/installation/).
+
+Then run:
+
+```bash
+uvx ffmpeg-normalize
+```
+
+That's it.
+
+## Via `pipx`
+
+Install `pipx` from [their website](https://pipx.pypa.io/latest/installation/).
+
+Then run:
 
 ```bash
-pip3 install ffmpeg-normalize
+pipx install ffmpeg-normalize
 ```
 
-Or download this repository, then run `pip3 install .`.
+## Via `pip`
+
+For Python 3 and pip:
+
+```bash
+pip3 install --user ffmpeg-normalize
+```
 
-To later upgrade to the latest version, run `pip3 install --upgrade ffmpeg-normalize`.
+To later upgrade to the latest version, run `pip3 install --upgrade --user ffmpeg-normalize`.
 
 ## Shell Completions
 

docs/getting-started/installation.md

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["uv_build>=0.8.14,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "ffmpeg-normalize"
+version = "1.33.0"
+description = "Normalize audio via ffmpeg"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE.md"]
+authors = [
+    {name = "Werner Robitza", email = "werner.robitza@gmail.com"}
+]
+keywords = ["ffmpeg", "normalize", "audio"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Topic :: Multimedia :: Sound/Audio :: Analysis",
+    "Topic :: Multimedia :: Sound/Audio :: Conversion",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "tqdm>=4.64.1",
+    "colorama>=0.4.6; platform_system=='Windows'",
+    "ffmpeg-progress-yield>=1.0.1",
+    "colorlog==6.7.0",
+    "mutagen>=1.47.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/slhck/ffmpeg-normalize"
+Repository = "https://github.com/slhck/ffmpeg-normalize"
+
+[project.scripts]
+ffmpeg-normalize = "ffmpeg_normalize.__main__:main"
+
+[tool.uv_build]
+src-layout = true
+
+[dependency-groups]
+dev = [
+    "pytest>=8.1.1,<9",
+    "ruff>=0.12.11",
+    "mypy>=1.0.0",
+    "types-tqdm",
+]
+
+[tool.mypy]
+python_version = "3.13"
+ignore_missing_imports = true
+exclude = ["build"]
+namespace_packages = false
+no_implicit_optional = true
+check_untyped_defs = true
+warn_return_any = true
+warn_unused_ignores = true
+show_error_codes = true