🎵 Albumus Audio Compiler

Albumus Audio Compiler is a Python-based tool that converts raw audio files into fully tagged, multi-format music albums with embedded cover art. It is designed for musicians, archivists, and developers who want streamlined batch processing using structured folders.

📦 Features

• Compile albums from .wav, .flac, .mp3, or .ogg source files
• Export to FLAC, MP3, OGG, and WAV formats
• Auto-detect track numbers and apply formatted output names
• Embed album art using folder.png
• Generate album art variants (cover.jpg, thumb.jpg, etc.)
• Organize output in per-format folders
• Run via GUI (gui.py) or CLI (compile_audio.py)
• Colorized logging and output tracking

🖥️ Requirements

• Python 3.9+
• FFmpeg in your system PATH
• Python packages:
  • mutagen
  • Pillow
  • customtkinter (GUI only)

Install dependencies:

pip install -r requirements.txt

🚀 Quick Start

🖱️ GUI (Recommended)

python gui.py

From the interface you can:

• Select a project directory
• Click compile_audio to convert tracks
• Click clear_output to delete the output directory

💻 Command Line

Compile albums directly:

python source/python_packages_custom/compile_audio.py

Clear generated output:

python source/python_packages_custom/clear_output.py

📖 Documentation

• Setup Guide: Install Python, FFmpeg, dependencies, and run Albumus
• GUI Guide: Use the interactive interface for project selection and task execution
• Terminal Guide: CLI usage for automation, scripting, and batch processing
• Configuration Reference: Available settings and customization options

🛠️ Example Projects

• Minimal example: example/min
• Full example: example/full

📂 Project Structure

Input:

example/
|-- config.json
`-- in/
    `-- TitleArtist/
        |-- metadata_artist.json
        `-- 01_TitleAlbum/
            |-- 01_ExampleAudioFileWAV.wav
            |-- 02_ExampleAudioFileFLAC.flac
            |-- 03_ExampleAudioFileMP3.mp3
            |-- 04_ExampleAudioFileOGG.ogg
            |-- folder.png
            |-- metadata_album.json
            `-- metadata_track.json

Output:

out/
`-- TitleArtist/
    `-- 01_TitleAlbum/
        |-- cover.jpg
        |-- thumb.jpg
        |-- flac/
        |   `-- 01_ExampleAudioFileWAV.flac
        |-- mp3/
        |   `-- 01_ExampleAudioFileWAV.mp3
        |-- ogg/
        |   `-- 01_ExampleAudioFileWAV.ogg
        `-- wav/
            `-- 01_ExampleAudioFileWAV.wav

💡 Tips

• Keep project config.json valid and UTF-8 encoded
• Name album art folder.png before compiling
• Run clear_output before rebuilding for a clean export

📜 License

Licensed under GNU GPL v3. Projects created using this tool are not required to use the GPL license and may be licensed however you wish.

⚠️ Disclaimer

This tool is provided "as-is" with no warranty. Use at your own risk. Contributions are welcome.