meelo

Meelo is a self-hosted music server designed for music collectors, offering a rich set of features beyond basic playback and browsing. It emphasizes flexibility in metadata handling and provides a unique browsing and listening experience. **Key Features** - **Music Videos as First-Class Citizens**: Access music videos directly from album, artist, or song pages, with differentiation between music videos, interviews, behind-the-scenes content, and trailers. - **B-Side and Rare Track Identification**: Automatically identifies tracks related to an album (B-sides) and rare tracks, displaying them on relevant pages to prevent them from being overlooked. - **Automatic 'Featuring' and Duet Detection**: Recognizes collaborations and duets automatically. - **Album Releases and Song Tracks**: Supports multiple versions of an album (releases) and songs (tracks), with only the main version shown during browsing while others remain accessible from the album/song page. - **Song Versions**: Allows grouping of different versions of the same song. - **Album and Song Types**: Enables filtering by type, such as instrumental songs or live recordings. - **Exclusive Song Filtering**: For compilation albums, filter songs exclusive to that album. - **Format Support**: Virtually supports all audio and video formats through transcoding (used only when the browser doesn't support the format). - **Flexible Metadata Parsing**: Extracts metadata from embedded tags, file names, or both, including album covers. - **Metadata Enrichment**: Fetches genres, descriptions, and ratings from MusicBrainz, Genius, Wikipedia, and other providers. - **Scrobbling**: Pushes scrobbles to ListenBrainz and LastFM. - **Lyrics**: Downloads synced lyrics or uses embedded metadata and `.lrc` files. **Mobile App** Meelo offers mobile apps for both Android and iOS. Android users can download the latest stable APK from the release page, while iOS users can access the app via TestFlight. APKs and IPAs are also built on every push to the main branch. **Setup** Meelo is distributed via Docker images. Setup instructions are available in the project's wiki. It's recommended to have properly tagged music files, as embedded metadata is preferred. If relying on file paths for metadata, familiarity with Regex is helpful. **Screenshots and Demo** Screenshots of the UI are available in the docs/screenshots directory. A public live demo is currently in development. **Translation** Meelo uses Weblate for translations, and contributions are welcome via the hosted Weblate instance. **Contributing and Bugs** Users can open issues for feature requests or bug reports, start discussions for setup help, and contribute via pull requests. **Disclaimer** Meelo is intended for private use only and should not be used as a public downloading platform or for illegal sharing/downloading of copyrighted media. The maintainers are not responsible for misuse.