Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
TV Mode
TV mode streams live television channels from M3U playlists. Playlists can be loaded from remote URLs or local files.
Entering TV Mode
- Press
Ctrl+Tto switch to TV mode (andCtrl+Sto switch back to Streaming mode). - If no playlists are loaded on entry, the playlist manager opens automatically.
- Type in the search bar to filter channels by name or group; press
Enterto play.
Managing Playlists
- Enter
/configwhile in TV mode to open the playlist manager. - Select
+ Add playlist, enter the URL or local file path, and pressEnter.- URL:
https://example.com/playlist.m3u - File:
~/playlists/channels.m3u(supports~/tilde expansion and Windows paths)
- URL:
- Press
rinside the manager to reload all playlist sources. - Highlight an entry and press
d(orDelete) to remove it. - Press
Escto close the manager.
Playlists are saved to tv_config.json in your configuration directory.
Channel Parsing & Safeguards
- Size Limits: Files and downloads larger than 15 MB are rejected to prevent excessive memory consumption.
- Deduplication: Channels sharing identical stream URLs across multiple playlists are deduplicated.
- Attributes: Parses
#EXTINF:tags fortvg-id,tvg-logo,group-title, and channel name.
Playback & Commands
- Playback: Press
Enteron a channel to launch your default media player. Live streams without fixed durations are exempted from watch history. - Commands:
/list: View all loaded TV channels.r: Reload all active playlists./config: Open the playlist manager.