Skip to content
Projects

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.

How these counts are measured

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-hosted

README.en.md

Original

M3U Studio Logo
M3U Studio

Organize IPTV channels. Publish your own subscriptions.

Latest release GNU GPL v2.0 License Docker pulls GitHub Stars Docker Architectures

简体中文 · 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

M3U Studio channel management in dark mode
Dark mode
M3U Studio channel management in light 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

  1. Create a playlist and import M3U / TXT from a file, pasted text or a file URL. You can also add channels manually.
  2. Organize groups and ordering, then configure logos, EPG, catch-up and FCC.
  3. Review your changes and click Save & publish.
  4. 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.

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.

Buy me a coffee