The easiest music streaming server available
Go to file
2017-09-26 02:15:46 -04:00
docs WIP readme 2017-09-19 11:53:46 -04:00
electron Added docs 2017-09-17 16:06:09 -04:00
image-cache Full metadata support and some bug fixes for mobile 2017-04-11 15:08:51 -04:00
modules Album Art + Lazy Load 2017-09-26 02:15:46 -04:00
public Album Art + Lazy Load 2017-09-26 02:15:46 -04:00
.gitignore tweaks 2017-09-17 01:32:15 -04:00
Dockerfile Added Dockerfile and modified README 2016-08-26 09:33:39 +02:00
LICENSE Create LICENSE 2017-04-29 13:53:32 -04:00
mstream-command-line-boot-wrapper.js Improved electron detection 2017-09-18 16:08:16 -04:00
mstream-electron.js Jukebox mode highlights button 2017-09-21 19:23:19 -04:00
mstream.js Massive UI update and some backend bug fixes 2017-09-21 00:40:55 -04:00
package.json Improced electron save function 2017-09-18 16:44:55 -04:00
README.md Yerp 2017-09-21 01:50:37 -04:00

mStream

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)

The Official Website

mStream Express Download Page

mStream Server

  • Works on Mac/Windows/Linux
  • Lightweight: uses less than 50MB of memory under normal load
  • Secure login system that uses JSON web tokens
  • Built in SSL support
  • Automatically scans library for metadata and album art
  • Server uses a RESTful JSON API. It's documented and easy to write code against

mStream Server can be installed with NPM by following these instructions

mStream Express

Installing all the dependencies for mStream can be hassle for Windows users. To solve this problem, Electron was used to compile the mStream Server into installable EXE for windows. To be clear, mStream Express uses the same code as mStream Server, it's just packed as a one click installer.

You can download the latest version of mStream Express here or here

mStream Express also comes packaged with some extra tools to make managing your server as simple as possible. Here's a list of all the important features:

  • No Dependencies!
  • Comes in an installable and Portable edition for windows
  • Has a full set of server GUI management tools built in. No need to touch a command line!
  • Autoboot: Can be configured to boot on startup
  • Automatic Port Forwarding via uPNP protocol
  • Now works on Linux. mStream Express has been tested and verified working on Ubuntu and Arch

The WebApp

The webapp allows your to stream your music on any browser. it comes built into the server and has these 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

Android App

There is currently and mStream Android App under development. It lacks some features and the UI is clunky, but it works. 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

Contributing

Like the project? Consider sending us some money on Patreon