mStream

A personal music streaming server with a web player, mobile apps, federation between servers and an option to reach it without port forwarding.

2.4k stars, 215 forks JavaScript On GitHub since December 2015

Visit website View on GitHub How to run it

mStream at a glance

Open sourceYes, GPL-3.0No paid parts in the repository
Health76 of 100Actively developed
Self-hostingDocker, Desktop appsOne-click in Umbrel, YunoHost and 2 more
AppsmacOS, Windows, Linux, including ARMBuilds in GitHub releases
Interface11 languagesIncluding English, German and French
Issue repliesWithin ~18 hoursMedian first reply; 75% of recent issues answered

What is mStream?

mStream serves your music folder to a browser and to its own open-source mobile apps. It fetches album art, shows lyrics and can search by them, transcodes, runs an Auto DJ and offers a jukebox mode for controlling playback remotely. Extras include DLNA, a torrent client integration, yt-dlp downloads of audio, backups to any attached drive and playback through the server's own speakers. Quick Sync, built on Iroh, lets the mobile apps reach the server without DNS or SSL setup. Servers can also federate, sharing read access and music discovery data with each other.

Good fit if

  • You want a music server running in minutes from a single download on Windows, macOS or Linux.
  • You cannot open ports on your network and still want phone access.

Look elsewhere if

  • You want a server compatible with the many Subsonic clients: Navidrome.
  • You want films and series in the same place: Jellyfin.

Before you adopt it

mStream is licensed under GPL-3.0, and the repository has no paid parts. It sits on a personal account, and one developer accounts for about 70 percent of recent commits. Releases ship one standalone bundle per platform, with a tray app or a headless server, and LinuxServer.io maintains the Docker image. A new install is public until you add the first user, so create one before exposing it. The interface is available in 11 languages.

Drafted with AI from the project's README and repository data, then checked against that data on 7 November 2026. Report a correction

How to run mStream yourself

One-click install

Not listed in TrueNAS, CasaOS, Proxmox VE Helper-Scripts and Coolify. Checked against each panel’s app catalog on 12 November 2026.

Ways to install

Docker files
Dockerfile or compose file in the repository
Compose file
None in the repository
Setup effort
Not rated: no compose file to judge from
Kubernetes
No Helm chart in the repository
Desktop and mobile
Builds for macOS, Windows, Linux, including ARM in GitHub releases
Interface languages
11 languages, including English, German, French, Spanish, Portuguese, Dutch, Polish, Russian, Japanese and Korean
Show all 11

Chinese, Dutch, English, French, German, Japanese, Korean, Polish, Portuguese, Russian, Spanish

Install instructions: mstream.io or the README on GitHub.

mStream health: is it still maintained?

76 of 100, actively developed

Release rhythmEvery ~4 daysLatest: v6.33.1, 8 November 2026
Issue repliesWithin ~18 hoursMedian first reply; 75% of recent issues answered
Bus factorMedium riskThe most active of 2 authors wrote 63% of recent commits
  • Activity
    939 commits in the last 90 days, the latest on 9 November 2026.
    30 / 30
  • Contributors
    2 people wrote the latest 100 commits; the most active wrote 63% of them.
    6 / 20
  • Releases
    15+ releases in the last 12 months; the latest, v6.33.1, on 8 November 2026.
    19 / 20
  • Replies to issues
    Maintainers answered 75% of recent issues, with a median first reply after 18 hours.
    18 / 20
  • Security practices
    OpenSSF Scorecard 2.6 of 10.
    3 / 10

Read from GitHub on 12 November 2026. How the score works

mStream security

Security advisories are the vulnerabilities the maintainers disclosed on GitHub, with the versions that fix them; many advisories can mean careful disclosure as much as weak code. OpenSSF Scorecard checks how a project is developed and released: reviews, protected branches, pinned dependencies, signed releases. It does not audit the code itself.

Security advisoriesNone publishedNo advisories in the repository’s Security tab
OpenSSF Scorecard2.6 of 10How the project is built and released
Security policyNoNo SECURITY.md or similar
Signed releasesNoDownloads cannot be checked against a signature

What each Scorecard check found

  • Dangerous workflows10 / 10No risky patterns in GitHub Actions
  • License file10 / 10A license file is present
  • Maintained10 / 10Steady commits and issue activity in the last 90 days
  • Pinned dependencies2 / 10Some dependencies use fixed versions
  • Best-practices badge0 / 10No OpenSSF Best Practices badge
  • Binary files0 / 10Compiled binaries are checked into the repository
  • Branch protection0 / 10The main branch has no protection rules
  • Code review0 / 10Changes are merged without review
  • Fuzzing0 / 10No fuzz testing found
  • Security policy0 / 10No security policy
  • Signed releases0 / 10Releases are not signed
  • Static analysis0 / 10No static analysis found
  • Token permissions0 / 10CI tokens have broad write rights

Advisories read from GitHub on 12 November 2026. From the OpenSSF Scorecard of 9 November 2026; checks that do not apply to mStream are left out.

mStream license: is it open source?

mStream uses GPL-3.0, an open-source license approved by the OSI.

  1. December 2015First published on GitHub.
  2. TodayGPL-3.0.

mStream for developers

Written in

  • JavaScript 88%
  • Rust 6%
  • HTML 2%
  • CSS 2%
  • Shell 1%
  • Other <1%

Getting involved

Help wanted1Open, labelled “help wanted”
Contributing guideNot foundNo CONTRIBUTING file in the repository
Open issues74On GitHub
Authors, 90 days2Of the latest 100 commits
DonationsGitHub SponsorsListed on GitHub

Language shares are GitHub’s count of the code in the repository.

Alternatives to mStream

  • Black CandyA self hosted music streaming server 49 health · MIT · 4.4k stars
  • NavidromeYour Personal Streaming Service 79 health · GPL-3.0 · 24.7k stars
  • koelMusic streaming solution that works. 72 health · MIT · 17.3k stars
  • Beetsmusic library manager and MusicBrainz tagger 83 health · MIT · 15.9k stars
  • AudiobookshelfSelf-hosted audiobook and podcast server 81 health · GPL-3.0 · 15k stars

All 38 projects in Media servers & streaming

Questions about mStream

Is mStream open source?

Yes. mStream is published under GPL-3.0, an OSI-approved open-source license.

Is mStream still maintained?

Its health score is 76 of 100 (actively developed). It had 939 commits in the last 90 days, the latest on 9 November 2026, and its latest release came out on 8 November 2026.

How do I run mStream?

You can run it with Docker, as an app for macOS, Windows, Linux, including ARM and in one click from Umbrel, YunoHost, Unraid and 1 more. The README on GitHub has the exact steps.

What is mStream written in?

mStream is written mainly in JavaScript (88% of the code), with Rust (6%), by GitHub’s count of the repository.

What languages is mStream available in?

The repository has interface translations for 11 languages, including English, German, French, Spanish, Portuguese, Dutch, Polish and Russian.

What are the alternatives to mStream?

Close alternatives in the Media servers & streaming category include Black Candy, Navidrome, koel.