StreamTV is a cross-platform IPTV streaming platform that creates TV channels from online video sources like YouTube and Archive.org. Stream directly to Plex, Emby, Jellyfin, and HDHomeRun-compatible devices without requiring local media storage.
Source: Canonical development is private
roto31/StreamTV-source. This public repo publishes sanitized documentation, the GitHub Wiki, signed macOS releases, and a culled copy ofstreamtv/(plus tests/examples) viascripts/sync_public_code.sh/scripts/sync_public_docs.sh. Channel inventory YAML, schedules, cookies, and secrets are never published — see Sanitization policy.
- Direct streaming from YouTube and Archive.org (plus PBS / Plex adapters)
- HDHomeRun emulation for Plex, Emby, and Jellyfin
- YAML-based schedules with commercial breaks; M3U + XMLTV EPG
- In-browser
/playerpreview (mpegts.js live TS) with VLC handoff - Soft per-channel stream restart without full server kickstart
- Plex Live TV video hold (H.264+AAC placeholder; YouTube wait-phase opt-in)
- Portable backup / restore (Settings +
/api/backup) - Optional Foundation Models / Auto-Healer and LoudNorm (defaults off)
- Cross-platform: macOS (signed DMG) and Linux (community ports welcome)
- Passkey and OAuth support for YouTube
- Download the latest macOS release (current tip: v1.4.2)
- Read the Installation Guide
- Follow the Quick Start in docs
| Resource | Link |
|---|---|
| Docs index | docs/README.md |
| Complete topic map | docs/INDEX.md |
| Wiki home | GitHub Wiki |
| Architecture (Mermaid) | ARCHITECTURE.md |
Browser /player preview |
docs/guides/PLAYER_PREVIEW.md |
| Soft deploy | docs/guides/SOFT_DEPLOY.md |
| Plex video hold | docs/guides/PLEX_VIDEO_HOLD.md |
| Backup and restore | docs/guides/BACKUP_RESTORE.md |
| Metadata enrichment | docs/guides/METADATA_ENRICHMENT.md |
| EPG sync classes | docs/guides/EPG_SYNC_CLASSES.md |
| Channel Builder | docs/channel-builder.md |
| Beginner guide | docs/BEGINNER_GUIDE.md |
| API reference | docs/API.md |
| Plex integration | docs/wiki/Plex-Integration.md |
| Troubleshooting | docs/TROUBLESHOOTING.md |
| Sanitization policy | docs/SANITIZATION_POLICY.md |
Signed macOS builds are published on the Releases page.
MIT — see LICENSE.