dasaod/flac2mp3 repository overview

⁠flac2mp3-watcher

A lightweight Docker container that watches a directory tree for FLAC files and automatically converts them to MP3 (320k CBR) in-place. The source FLAC file is deleted after a successful conversion.

Built on Alpine Linux with ffmpeg and inotify-tools. Unraid-friendly (runs as UID 99 / GID 100).

Docker Hub: dasaod/flac2mp3⁠

⁠Features

• Watches recursively via inotify — reacts immediately, no polling
• Converts FLAC → MP3 at 320k CBR, preserving metadata tags
• Deletes the original FLAC after a successful conversion
• Initial scan on startup (converts any existing FLAC files)
• Skips files where an up-to-date MP3 already exists
• Log rotation (configurable size and number of backups)
• Healthcheck: verifies inotifywait is running
• Unraid-friendly: runs as nobody:users (99:100), respects umask

⁠Quick Start

docker run -d \n  --name flac2mp3-watcher \n  -e ROOT=/media \n  -v /path/to/your/music:/media \n  -v /path/to/appdata/flac2mp3:/config \n  dasaod/flac2mp3:latest

⁠Environment Variables

⁠Changelog

⁠1.2

• Fix: log rotation now called on every log entry
• Fix: relative paths from inotify always resolved to absolute
• Improved: case-insensitive FLAC extension matching

⁠1.1

• Added log rotation
• Added Healthcheck

⁠1.0

• Initial release

⁠Mitwirkende

Dieses Projekt wurde in Zusammenarbeit mit Claude⁠ (Sonnet 4.6) von Anthropic⁠ entwickelt und iterativ ausgebaut.
Der überwiegende Teil des Codes, der Architektur und der Dokumentation wurde durch KI generiert und gemeinsam verfeinert.

⁠License

MIT⁠