Repolode
Submit
IrosTheBeggar

IrosTheBeggar/mStream

A self-hosted music streaming server that plays your collection in a web app, mobile apps and desktop builds.

Open-source alternative to:PlexSpotify

View on GitHubWebsite
Stars
2,429
Forks
218
Open issues
96
Last commit
yesterday

What is it?

mStream is a self-hosted music server. You point it at your music folders, and it scans the collection, fetches album art, and serves the library to a web player and to the official Android and iOS apps. Public mode lets anyone on a trusted network play music without signing in, and adding a user switches the server to password protection.

Beyond basic playback, mStream includes an Auto DJ that queues songs, lyrics search, jukebox mode for controlling a browser remotely, and transcoding. It can also integrate with a torrent client and yt-dlp for downloading audio, and offers DLNA support and automatic backups to a connected drive.

For reaching a server without manual networking, the optional Quick Sync feature uses Iroh to provide a VPN-like connection without port forwarding, DNS or SSL setup. Quick Sync works with the mobile apps and desktop app but not the web app. Federation and P2P discovery let servers share read access and surface similar songs from other mStream instances. Binaries for Windows, macOS and Linux, a Docker image, and source installation are available.

Key features

  • 01Automatic album art lookup for your collection
  • 02Auto DJ that queues up songs
  • 03Lyrics support, including search by lyrics
  • 04Jukebox mode to control a browser remotely
  • 05Torrent client and yt-dlp integration
  • 06Quick Sync for access without port forwarding or DNS/SSL setup

Use cases

  • Streaming a home music library to phones and browsers on your network
  • Running a shared music server for family or friends with optional user accounts
  • Accessing your personal music library remotely without configuring networking
  • Discovering songs similar to your taste across federated mStream servers

Quick start

  1. 1

    Download the binary for your platform from the releases page

  2. 2

    Run the bundled server from a terminal, or double-click the desktop app

    mstream-server

Things to know

  • Quick Sync does not work with the web app, only with the mobile and desktop apps.
  • Local server audio playback does not work in Docker.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to stay open source.

In collections

Home media serversSelf-hosted music streamingSelf-hosted apps

Topics

#music-streaming#self-hosted#music#media-server#p2p#docker#iroh#javascript#mstream#rust

FAQ

What is mStream?
A self-hosted music streaming server that plays your collection in a web app, mobile apps and desktop builds. mStream is a self-hosted music server. You point it at your music folders, and it scans the collection, fetches album art, and serves the library to a web player and to the official Android and iOS apps. Public mode lets anyone on a trusted network play music without signing in, and adding a user switches the server to password protection.
Is mStream free to use? What license does it have?
mStream is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is mStream still maintained?
Actively maintained. The last commit to mStream was on Nov 6, 2026.
What can I use mStream for?
Streaming a home music library to phones and browsers on your network Running a shared music server for family or friends with optional user accounts Accessing your personal music library remotely without configuring networking Discovering songs similar to your taste across federated mStream servers
How do I install mStream?
Download the binary for your platform from the releases page Run the bundled server from a terminal, or double-click the desktop app: mstream-server
Where can I get mStream?
The source code and installation instructions are on GitHub: https://github.com/IrosTheBeggar/mStream

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

Related projects