A containerized service that watches a source folder and automatically transcodes audio files to multiple formats simultaneously.
Keep one library in several formats: lossless for the archive, lossy for phones and cars. Drop a FLAC into the source folder and the ALAC, MP3, AAC and Opus copies appear in their own trees.
Features
- Watches the source folder and reacts to new, changed, renamed and deleted files.
- Writes any number of outputs in one pass, in ALAC, AAC, MP3, Opus, FLAC or WAV at the bitrate you pick.
- Mirrors the Artist/Album folder tree in every output.
- Copies lossy sources (MP3, M4A, Ogg, Opus, WMA) unchanged instead of inflating them into a lossless output.
- Fails loudly on a source that does not decode cleanly, and writes no output for it.
- Keeps ReplayGain, MusicBrainz ids, ISRC, label and sort tags in ALAC and AAC copies.
- Optionally measures every file and writes ReplayGain 2.0 track gain into the source and every output, so the whole library plays at one volume.
- Fetches synced
.lrclyrics, and writes nothing when no real lyrics are found. - Embeds cover art if you want it.
- Writes atomically and removes orphaned outputs, but never deletes anything when a folder looks empty.
- Handles Unicode file names.
- Ships as a small container on Python 3.14-slim with FFmpeg.
Quick start
curl -fsSL -o config.yaml https://raw.githubusercontent.com/GeiserX/audio-transcode-watcher/main/config.example.yaml
docker run -d --name audio_transcoder -e CONFIG_FILE=/app/config.yaml \
-v ./config.yaml:/app/config.yaml:ro -v /path/to/flac:/music/flac:ro -v /path/to/mp3:/music/mp3 \
drumsergio/audio-transcoder:0.7.2
Edit config.yaml first so its outputs match the folders you mount; the example writes ALAC, MP3 and AAC. Getting started has Docker Compose and the full docker run.
Documentation
- Getting started: Docker Compose and Docker CLI
- Configuration: the full YAML example, supported codecs,
CONFIG_JSON - Usage: what happens once it runs, and the verification tool
- How it works: sync and watch mode, folder mirroring, safety guards, performance
- Development: tests, building the image, contributing
- Roadmap
- Changelog
Related projects
| Project | Description |
|---|---|
| slskd-transform | Bulk upgrade your music library from lossy to lossless via Soulseek |
| telegram-slskd-local-bot | Automated music discovery and download via Telegram |
| quality-gate-encoder (formerly jellyfin-encoder) | Automatic 720p HEVC, H.264 or AV1 copies for Jellyfin |
License
Metadata
Release files for audio-transcode-watcher 0.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| audio_transcode_watcher-0.7.2.tar.gz | 164.1 kB | Without provenance | Details for audio_transcode_watcher-0.7.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| audio_transcode_watcher-0.7.2-py3-none-any.whl | Python 3 | none | any | Details for audio_transcode_watcher-0.7.2-py3-none-any.whl |
Total release size: 210.2 kB
Release files / audio_transcode_watcher-0.7.2.tar.gz
| Download URL | audio_transcode_watcher-0.7.2.tar.gz |
|---|---|
| Size | 164.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
227f529ac91ccfc2175549697bf998a1353ab3c76e0d46e8dbc2c8aa49b6ee8f
|
|
BLAKE2b-256 checksum How to use checksums |
86bf061605047640581763d5ca651dfa4092536fdc73e69d4c5d6f9935e7d7f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Release files / audio_transcode_watcher-0.7.2-py3-none-any.whl
| Download URL | audio_transcode_watcher-0.7.2-py3-none-any.whl |
|---|---|
| Size | 46.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dfb4afc79eff72b4a4f19ead424763ff0d68b233c7cbf76b2dd3a390f19b932d
|
|
BLAKE2b-256 checksum How to use checksums |
5b681e4d69e42a55047e33cc676453f948cec5867de1e1ab67cffd1e97615f05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Security for audio-transcode-watcher 0.7.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.