Skip to main content

audio-transcode-watcher

A containerized service that watches a source folder and automatically transcodes audio files to multiple formats simultaneously.

PyPI Tests License Docker Pulls

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 .lrc lyrics, 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

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

GPL-3.0-or-later

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)

Source distribution for audio-transcode-watcher 0.7.2
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)

Table of built distributions (wheels) for audio-transcode-watcher 0.7.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page