cachemiao/m3u-studio
cachemiao/m3u-studio has 92 GitHub stars and 10 forks. GitHot measured 0 stars in 24 hours and +7 in 7 days. Last checked 2026-11-15 22:26 UTC. Last push 2026-10-27.
Measured star growth
- in 24h
- 0
- in 7 days
- +7
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A self-hosted IPTV editor for M3U/TXT playlists, with EPG, channel logos, and custom short links.
Self-hostedREADME.en.md
Original

M3U Studio
Organize IPTV channels. Publish your own subscriptions.
简体中文 · English
M3U Studio is a self-hosted IPTV channel manager.
Organize channels, groups, logos and EPG in your browser, then publish M3U / TXT subscriptions for your player.
Live demo · Screenshots · Features · Quick start · Get started · Docs and development · Contributing
Screenshots
![]() Dark mode |
![]() Light mode |
Try channel organization, drag-and-drop sorting and bulk editing online, with no installation required. Try the live demo →
Features
- Edit first, publish when ready: drafts are saved automatically in your browser, with undo/redo support. Review before publishing and keep the last 30 pre-publish snapshots for recovery.
- Multi-select dragging: move selected channels together with automatic edge scrolling, and freely reorder playlists and groups.
- Automatic logo matching: a shared logo library with matching by name and alias, search and batch uploads.
- Bulk editing and source checks: replace URLs and edit fields in bulk, move or copy channels between playlists, and check channel response times to help identify unresponsive sources.
- Multiple playlist subscriptions: import M3U / TXT from files, pasted text or URLs, then publish separate or combined subscriptions with custom short URLs.
- EPG, catch-up and FCC: configure program guides, catch-up and FCC parameters per channel and include them in subscription exports.
- Self-hosted: lightweight design with AMD64 / ARM64 images for NAS devices, servers and ARM boxes such as the Phicomm N1. Keep your data on your own device, with no external frontend CDN dependencies.
Quick start
Access: deploy on a trusted LAN or VPN. Subscription and logo URLs do not require login; anyone who can access a subscription can read its stream URLs. For public deployment, configure HTTPS and access restrictions through a reverse proxy.
Install Docker and Compose, then run these commands. One configuration file pulls the AMD64 / ARM64 image, with no repository clone, local build or .env required:
mkdir m3u-studio && cd m3u-studio
curl -fsSL https://raw.githubusercontent.com/cachemiao/m3u-studio/main/docker-compose.image.yml -o docker-compose.yml
docker compose up -d
Open http://SERVER_IP:8324 and create your admin account; passwords require at least 8 characters. Data stays in the m3u-studio-data named volume.
NAS: paste the configuration below into your fnOS, Synology or other NAS Compose/project editor. You can also save it as docker-compose.yml in an empty directory and run docker compose up -d, without downloading a configuration file.
Copy the Compose configuration
# Standalone image deployment: no source checkout or .env required.
# Save as docker-compose.yml, then run: docker compose up -d
services:
m3u-studio:
image: cachemiao/m3u-studio:latest
container_name: m3u-studio
ports:
- "8324:8324"
environment:
TZ: Asia/Shanghai
IMPORT_ALLOWED_NETWORKS: ${IMPORT_ALLOWED_NETWORKS:-}
IMPORT_ALLOWED_PORTS: ${IMPORT_ALLOWED_PORTS:-}
SOURCE_ALLOWED_NETWORKS: ${SOURCE_ALLOWED_NETWORKS:-}
SOURCE_ALLOWED_PORTS: ${SOURCE_ALLOWED_PORTS:-}
volumes:
- m3u-studio-data:/data
restart: unless-stopped
security_opt:
- no-new-privileges:true
cap_drop:
- ALL
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
volumes:
m3u-studio-data:
name: m3u-studio-data
Configuration file: docker-compose.image.yml.
Other deployment methods, port changes, upgrades and backups →
Get started
- Create a playlist and import M3U / TXT from a file, pasted text or a file URL. You can also add channels manually.
- Organize groups and ordering, then configure logos, EPG, catch-up and FCC.
- Review your changes and click Save & publish.
- Open Subscriptions & EPG and copy a subscription URL to your player.
Channel changes update subscriptions only after publishing. Logo uploads, replacements and deletions take effect immediately. Back up the entire data directory for a full backup; JSON exports exclude images and accounts.
FCC (fast channel changing) targets multicast IPTV setups and requires a supporting service such as rtp2httpd and a compatible player.
Documentation
Built with Python / Flask + SQLite and plain HTML / CSS / JavaScript. No frontend Node build is required.
- User guide: imports, dragging, bulk editing, logos, EPG and subscription URLs.
- Deployment and maintenance: installation, upgrades and backups.
- Development and contributing: local setup without Docker, tests and the PR workflow.
- Changelog
Feedback and contributions
Report bugs through Issues or contribute a Pull Request. Include your version, deployment method and reproduction steps in reports; read the development guide before contributing code. Remove private URLs and credentials from examples.
Telegram channel · Telegram group · X
License and scope
Released under GNU GPL v2.0 (GPL-2.0-only). Copyright © 2026 cachemiao.
The project includes no live stream sources or TV channel logos. Use resources you have permission to use. It manages channels and distributes subscriptions; playback, UDP-to-HTTP conversion and catch-up depend on external services and players.

