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.

Highlights

• 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.

Playback Behavior

• Direct play is preferred by default.
• Preemptive transcode is applied only for higher-risk cases, such as:
  • Containers: AVI, WMV
  • Codecs: HEVC/H.265, VC-1, AC-3, DTS, TrueHD
• If direct play fails, MSP retries once, then falls back to transcoding (when enabled).

Preview

Video Mode

Audio Mode

Quick Start

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.
4. Add shared folders from Settings on first launch.

Build from Source

Requirements: Go 1.25+, Node.js 18+ (frontend build).
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.

License

MIT License © 2024-Present blycr

Acknowledgements

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