DasAoD/flac2mp3
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Docker container that watches a directory for FLAC files and automatically converts them to MP3 (320k CBR). Unraid-friendly.
24 commits 1 branch 4 tags 78 KiB
  • Shell 67.3%
  • Dockerfile 32.7%
Find a file
Exact
DasAoD fdc4b70cd0 docs: add changelog entries v0.1.3 through v0.1.6
2026-06-20 16:07:49 +02:00
.github/workflows docs/ci: fix changelog version tags, restrict workflow to code changes 2026-06-20 16:05:10 +02:00
.gitignore ci: trigger workflow test 2026-06-20 14:54:34 +02:00
Dockerfile v1.3: fix ffmpeg stdin isolation and inotifywait pipe bug 2026-05-17 13:38:27 +02:00
flac2mp3-icon-v3-256.png feat: initial commit 2026-03-17 01:41:53 +01:00
LICENSE chore: add MIT license 2026-03-17 01:45:24 +01:00
README.md docs: add changelog entries v0.1.3 through v0.1.6 2026-06-20 16:07:49 +02:00
watcher.sh v1.3: fix ffmpeg stdin isolation and inotifywait pipe bug 2026-05-17 13:38:27 +02:00

README.md

Docker Hub

flac2mp3-watcher

📌 Mirror-Hinweis: Dieses Repository ist ein automatischer Spiegel. Die primäre Entwicklung findet auf git.uliana.de/DasAoD/flac2mp3 statt. Issues und Pull Requests bitte dort öffnen.

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 \
  --name flac2mp3-watcher \
  -e ROOT=/media \
  -v /path/to/your/music:/media \
  -v /path/to/appdata/flac2mp3:/config \
  dasaod/flac2mp3:latest

Environment Variables

Variable Default Description
ROOT /media Directory to watch
UMASK_VAL 002 File creation umask
LOGFILE /config/flac2mp3-watcher.log Log file path
LOG_MAX_MB 10 Max log size in MB
LOG_BACKUPS 3 Number of rotated log files to keep

Changelog

v0.1.6

  • ci: restrict workflow to Dockerfile and watcher.sh changes

v0.1.5

  • docs: add Docker Hub version badge

v0.1.4

  • ci: add Forgejo Actions workflow for Docker Build & Push

v0.1.3

  • Initial versioned release (corresponds to previous tag 1.3)

v0.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

v0.1.1

  • Added log rotation
  • Added Healthcheck

v0.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.

Rolle Person / Tool
Projektidee, Anforderungen & Tests DasAoD
Code, Architektur, Dokumentation Claude (Anthropic)

License

MIT