audio-transcode-watcher 0.4.2__tar.gz → 0.5.0__tar.gz

audio_transcode_watcher-0.5.0/.coderabbit.yaml

@@ -0,0 +1,45 @@
+language: "en-US"
+tone_instructions: "Be direct and concise. No fluff."
+
+reviews:
+  profile: "chill"
+  high_level_summary: true
+  collapse_walkthrough: true
+  poem: false
+  sequence_diagrams: false
+  suggested_reviewers: false
+  auto_review:
+    enabled: true
+    drafts: false
+    ignore_title_keywords:
+      - "WIP"
+      - "DO NOT REVIEW"
+  path_filters:
+    - "!dist/**"
+    - "!**/__pycache__/**"
+    - "!**/*.pyc"
+  tools:
+    gitleaks:
+      enabled: true
+    hadolint:
+      enabled: true
+    actionlint:
+      enabled: true
+    yamllint:
+      enabled: true
+    markdownlint:
+      enabled: true
+    shellcheck:
+      enabled: true
+
+chat:
+  auto_reply: true
+
+knowledge_base:
+  learnings:
+    scope: "local"
+  code_guidelines:
+    enabled: true
+    filePatterns:
+      - "AGENTS.md"
+      - "CLAUDE.md"

audio_transcode_watcher-0.5.0/.github/workflows/dockerhub-description.yml

@@ -0,0 +1,19 @@
+name: Docker Hub Description
+
+on:
+  push:
+    branches: [main]
+    paths: [README.md]
+  workflow_dispatch:
+
+jobs:
+  update-description:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: peter-evans/dockerhub-description@v4
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+          repository: drumsergio/audio-transcoder

{audio_transcode_watcher-0.4.2 → audio_transcode_watcher-0.5.0}/.github/workflows/release.yml

@@ -35,6 +35,8 @@ jobs:
     permissions:
       contents: write
       packages: write
+    env:
+      PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
 
     steps:
       - uses: actions/checkout@v4
@@ -83,13 +85,31 @@ jobs:
           generate_release_notes: true
           body: |
             ## Docker Image
-            
+
             ```bash
             docker pull ${{ env.IMAGE_NAME }}:${{ steps.version.outputs.VERSION }}
             ```
-            
+
             ## What's Changed
-            
+
             See the automatically generated release notes below.
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.14'
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build Python package
+        run: python3 -m build
+
+      - name: Publish to PyPI
+        if: ${{ env.PYPI_TOKEN != '' }}
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*

audio_transcode_watcher-0.5.0/.github/workflows/stale.yml

@@ -0,0 +1,19 @@
+name: Close stale issues
+on:
+  schedule:
+    - cron: '0 0 * * *'
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          stale-issue-message: 'This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs.'
+          close-issue-message: 'This issue was closed because it has been stale for 14 days with no activity.'
+          days-before-issue-stale: 14
+          days-before-issue-close: 14
+          stale-issue-label: 'stale'
+          exempt-issue-labels: 'pinned'
+          days-before-pr-stale: -1
+          days-before-pr-close: -1

{audio_transcode_watcher-0.4.2 → audio_transcode_watcher-0.5.0}/.github/workflows/tests.yml

@@ -1,6 +1,7 @@
 name: Tests
 
 on:
+  workflow_dispatch:
   push:
     branches: [main]
   pull_request:
@@ -28,9 +29,8 @@ jobs:
           pytest --cov --cov-report=xml --cov-report=term-missing
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml
           fail_ci_if_error: false
 

audio_transcode_watcher-0.5.0/AGENTS.md

