MSP: Media Share & Preview

Your Personal LAN Cinema.

A lightweight media server for home LAN streaming.

CodeMap | 中文文档 | Report Bug

MSP is a single-binary media server focused on practical home use.
Run it on your PC, share local folders, and play media from any modern browser in your LAN.

• Zero setup: no external database or complex deployment.
• Smart playback: direct play first, transcode only when needed.
• Resume playback: continue from last position across devices.
• Cross-platform server: Windows, Linux, macOS.
• Browser client: desktop and mobile modern browsers.
• Local-first: no cloud account, no tracking.

Note for Firefox users: Compatibility treatments (GPU layer compositing) have been applied for the audio metadata panel (audioMeta). If rendering issues persist, a Chromium-based browser is recommended.

• Direct play is preferred by default.
• Preemptive transcode is applied based on the actual codecs detected inside the file (not the file extension), for higher-risk cases such as:
  • Codecs: HEVC/H.265, AV1, VC-1, AC-3/E-AC-3, DTS, TrueHD, or unknown codecs
• Containers whose codecs cannot be detected (e.g. AVI, WMV, WebM) are served directly first; if direct play fails, MSP retries once, then falls back to transcoding (when enabled).

Video Mode

Audio Mode

1. Download the latest build from Releases.
2. Run the executable:

# Windows
./msp.exe

# Linux/macOS
./msp

3. Open the URL printed in the console, for example http://127.0.0.1:8099. A QR code is printed under each LAN address — scan it with your phone (on the same LAN) to open the page directly.
4. Add shared folders from Settings on first launch.

Requirements: Go 1.25+, bun 1.3.x (frontend build), and PowerShell 7+ (pwsh) on Windows (.ps1 scripts auto re-exec from 5.1).
See Scripts Guide for detailed build and dev script options.

git clone https://github.com/blycr/msp.git
cd msp

# Windows (PowerShell)
.\scripts\build.ps1 -P windows              # Windows all architectures
.\scripts\build.ps1 -P all                  # All platforms and architectures
.\scripts\build.ps1 -H                      # Show all available options

# Linux/macOS (Bash)
./scripts/build.sh -P linux                 # Linux all architectures
./scripts/build.sh -P all                   # All platforms and architectures
./scripts/build.sh -h                       # Show all available options

For more build and dev script options, see Scripts Guide.

MIT License © 2024-Present blycr

• Plyr - A simple, accessible HTML5 media player.
• GORM - The fantastic ORM library for Golang.