OpenSource-Hub
M

mStream

SHA-256
2.3k stars·Privacy Protection·SHA-256 checksum verified

The easiest music streaming server that respects your folder structure. Drop files, play instantly. No accounts, no scans, no database required.

Smart Download

Download Download Version

v6.7.1 · 147.5 MB

Drop files, play instantly. No scans, no accounts, no database.

Core Features

  • Folder-faithful library: files stream directly from disk, no database lookup
  • Web UI file manager: upload, mkdir, rename, and download from YouTube
  • Public mode: zero-config streaming on trusted networks
  • Granular write permissions: lockAdmin, noUpload, noMkdir, noFileModify
  • Desktop server app (tray-based, auto-update, boot-on-startup) + desktop player

What It Can't Do

  • Third-party Subsonic clients (e.g., DSub) require a scan to populate metadata; instant drop-and-play is only in the native UI
  • Public mode disables authentication — use only on trusted networks
  • YouTube download requires yt-dlp to be installed separately
  • For large libraries, run a full scan from the admin UI once to generate waveforms and album art

Use Cases

  • Self-host your personal music library without sacrificing your folder structure
  • Share a music collection with family/team over local network with public mode (no accounts)

Detailed Introduction

mStream is a self-hosted music streaming server that treats your file system as the music library. Unlike traditional music servers that scan and rebuild metadata into a virtual library, mStream streams files directly from disk, making new additions available immediately. It includes a web UI file manager for uploads, mkdir, rename, and YouTube downloads, plus public mode (no accounts for trusted networks). Ships with desktop server and player apps, Subsonic API compatibility, DLNA casting, on-the-fly transcoding, and a Rust-powered multi-threaded scanner. Lightweight, cross-platform, and built on SQLite with no external database dependency.

Tags

music-streamingself-hostedfile-managementSubsonicmedia-server

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Install the appropriate package for your distro (dpkg / rpm / AppImage)

3

Download the installer for your platform from mstream.io/server (or install via npm: `npm install -g mstream`)

4

Run the setup wizard (`mstream wizard` or follow first-launch prompts) to select your music folder and admin password

5

Launch mStream and open http://localhost:3333 in your browser to start playing

Install Guide
  1. Download the installer for your platform from mstream.io/server (or install via npm: `npm install -g mstream`)
  2. Run the setup wizard (`mstream wizard` or follow first-launch prompts) to select your music folder and admin password
  3. Launch mStream and open http://localhost:3333 in your browser to start playing
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

8620206f76616484de8f697b1176d2611513580bc7823deac9e7999242b9837e

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Windows: uninstall via 'Control Panel → Programs and Features'. macOS: drag the app to Trash. Linux: remove the install directory and ~/.config/mstream folder.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-3.0
Last Updated2026-05-05T20:24:09Z
GitHub RepositoryOfficial Website

Similar Projects