@@ -0,0 +1,18 @@
+# AGENTS.md — Audio Transcode Watcher
+
+## Project Overview
+
+Automated multi-format audio transcoding service with real-time file watching and lyrics fetching.
+
+- **Repo:** [GeiserX/audio-transcode-watcher](https://github.com/GeiserX/audio-transcode-watcher)
+- **Language:** Python
+- **License:** GPL-3.0
+
+## Security
+
+> **Do not commit secrets to the repository.**
+> Use environment variables or secure vaults for credentials.
+
+---
+
+*Generated by [LynxPrompt](https://lynxprompt.com) CLI*

{audio_transcode_watcher-0.4.2 → audio_transcode_watcher-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audio-transcode-watcher
-Version: 0.4.2
+Version: 0.5.0
 Summary: Watch a source folder and automatically transcode audio files to multiple formats
 Project-URL: Homepage, https://github.com/GeiserX/audio-transcode-watcher
 Project-URL: Repository, https://github.com/GeiserX/audio-transcode-watcher
@@ -65,6 +65,7 @@ Perfect for maintaining a music library in multiple formats -- lossless for arch
 ## Features
 
 - **Real-time file watching** -- Detects new, modified, renamed, or deleted files via watchdog
+- **Recursive directory support** -- Mirrors source folder hierarchy (Artist/Album) in all outputs
 - **Multiple simultaneous outputs** -- Transcode to any number of formats in a single pass
 - **Six codecs** -- ALAC, AAC, MP3, Opus, FLAC, WAV with configurable bitrates
 - **Synced lyrics** -- Auto-fetches `.lrc` lyrics with Whisper speech-to-text fallback
@@ -106,7 +107,7 @@ outputs:
 ```yaml
 services:
   audio-transcoder:
-    image: drumsergio/audio-transcoder:0.4.1
+    image: drumsergio/audio-transcoder:0.5.0
     container_name: audio_transcoder
     environment:
       - TZ=Europe/Madrid
@@ -137,7 +138,7 @@ docker run -d \
   -v /path/to/flac:/music/flac:ro \
   -v /path/to/mp3:/music/mp3 \
   --restart unless-stopped \
-  drumsergio/audio-transcoder:0.4.1
+  drumsergio/audio-transcoder:0.5.0
 ```
 
 ## Configuration
@@ -229,6 +230,26 @@ environment:
 3. **Orphan cleanup** -- Removes output files that no longer have a matching source.
 4. **Lyrics sync** -- Fetches synced `.lrc` lyrics from online databases; falls back to Whisper transcription when no lyrics are found.
 
+### Recursive Directory Support
+
+Source folder hierarchy is automatically mirrored in all outputs. Both flat and nested structures work out of the box -- no configuration needed.
+
+```text
+Source:                          Output (MP3):
+/music/flac/                     /music/mp3/
+├── Artist A/                    ├── Artist A/
+│   ├── Album 1/                 │   ├── Album 1/
+│   │   ├── 01 - Track.flac     │   │   ├── 01 - Track.mp3
+│   │   └── 02 - Track.flac     │   │   └── 02 - Track.mp3
+│   └── Album 2/                 │   └── Album 2/
+│       └── 01 - Song.flac      │       └── 01 - Song.mp3
+└── Artist B/                    └── Artist B/
+    └── Live Album/                  └── Live Album/
+        └── 01 - Intro.flac             └── 01 - Intro.mp3
+```
+
+When source files or directories are deleted, the corresponding outputs and empty directories are cleaned up automatically.
+
 ### Safety Guards
 
 The service includes multiple guards to prevent data loss:

{audio_transcode_watcher-0.4.2 → audio_transcode_watcher-0.5.0}/README.md

@@ -34,6 +34,7 @@ Perfect for maintaining a music library in multiple formats -- lossless for arch
 ## Features
 
 - **Real-time file watching** -- Detects new, modified, renamed, or deleted files via watchdog
+- **Recursive directory support** -- Mirrors source folder hierarchy (Artist/Album) in all outputs
 - **Multiple simultaneous outputs** -- Transcode to any number of formats in a single pass
 - **Six codecs** -- ALAC, AAC, MP3, Opus, FLAC, WAV with configurable bitrates
 - **Synced lyrics** -- Auto-fetches `.lrc` lyrics with Whisper speech-to-text fallback
@@ -75,7 +76,7 @@ outputs:
 ```yaml
 services:
   audio-transcoder:
-    image: drumsergio/audio-transcoder:0.4.1
+    image: drumsergio/audio-transcoder:0.5.0
     container_name: audio_transcoder
     environment:
       - TZ=Europe/Madrid
@@ -106,7 +107,7 @@ docker run -d \
   -v /path/to/flac:/music/flac:ro \
   -v /path/to/mp3:/music/mp3 \
   --restart unless-stopped \
-  drumsergio/audio-transcoder:0.4.1
+  drumsergio/audio-transcoder:0.5.0
 ```
 
 ## Configuration
@@ -198,6 +199,26 @@ environment:
 3. **Orphan cleanup** -- Removes output files that no longer have a matching source.
 4. **Lyrics sync** -- Fetches synced `.lrc` lyrics from online databases; falls back to Whisper transcription when no lyrics are found.
 
+### Recursive Directory Support
+
+Source folder hierarchy is automatically mirrored in all outputs. Both flat and nested structures work out of the box -- no configuration needed.
+
+```text
+Source:                          Output (MP3):
+/music/flac/                     /music/mp3/
+├── Artist A/                    ├── Artist A/
+│   ├── Album 1/                 │   ├── Album 1/
+│   │   ├── 01 - Track.flac     │   │   ├── 01 - Track.mp3
+│   │   └── 02 - Track.flac     │   │   └── 02 - Track.mp3
+│   └── Album 2/                 │   └── Album 2/
+│       └── 01 - Song.flac      │       └── 01 - Song.mp3
+└── Artist B/                    └── Artist B/
+    └── Live Album/                  └── Live Album/
+        └── 01 - Intro.flac             └── 01 - Intro.mp3
+```
+
+When source files or directories are deleted, the corresponding outputs and empty directories are cleaned up automatically.
+
 ### Safety Guards
 
 The service includes multiple guards to prevent data loss:

audio_transcode_watcher-0.5.0/docs/ROADMAP.md

@@ -0,0 +1,88 @@
+# Roadmap
+
+Current version: **0.5.0**
+
+## Completed
+
+- **Parallel encoding** with configurable workers (v0.1.0)
+- **Lossless source priority** over MP3 duplicates (v0.1.1)
+- **Stale temp file cleanup** on startup (v0.1.2)
+- **Synced lyrics sidecar** (.lrc) copying to outputs (v0.2.0)
+- **Auto-fetch synced lyrics** via syncedlyrics providers (v0.3.0)
+- **Whisper local transcription fallback** for lyrics (v0.4.0)
+- **Recursive directory support** -- mirror source folder hierarchy in outputs (v0.5.0)
+
+## v0.6.0 -- Quality of Life
+
+- [ ] **Progress reporting during initial sync**
+  - Show file count progress (e.g. 42/500)
+  - Log estimated time remaining for large libraries
+
+- [ ] **Graceful shutdown**
+  - Complete in-progress encodes before stopping
+  - Resume interrupted syncs on next startup
+
+- [ ] **Dry-run mode**
+  - Preview what would be encoded without doing it
+  - Useful for testing configuration changes
+
+## v0.7.0 -- Observability
+
+- [ ] **Health check endpoint**
+  - HTTP endpoint for container health monitoring
+  - Prometheus metrics (files processed, errors, queue size)
+
+- [ ] **Notifications**
+  - Webhook/Shoutrrr support for encoding events
+  - Error alerts for failed encodes
+
+## v0.8.0 -- Smart Encoding
+
+- [ ] **FFmpeg multi-output (tee muxer)**
+  - Single decode pass, multiple encodes
+  - Significant CPU reduction for multi-output configurations
+
+- [ ] **Checksum-based re-encoding**
+  - Detect actual content changes vs. metadata-only touches
+  - Skip re-encode when source content is unchanged
+
+- [ ] **Replay gain support**
+  - Calculate and embed replay gain tags
+  - Album and track gain modes
+
+## Future Ideas (Backlog)
+
+### Format Support
+- [ ] Ogg Vorbis output codec
+- [ ] DSD/DSF input support (convert to PCM first)
+- [ ] Multi-channel audio handling (5.1 to stereo downmix option)
+
+### Metadata
+- [ ] MusicBrainz integration for missing metadata
+- [ ] Chapter markers for audiobooks
+
+### Integration
+- [ ] Plex/Jellyfin library refresh triggers
+- [ ] Lidarr/Beets integration
+
+### Analysis
+- [ ] Loudness normalization (EBU R128)
+- [ ] Silence trimming option
+- [ ] Duplicate detection
+
+## Contributing
+
+Have an idea not listed here? Open an issue on GitHub to discuss!
+
+Priority is given to:
+1. Bug fixes
+2. Performance improvements
+3. Features with clear use cases
+4. Backwards-compatible changes
+
+## Versioning
+
+This project follows [Semantic Versioning](https://semver.org/):
+- **MAJOR**: Breaking changes to config format or behavior
+- **MINOR**: New features, backwards compatible
+- **PATCH**: Bug fixes, performance improvements

{audio_transcode_watcher-0.4.2 → audio_transcode_watcher-0.5.0}/pyproject.toml

@@ -4,7 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "audio-transcode-watcher"
-version = "0.4.2"
+
+version = "0.5.0"
+
 description = "Watch a source folder and automatically transcode audio files to multiple formats"
 readme = "README.md"
 license = "GPL-3.0-or-later"