node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ยป



mStream is a personal music streaming server written in NodeJS. The goal of mStream is to be the easiest music streaming server software available.


See The Demo (no password required)

See The Demo (username: admin, password: abc123)

mStream Download Page

mStream Website

Install mStream

mStream can be installed on Mac, Windows, and Linux with NPM.

mStream is also available as a pre-compiled EXE for Windows. This version of mStream was created so solve the problem of dealing with NPM on Windows. Seriously, don't install mStream in Windows via NPM unless you know what you are doing. This pre-compiled version is called mStream Express and will work right out of the box and has no dependencies. It has some additional features as well, such as adding a Tray Icon to manage your server.

Install with NPM:

Install mStream Express for Windows

mStream Server Features

  • Works on Mac/Windows/Linux
  • Lightweight: uses less than 50MB of memory under normal load
  • SSL Support + JSON Web Token Authentication for security
  • Automatically scans library for metadata and album art
  • Server uses a RESTful JSON API. It's documented and easy to write code against

mStream Webapp Features

  • Supports FLAC streaming on all browsers
  • Responsive UI
  • Song caching for gapless playback
  • Jukebox Mode allows you to control the webapp from your phone
  • Built in VueJS

Android App

There is currently and mStream Android App under development. All the core media player features work, but the UI could use some work. It's not available on the App Store, but you can get the latest version here

  • Supports FLAC streaming
  • Allows you to download files to your phone for offline playback
  • Can connect to multiple servers
  • Open Source

Additional Reading

All the details about mStream are available in the docs folder


Like the project? Consider sending us some money on Patreon