Meelo
Self-hosted music server focused on metadata integration and UI, with music videos as first-class citizens and mobile apps for Android and iOS.
Open source alternative to:



What is Meelo?
Meelo is a self-hosted music server designed for music collectors, focused on metadata integration and a polished UI. It runs as a Docker container, scans your local audio and music-video files, enriches them with metadata from MusicBrainz, Genius, and Wikipedia, and exposes a web player plus native Android and iOS apps. Where Plex, Jellyfin, Koel, and Black Candy treat music as one library among several, Meelo treats music as the only library, and that focus is reflected in features you typically do not see elsewhere.
Key features
- Music videos as first-class citizens, surfaced alongside tracks from the same album, artist, or song page, with interviews, behind-the-scenes, and trailers differentiated from the music videos themselves.
- B-side and rare-track detection so bonus tracks and loose singles stay visible on the album and artist pages instead of getting lost in a generic library view.
- Automatic featuring and duet detection to credit collaborators without manual tagging.
- Albums with releases — keep multiple pressings or editions of one album side by side, with the main release on browsing pages and the others reachable from the album page.
- Songs with tracks and versions, so the same recording across different edits or mixes does not appear as duplicates.
- Album and song types — quickly filter for instrumentals, live recordings, demos, remixes, and more.
- Compilation-aware filtering to hide tracks that are exclusive to a compilation rather than the original album.
- Universal format support through on-the-fly transcoding; any audio or video container that ffmpeg understands can be ingested and played back in the browser.
- Flexible metadata parsing from embedded tags, filenames, or both, with regex support for path-based tagging.
- External metadata enrichment from MusicBrainz, Genius, Wikipedia, and other providers, plus cover art scraping.
- Scrobbling to ListenBrainz and Last.fm.
- Synced lyrics downloaded automatically, plus fallback to embedded metadata and
.lrcfiles. - Mobile apps for Android (APK on the Releases page) and iOS (TestFlight).
Self-hosting
Meelo ships as Docker images with docker-compose.yml, docker-compose.dev.yml, and docker-compose.prod.yml. The wiki covers the full setup. Transcoding is performed on demand only when the browser does not natively support the source codec, so the server stays light at idle. The maintainers note that Meelo is intended for private use rather than as a public downloading platform.
How it compares to Spotify and Apple Music
Where Spotify and Apple Music stream from a catalogue you do not own on infrastructure you cannot touch, Meelo plays the files in your library on hardware you control. Metadata enrichment via MusicBrainz gives a comparable depth of artist and album information, the scrobbling integration keeps your Last.fm and ListenBrainz history accurate, and the music-video support goes further than either service exposes. The tradeoff is the usual one for self-hosted software: you bring your own files and your own server.
Categories:
Tags:
Build with:
Frequently Asked Questions
Which platforms does Meelo run on?
Meelo is a web app that runs in any modern browser, so it works on Linux, macOS, Windows, and ChromeOS. There are native mobile apps for Android (APK published on the Releases page) and iOS (distributed via TestFlight). The mobile apps reuse the same library, playlists, and listening history as the web app.
Does Meelo work offline or does it have a mobile app?
The Android app downloads tracks for offline playback using a background downloader, so your library is available without an active connection. The iOS app is in active development and uses TestFlight for distribution. On the server side, transcoding is performed on demand only when the browser cannot play the source codec natively, so a healthy network is required for streaming.
What audio and video formats does Meelo support?
Any format that ffmpeg understands can be ingested and played back through on-the-fly transcoding, including FLAC, ALAC, WAV, MP3, AAC, OGG, Opus, and the usual music-video containers. The README explicitly calls out that transcoding is only used when the browser does not natively support the file format, so lossless playback remains lossless.
Can I extend or customize Meelo?
Meelo is open source under GPL-3.0 and accepts community contributions via pull requests. Metadata parsing is flexible: you can rely on embedded tags, the filename, or both, with regex support for path-based tagging. Metadata enrichment uses pluggable providers (MusicBrainz, Genius, Wikipedia) and you can disable individual providers per library.
What are the system requirements to self-host Meelo?
The reference deployment uses Docker Compose with the included docker-compose.yml. A NestJS backend talks to PostgreSQL via Prisma, RabbitMQ for asynchronous work, and Meilisearch for search indexing. A small personal library of a few thousand tracks runs comfortably on 2 GB of RAM and modest CPU; transcoding higher-resolution video or running the metadata matcher at scale benefits from SSD storage and additional CPU cores.
Repository details
Updated 8/20/2026, 8:00:22 AM
View RepositorySponsor Meelo
Sponsor Meelo on GitHub Sponsors
https://github.com/sponsors/Arthi-chaudCompare Meelo with
Similar open source alternatives
Noctis
Cross-platform lossless music player with rich library management, synced lyrics, and gapless playback for Windows, macOS, and Linux.
SpotifyPinePods
A self-hosted, cross-platform podcast management system with a modern Rust and Python stack.
Apple PodcastsMinusPod
Self-hosted podcast server that uses AI to automatically remove ads from episodes before you hit play.
Apple Podcasts
Navidrome
Modern, lightweight self-hosted music server compatible with Subsonic/Airsonic clients — stream your music everywhere.
Spotifypodgrab
A self-hosted podcast manager/downloader/archiver tool to download podcast episodes as soon as they become live with an integrated player.
Apple Podcasts