/README.md

MediaGo

Quick Start   •   Website   •   Docs   •   Discussions

中文   •   日本語

---

What is MediaGo?

A cross-platform streaming media downloader with built-in browser sniffing — grab m3u8, HLS, and more with zero packet-capture hassle.

• ✅  No packet capture needed — The built-in browser automatically detects video resources on any page. Just pick what you want from the detected list and download.
• 📱  Watch on mobile — Seamlessly switch between PC and mobile. Once a video is downloaded, scan a QR code to watch it on your phone.
• ⚡️  Batch downloads — Download multiple videos and live streams at the same time — no wasted bandwidth.
• 🎉  Docker support — Deploy the web UI via Docker for quick, headless operation.
• 🦞  OpenClaw Skill — Download videos with natural language through AI coding assistants (OpenClaw, Claude Code, etc.). Install with npx clawhub@latest install mediago.

Quick Start

You need Node.js and pnpm. Install Node.js from the official site, then install pnpm:

npm i -g pnpm

Running locally

# Clone the repo
git clone https://github.com/caorushizi/mediago.git

# Install dependencies
pnpm install

# Start the Electron desktop app (dev mode)
pnpm dev:electron

# — or — start the web server (dev mode)
pnpm dev:server

# Package the Electron app for distribution
pnpm pack:electron

# Package the web server for distribution
pnpm pack:server

Releases

v3.5.0-beta.0 (Apr 3, 2026)

Downloads

• Windows (installer) v3.5.0-beta.0
• Windows (portable) v3.5.0-beta.0
• macOS ARM64 (Apple Silicon) v3.5.0-beta.0
• macOS x64 (Intel) v3.5.0-beta.0
• Linux v3.5.0-beta.0
• Docker v3.5.0-beta.0: docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:3.5.0-beta.0

v3.0.0 (Oct 7, 2024)

Downloads

• Windows (installer) v3.0.0
• Windows (portable) v3.0.0
• macOS ARM64 (Apple Silicon) v3.0.0
• macOS x64 (Intel) v3.0.0
• Linux v3.0.0
• Docker: docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:latest

One-click Docker deployment via BT Panel

1. Install BT Panel using the official script.
2. Log in to the panel, click Docker in the sidebar, and follow the prompts to install the Docker service.
3. Find MediaGo in the app store, click Install, configure your domain, and you're done.

Screenshots

Changelog (v3.0.0)

• Docker deployment for the web UI
• Redesigned desktop UI
• Video playback on desktop and mobile
• Fixed blank window on macOS launch
• Improved batch download UX
• Added Windows portable build (no install required)
• Enhanced resource sniffing — detect multiple videos per page
• Import / export favorites
• Export the download list from the home page
• Improved "New download" form flow
• Open the app and add downloads via URL scheme
• Various bug fixes and UX improvements

Tech Stack

• React
• Electron
• Koa
• Vite
• Ant Design
• Tailwind CSS
• shadcn/ui
• Inversify

Acknowledgements

• N_m3u8DL-RE
• BBDown
• yt-dlp
• mediago-core

Disclaimer

This project is for educational and research purposes only. Do not use it for any commercial or illegal purposes.

1. All code and functionality provided by this project are intended solely as a reference for learning about streaming media technologies. Users must comply with the laws and regulations of their jurisdiction.
2. Any content downloaded using this project remains the property of its original copyright holders. Users should delete downloaded content within 24 hours or obtain proper authorization.
3. The developers of this project are not responsible for any actions taken by users, including but not limited to downloading copyrighted content or impacting third-party platforms.
4. Using this project for mass scraping, disrupting platform services, or any activity that infringes upon the legitimate rights of others is strictly prohibited.
5. By using this project you acknowledge that you have read and agree to this disclaimer. If you do not agree, stop using the project and delete it immediately.