Repolode
Submit
Arthi-chaud

Arthi-chaud/Meelo

A self-hosted music server focused on metadata integration, music collections and a browsing-oriented web and mobile UI.

Open-source alternative to:SpotifyApple Music

View on GitHub
Stars
1,447
Forks
42
Open issues
61
Last commit
yesterday

What is it?

Meelo is a self-hosted music server for people who keep their own music collections. It plays the role of Plex, Jellyfin, Koel or Black Candy, with an emphasis on flexible browsing and listening.

The project handles music videos as first-class content linked from albums, artists and songs, separates them from interviews or trailers, and surfaces B-sides and rare tracks on album and artist pages. It also detects featurings and duets, groups albums into releases and songs into tracks and versions, and can filter songs exclusive to a compilation album. Metadata can be read from embedded tags, file names or both, and enriched from providers such as MusicBrainz, Genius and Wikipedia.

Meelo runs as Docker images, with a web app and Android and iOS mobile apps. It can push scrobbles to ListenBrainz and Last.fm, and it supports synced lyrics from embedded data or .lrc files. Transcoding is used when a file format is not playable in the browser.

Key features

  • 01Music videos linked from album, artist and song pages
  • 02Detects B-sides, rare tracks, featurings and duets
  • 03Releases, tracks and versions keep browsing free of duplicates
  • 04Metadata from embedded tags, file names, or both
  • 05Enriches metadata via MusicBrainz, Genius, Wikipedia and others
  • 06Scrobbles to ListenBrainz and Last.fm, with synced lyrics support

Use cases

  • Hosting a personal, carefully tagged music library at home
  • Managing a collection that includes music videos and live recordings
  • Browsing albums with alternate versions and bonus tracks
  • Playing your library from web or Android and iOS apps

Quick start

  1. 1

    Read the official setup guide in the project wiki

  2. 2

    Deploy Meelo using the Docker images

Things to know

  • Requires Docker-based setup and some configuration before it is ready to use.
  • Works best with correctly embedded metadata; file-path parsing may need Regex knowledge.
  • Intended for private use only and not designed for heavy traffic.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to be open source.

In collections

Home media serversSelf-hosted music streamingSelf-hosted apps

Topics

#music#self-hosted#media-server#music-library#metadata#docker#typescript#lyrics#mediaserver#music-collection

FAQ

What is Meelo?
A self-hosted music server focused on metadata integration, music collections and a browsing-oriented web and mobile UI. Meelo is a self-hosted music server for people who keep their own music collections. It plays the role of Plex, Jellyfin, Koel or Black Candy, with an emphasis on flexible browsing and listening.
Is Meelo free to use? What license does it have?
Meelo is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Meelo still maintained?
Actively maintained. The last commit to Meelo was on Nov 6, 2026.
What can I use Meelo for?
Hosting a personal, carefully tagged music library at home Managing a collection that includes music videos and live recordings Browsing albums with alternate versions and bonus tracks Playing your library from web or Android and iOS apps
How do I install Meelo?
Read the official setup guide in the project wiki Deploy Meelo using the Docker images
Where can I get Meelo?
The source code and installation instructions are on GitHub: https://github.com/Arthi-chaud/Meelo

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects