Skip to content
roto31Public

About

StreamTV documentation, wiki, and releases (source code is private)

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

StreamTV

Releases License

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 of streamtv/ (plus tests/examples) via scripts/sync_public_code.sh / scripts/sync_public_docs.sh. Channel inventory YAML, schedules, cookies, and secrets are never published — see Sanitization policy.

Features

  • 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 /player preview (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

Quick start

  1. Download the latest macOS release (current tip: v1.4.2)
  2. Read the Installation Guide
  3. Follow the Quick Start in docs

Documentation

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

Platform guides (wiki)

Releases

Signed macOS builds are published on the Releases page.

Support

License

MIT — see LICENSE.

About

StreamTV documentation, wiki, and releases (source code is private)

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages