# Music Sorter - Codex Libris Mechanicus Audio Module

## 🔧 Description

A lightweight Python tool that automatically sorts music files into organized folders based on their embedded metadata.

This tool allows users to:

- Automatically organize music files into subfolders by Artist and Album.
- Extract metadata using embedded tags (ID3, FLAC, AAC, etc.).
- Provide an easy-to-use GUI interface.
- Supports multiple common music file formats: `.mp3`, `.flac`, `.wav`, `.aac`, `.ogg`.

Built to assist in organizing large personal music collections for cleaner libraries and easier file management.

---

## 💻 Features

- GUI interface (built with `tkinter`).
- Uses `mutagen` to extract metadata from audio files.
- Auto-generates folder structure `/Artist/Album/`.
- Lightweight, simple, and fast.
- Fully self-contained.

---

## 🛠 Supported Platforms

- Windows, macOS, Linux (requires Python 3.x installed)

---

## 🚀 Installation

1. Clone or download the repository.
2. Ensure Python 3 is installed.
3. Install required dependencies:

```bash
pip install mutagen
Run Music Sorter.py directly:

bash
Copy
Edit
python Music Sorter.py
🎶 Supported Music Formats
MP3 (.mp3)

FLAC (.flac)

WAV (.wav)

AAC (.aac)

OGG (.ogg)

📝 Notes
This project is intended for legally owned personal music libraries.

No music files are included.

This tool does not modify file contents — only metadata-based sorting.

⚠ Disclaimer
This project includes internal rules, references, and humor tied to Codex Libris Mechanicus and personal memory capsules (“The John Code”).

The John Code is embedded to preserve creator history, but is fully non-functional to main program operation.

Copyright (c) 2025 Couchtr26