https://github.com/blycr/msp
轻量本地媒体共享与浏览器播放 · Go + Vite 🚀 | Lightweight local media sharing & browser playback · Go + Vite
https://github.com/blycr/msp
file-sharing golang local-network media-server plyr streaming web-server
Last synced: about 1 month ago
JSON representation
轻量本地媒体共享与浏览器播放 · Go + Vite 🚀 | Lightweight local media sharing & browser playback · Go + Vite
- Host: GitHub
- URL: https://github.com/blycr/msp
- Owner: blycr
- License: mit
- Created: 2026-01-04T09:39:30.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-05-02T20:02:08.000Z (about 1 month ago)
- Last Synced: 2026-05-02T21:28:01.979Z (about 1 month ago)
- Topics: file-sharing, golang, local-network, media-server, plyr, streaming, web-server
- Language: Go
- Homepage:
- Size: 12.2 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY_AUDIT_REPORT.md
Awesome Lists containing this project
README
# MSP: Media Share & Preview
[](https://deepwiki.com/blycr/msp)
Your Personal LAN Cinema.
A lightweight media server for home LAN streaming.
[CodeMap](docs/CodeMap.md) | [中文文档](docs/README_CN.md) | [Report Bug](https://github.com/blycr/msp/issues)
---
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:** The audio metadata panel (`audioMeta`) may occasionally render as a black block. For the best experience, 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](https://github.com/blycr/msp/releases).
2. Run the executable:
```bash
# 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](scripts/README.md) for detailed build and dev script options.
```bash
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](scripts/README.md).
## License
MIT License © 2024-Present [blycr](https://github.com/blycr)
## Acknowledgements
* [Plyr](https://github.com/sampotts/plyr) - A simple, accessible HTML5 media player.
* [Gin](https://github.com/gin-gonic/gin) - HTTP web framework written in Go.
* [GORM](https://gorm.io/) - The fantastic ORM library for Golang.