caorushizi
74b67101ae
Build & Push Docker Image / Build and push multi-arch image (push) Failing after 1s
Users naturally expect the "Current version" label in chrome://extensions
to match the version shown inside the MediaGo window. Tie both to a single
source of truth: `apps/electron/app/package.json`, which Electron's build
pipeline (`apps/electron/tsdown.config.ts`) already reads and exposes as
`process.env.APP_VERSION`.
`manifest.config.ts` now imports the same file and:
- `version` — stripped down to the numeric prefix (`split(/[-+]/)[0]`)
so Chrome accepts it. Chrome's manifest parser only
allows 1–4 dot-separated integers; SemVer pre-release
or build suffixes (`-beta.2`, `+build.7`) get rejected
at install time.
- `version_name` — keeps the full SemVer string. It's free-form, not
used for update-ordering, and is what chrome://extensions
displays when present.
Effect: bumping `apps/electron/app/package.json` once is enough to
re-stamp both the Desktop binary and the bundled extension manifest.
The extension's own `packages/mediago-extension/package.json` is a
private workspace package — its `version` field is unused by the
manifest and intentionally left alone to avoid a pointless sync step
on every release.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
- Install BT Panel using the official script.
- Log in to the panel, click Docker in the sidebar, and follow the prompts to install the Docker service.
- 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
Acknowledgements
Disclaimer
This project is for educational and research purposes only. Do not use it for any commercial or illegal purposes.
- 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.
- 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.
- 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.
- Using this project for mass scraping, disrupting platform services, or any activity that infringes upon the legitimate rights of others is strictly prohibited.
- 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.