███████╗██╗███╗ ███╗██████╗ ██╗ ███████╗███╗ ███╗██╗ ██╗██╗ ██╗
██╔════╝██║████╗ ████║██╔══██╗██║ ██╔════╝████╗ ████║██║ ██║╚██╗██╔╝
███████╗██║██╔████╔██║██████╔╝██║ █████╗ ██╔████╔██║██║ ██║ ╚███╔╝
╚════██║██║██║╚██╔╝██║██╔═══╝ ██║ ██╔══╝ ██║╚██╔╝██║██║ ██║ ██╔██╗
███████║██║██║ ╚═╝ ██║██║ ███████╗███████╗██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗
╚══════╝╚═╝╚═╝ ╚═╝╚═╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
SimpleMux is a free, open-source desktop app for editing audio metadata.
| Feature | Description | |
|---|---|---|
| 🎵 | Multi-Format Support | MP3, FLAC, WAV, OGG, AAC/M4A |
| ✏️ | Tag Editing | Title, artist, album, track number, year, genre, comments |
| 🖼️ | Album Art | View, embed, replace, and remove cover art |
| 📦 | Batch Editing | Edit tags across multiple files at once |
| 📝 | Smart Rename | Rename files using metadata templates ({artist} - {title}) |
| 🎨 | Adaptive Theme | Syncs with your system dark/light mode, or toggle manually |
| ⌨️ | Keyboard First | Full keyboard shortcuts (platform-aware: ⌘ on Mac, Ctrl on Windows) |
| 🔒 | Local & Private | No accounts, no cloud, no telemetry. Your music stays yours. |
| 📂 | Drag & Drop | Drop files or folders right into the app |
| Platform | Download | Notes |
|---|---|---|
| 🍎 macOS | Download .dmg | macOS 10.15+ |
| 🪟 Windows | Download .exe | Windows 10+ |
| 🐧 Linux | Download .AppImage / .deb | Ubuntu 20.04+ |
Builds are generated automatically. Download the latest release from the Releases page.
🍎 macOS — Installation Guide
- Download the
.dmgfrom Releases - Open the
.dmgand drag SimpleMux into your Applications folder - On first launch, right-click (or Control-click) the app and select Open
- Click Open in the dialog — macOS remembers your choice and won't ask again
Quick alternative — run this once in Terminal after installing:
xattr -cr /Applications/SimpleMux.appThen double-click the app normally.
| Action | Mac | Windows / Linux |
|---|---|---|
| Open Files | ⌘O |
Ctrl+O |
| Open Folder | ⌘⇧O |
Ctrl+Shift+O |
| Save | ⌘S |
Ctrl+S |
| Save All | ⌘⇧S |
Ctrl+Shift+S |
| Format | Read | Write | Notes |
|---|---|---|---|
| MP3 | ✅ | ✅ | ID3v1 / ID3v2 |
| FLAC | ✅ | ✅ | Vorbis Comments |
| WAV | ✅ | ✅ | RIFF INFO / ID3 |
| OGG | ✅ | ✅ | Vorbis Comments |
| AAC / M4A | ✅ | ✅ | MP4 / iTunes tags |
| Technology | Purpose | |
|---|---|---|
| ⚡ | Electron 28 | Desktop runtime |
| ⚛️ | React 18 | UI framework |
| 🔷 | TypeScript | Type safety |
| 🎨 | Tailwind CSS | Styling |
| 📦 | Vite | Build tooling |
| 🐻 | Zustand | State management |
| 🎵 | music-metadata | Metadata parsing |
| 🏷️ | node-taglib-sharp | Tag writing |
🏗️ Building from Source
Prerequisites: Node.js 18+
# Clone the repository
git clone https://github.com/eterniastudio/SimpleMux.git
cd SimpleMux
# Install dependencies
npm install
# Run in development mode
npm run dev
# Package for distribution
npm run package