🎵 Moidify

Your music. Anywhere. No strings attached.
A self-hosted music server that streams your collection to any browser.
Drop files. Listen instantly. No accounts required. No algorithms. No ads.

🚀 Quick Install · ✨ Features · ⚙️ Commands · 🔧 Configuration · 🛠️ Development

---

✨ Features

🎧 Streaming — MP3, FLAC, OGG, M4A, WAV — everything just works 🪟 Pop-out Mini Player — detach playback into a separate always-on-top window (desktop only; mobile uses the persistent bottom bar) 🔍 Full-text Search — search tracks, albums, artists with diacritics support (Beyonce → Beyoncé) 📂 Browse by Album / Artist / Genre — grid or list view with cover art 📋 Sortable Columns — click any column header to sort A–Z, Z–A, or by duration 📝 Playlists — create, pin, reorder by drag-and-drop

🎛️ 10-Band Equalizer — presets included (Rock, Jazz, Dance, Classical…) 📜 Lyrics — auto-fetched from LRCLIB, synced scrolling ⏱️ Sleep Timer — stop after this track, end of queue, or in X minutes 🔀 Smart Queue — crossfade, shuffle, repeat (all/one/off) 💾 Session Persistence — close or reload the tab and pick up exactly where you left off (position, queue, shuffle mode all saved) 💿 Vinyl Animation — spinning disc with CD hole effect on the queue cover art (toggle in settings) 🛡️ Admin Dashboard — rescan library, manage users, view play stats, upload files via drag-and-drop 🔧 Setup Wizard — first-run wizard at /setup creates admin account and guides configuration 🐳 Docker Support — Dockerfile + docker-compose.yml for containerized deployment 🔗 Shareable Playlists — generate a public link anyone can open and listen to (no account needed) 📻 On-the-fly Transcoding — serve medium (256k), low (128k), or voice (64k Opus) streams via ffmpeg 🏠 Personalized Home Feed — recently played, top listened, and randomly recommended tracks on login 🔌 Subsonic API Compatible — works with clients like Sonixd, Sublime Music, and DSub (/rest/getArtists, /rest/getAlbum, /rest/stream, scrobbling, star/unstar, and more) 🎮 Discord Rich Presence — companion script shows your currently playing track on Discord 📱 Responsive — works on desktop and mobile browsers 🎚️ Track Rating — rate songs 1-5 stars from the track list or context menu

---

🚀 Quick Install

One line, works on any Linux distro with systemd:

curl -sSL https://raw.githubusercontent.com/Moid-M/moidify/main/install.sh | sudo bash

📦 What the installer does (click to expand)

Step	What happens
1	Detects your distro (apt/dnf/pacman/zypper) and installs Python, pip, sqlite3
2	Creates a moidify system user
3	Copies the app to /opt/moidify
4	Sets up a Python virtual environment
5	Installs Python dependencies (FastAPI, uvicorn, mutagen, watchdog)
6	Asks for port number (default 8000)
7	Asks for your music folder location
8	Asks to create an admin account (optional — skip to use the browser setup wizard later)
9	Writes config to /etc/moidify/config.json
10	Installs a systemd service
11	Starts the server immediately

Tip

After installation, open http://your-server-ip:8000 in any browser. If no admin account exists yet, you'll be guided through the setup wizard at /setup. Drop music into your folder — files appear automatically.

Note

Moidify is 100% vibecoded.
Every line was written through natural language prompts — no copy-paste, no templates, just pure AI-generated code. If something breaks (and it might), please open an issue.
It'll get fixed, and the AI will learn from it.

---

🐳 Docker

git clone https://github.com/Moid-M/moidify.git
cd moidify
docker compose up -d

Then open http://localhost:8000. Music goes in ./music, data in ./data, covers in ./covers.

Tip

After starting, visit the setup wizard at /setup to create your admin account.

🖥️ Manual Install

For development or non-systemd systems:

git clone https://github.com/Moid-M/moidify.git
cd moidify
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 server.py

Then open http://localhost:8000.

---

⚙️ Commands

CLI (moidify)

After install, a moidify CLI is available globally:

moidify help          Show this help
moidify start         Start the service
moidify stop          Stop the service
moidify restart       Restart the service
moidify reload        Reload config and rescan library
moidify status        Show service status
moidify enable        Enable service on boot
moidify disable       Disable service on boot
moidify logs          Tail server logs
moidify config        Print current configuration
moidify version       Print version
moidify url           Print server URL
moidify update        Update to latest version

Service management (direct)

Action	Command
▶️ Start	sudo systemctl start moidify
⏹️ Stop	sudo systemctl stop moidify
🔄 Restart	sudo systemctl restart moidify
📊 Status	sudo systemctl status moidify
📜 Logs	journalctl -u moidify.service -f
🔄 Update	sudo /opt/moidify/update.sh
🗑️ Uninstall	sudo /opt/moidify/uninstall.sh

---

🔧 Configuration

Moidify checks three places for settings, in order of priority:

1. Environment variables (highest priority)
2. Config file at /etc/moidify/config.json (installed mode)
3. Local defaults (development mode)

Environment variables

Variable	Default (dev)	Description
MOIDIFY_MUSIC_DIR	./music	Path to your music folder
MOIDIFY_COVERS_DIR	./covers	Cover art cache location
MOIDIFY_DB_PATH	./data/music.db	SQLite database path
MOIDIFY_PORT	8000	Server port (systemd mode uses ExecStart directly)

Config file

