gitwtfhub

wtf is flacconverter?

daquino94/flacconverter — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A Docker container that watches a folder and automatically converts FLAC music files into smaller M4A or MP3 files, keeping folder structure, cover art, and metadata.

Mindmap

mindmap
  root((flacConverter))
    What it does
      Watches a folder
      Converts FLAC files
      Preserves cover art
    Tech stack
      Docker
      ffmpeg
      Shell scripts
    Use cases
      Portable music library
      iPod-friendly files
      Automated batch conversion
    Audience
      Home music collectors
      Self-hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automatically convert a lossless FLAC music library into smaller M4A or MP3 files for a phone or iPod.

REASON 2

Keep a folder of converted music in sync with a source library as new albums get added.

REASON 3

Batch-convert a large FLAC collection in parallel instead of converting files one at a time.

REASON 4

Preserve cover art and metadata tags when shrinking an audio library for portable use.

What's in the stack?

ShellDockerffmpeg

How it stacks up

daquino94/flacconverter123satyajeet123/bitnet-serverahloiscreamo/pod-search
Stars000
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker and Docker Compose, plus editing docker-compose.yml with your folder paths.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This project is a Docker container that watches a folder for FLAC audio files and automatically converts them into M4A (AAC) or MP3 files. It is built for people who keep a lossless music library on disk but also want smaller, more portable copies for devices like an iPod, without converting each new file by hand. When the container starts, it scans the source folder for FLAC files and converts any that do not already have an up to date copy in the output folder. Conversions run in parallel, up to a number of jobs you can set yourself. Every so often, controlled by a POLL_INTERVAL setting, it rescans the folder from scratch so new files, new albums, or new subfolders get picked up without restarting the container. The tool checks folders on a timer rather than watching for live filesystem events, because that kind of live watching is unreliable across Docker on non-Linux hosts, so new files may take up to POLL_INTERVAL seconds to be noticed rather than being converted instantly. The output keeps the same folder structure as the source, for example an Artist and Album layout, and it copies over embedded cover art and metadata tags like title, artist, album, and track number. You can choose whether the output format is M4A or MP3, set the bitrate, and choose whether the original FLAC file gets deleted after conversion. Setup is done through a docker-compose.yml file where you point the container at your source and output folders and set these options as environment variables. For audio quality, the README explains that at the same bitrate AAC generally sounds better than MP3, and that this container uses a specific AAC encoder chosen to avoid artifacts that ffmpeg's default encoder can introduce on some tracks. If a source file has no embedded cover art, no cover gets added automatically. The project is licensed under the MIT License.

Yoink these prompts

Prompt 1
Help me write a docker-compose.yml for this FLAC converter pointing at my music and output folders.
Prompt 2
Explain the difference between the M4A and MP3 output options this tool offers.
Prompt 3
Walk me through setting PARALLEL_JOBS and POLL_INTERVAL for a large music library.
Prompt 4
Show me how to check the container logs to confirm my FLAC files are being converted.

Frequently asked questions

wtf is flacconverter?

A Docker container that watches a folder and automatically converts FLAC music files into smaller M4A or MP3 files, keeping folder structure, cover art, and metadata.

What language is flacconverter written in?

Mainly Shell. The stack also includes Shell, Docker, ffmpeg.

What license does flacconverter use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is flacconverter to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is flacconverter for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.