When installed, settings live in /etc/moidify/config.json:

{
  "music_dir": "/path/to/your/music",
  "covers_dir": "/var/lib/moidify/covers",
  "db_path": "/var/lib/moidify/music.db",
  "port": 8000
}

Note

Change a path and restart with sudo systemctl restart moidify — your music collection is re-scanned automatically.

---

🎮 Discord Rich Presence

Show what you're listening to on your Discord profile:

pip install pypresence
python3 contrib/discord-presence.py --url http://your-server:8000

The script polls Moidify's /api/player/now-playing endpoint and updates your Discord status via RPC. Requires the Discord desktop app running and a Discord Application ID (create one at the Discord Developer Portal).

---

🛠️ Development

git clone https://github.com/Moid-M/moidify.git
cd moidify
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 server.py

Tip

The server uses watchdog to monitor your music folder for changes. Drop new files in and they appear instantly — no rescan button needed.

Project structure

moidify/
├── contrib/
│   └── discord-presence.py   # Discord RPC companion script
├── routes/
│   ├── __init__.py
│   ├── deps.py               # Shared utilities, auth helpers, Pydantic models
│   ├── auth.py               # Register, login, me, setup wizard
│   ├── tracks.py             # Tracks, albums, artists, genres, home, ratings
│   ├── streaming.py          # Transcode, stream, cover art, download album
│   ├── playlists.py          # Playlists CRUD, share, folders, favorites, export
│   ├── admin.py              # Dashboard, stats, users, rescan scheduler
│   └── subsonic.py           # Subsonic API compatibility layer (23 endpoints)
├── Dockerfile                # Container image
├── docker-compose.yml        # Docker orchestration
├── server.py                 # FastAPI app (~80 lines, includes all route modules)
├── scanner.py                # File scanner + metadata extractor
├── database.py               # SQLite schema + migrations + indexes
├── config.py                 # Configuration loader
├── install.sh                # System installer script
├── uninstall.sh              # Cleanup script
├── update.sh                 # Git-pull updater
├── moidify.service           # Systemd unit file
├── requirements.txt          # Python dependencies
├── static/
│   ├── index.html            # Main frontend
│   ├── setup.html            # First-run setup wizard
│   ├── shared.html           # Public shared playlist page
│   ├── admin.html            # Admin dashboard
│   ├── style.css             # @imports all CSS files
│   ├── logo.png              # App logo
│   ├── css/                  # Split CSS by feature
│   │   ├── variables.css     # CSS vars, light mode overrides
│   │   ├── layout.css        # App grid, html/body
│   │   ├── sidebar.css       # Nav, playlists, pinned
│   │   ├── main-content.css  # Album/artist grids, track rows
│   │   ├── player.css        # Player bar, seek, volume
│   │   ├── queue.css         # Queue panel
│   │   ├── modal.css         # Overlay + modal
│   │   ├── settings.css      # Settings layout, toggles, EQ
│   │   ├── context-menu.css  # Right-click menu
│   │   ├── nowplaying.css    # Now-playing overlay
│   │   ├── overlays.css      # Fullscreen art, EQ panel, etc
│   │   ├── animations.css    # All keyframes
│   │   ├── features.css      # Misc feature styles
│   │   ├── mini-player.css   # Mini player
│   │   ├── toast.css         # Toast notifications
│   │   └── responsive.css    # All @media queries
│   └── js/
│       ├── state.js          # App state + utility functions
│       ├── icons.js          # SVG icon library
│       ├── api.js            # API client + auth + favorites + playlists
│       ├── i18n.js           # Internationalization (English/German)
│       ├── player.js         # Audio engine + EQ + transcoding
│       ├── queue.js          # Queue management + shuffle
│       ├── lyrics.js         # Lyrics fetching + synced display
│       ├── animations.js     # Visual effects (vinyl spin, CD hole, glow)
│       ├── app.js            # Event binding + session persistence + init
│       ├── ui/               # Split UI helpers
│       │   ├── toast.js
│       │   ├── modal.js
│       │   ├── settings.js
│       │   ├── context-menu.js
│       │   ├── eq-panel.js
│       │   ├── sleep-timer.js
│       │   └── search.js
│       └── views/            # Split page renderers
│           ├── home.js
│           ├── albums.js
│           ├── artists.js
│           ├── tracks.js
│           ├── playlists.js
│           ├── genres.js
│           ├── search.js
│           └── navigate.js
└── music/                    # Your music goes here (local dev)

---

📸 Screenshots

Screenshots coming soon.

🖥️ Desktop (click to expand)

Home feed


Album browser


Artist grid


Track list with sortable columns


Genre browsing


Synced lyrics overlay


Settings modal with equalizer

📱 Mobile (click to expand)

Home feed


Album browser


Artist grid


Track list


Genre browsing


Lyrics view


Now playing

---

🧩 Tech Stack

Layer	Technology
Backend	Python + FastAPI + uvicorn
Frontend	Vanilla JavaScript (no framework, no build step)
Database	SQLite (via sqlite3) with WAL mode
Metadata	Mutagen
File watching	watchdog
Transcoding	ffmpeg — Opus, MP3, FLAC, WAV
Subsonic API	Built-in /rest/* endpoints for third-party clients

---

📄 License

This project is open source — you are free to use, modify, share, sell, or do absolutely anything you want with it. No strings attached.

MIT

---

Made with ❤️ + 🤖 for people who love their music collection.

🐛 Report a bug · 💡 Request a feature