termv

A terminal iptv player written in bash

termv is a small bash script that allows you to select an iptv stream using fzf and play it using mpv.

The list of channels is obtained from https://github.com/iptv-org/iptv.

For an example for a custom channels list and how to make one yourself, visit this gist.

For windows support, consider using termv-rs, a rewrite of termv in rust.

Dependencies

• curl
• mpv
• jq
• fzf
• xdo (optional, for -s flag)

Usage

Usage: termv [OPTIONS] queryOptions: General Options: -h, --help Print this help text and exit. -v, --version Print program version and exit. -u, --update Update channel list to latest version. Player Options: -f, --full-screen Open mpv in fullscreen. -s, --swallow Swallow terminal during playback (X11 only) based on devour; https://github.com/salman-abedin/devour.sh Environment variables:  TERMV_AUTO_UPDATE Auto update channel list to latest version. (default: true) TERMV_SWALLOW Always swallow terminal during playback. (default: false) TERMV_FULL_SCREEN Always open mpv in fullscreen. (default: false) TERMV_DEFAULT_MPV_FLAGS Default arguments which are passed to mpv. (default: --no-resume-playback) TERMV_CHANNELS_URL URL to the channel list. (default: https://iptv-org.github.io/api/channels.json) Any other URL must be in the same format as the default one. TERMV_STREAMS_URL URL to the streams list. (default: https://iptv-org.github.io/api/streams.json) Any other URL must be in the same format as the default one. Improve me on GitHub: https://github.com/Roshan-R/termv

Installation

Direct download

sudo wget -O /usr/local/bin/termv -q --show-progress https://raw.githubusercontent.com/Roshan-R/termv/main/termv && sudo chmod +x /usr/local/bin/termv

Arch Linux

Install from the AUR (with your preferred AUR helper)

yay -S termv

Nix

Users of the Nix package manager with flakes support can execute termv using

nix run github:Roshan-R/termv

MacOS

For MacOs users with the homebrew package manager

brew tap Roshan-R/termv https://github.com/Roshan-R/homebrew-termv
brew install termv

Android

For Android users with termux and mpv-android installed, it is possible to direct install to a folder in the path

Installation by cloning the repository

git clone https://github.com/Roshan-R/termv
cd termv

• Install with the Makefile

sudo make install

• Uninstall with the Makefile

sudo make uninstall

Credits

A big thank you to all the contributors

Thanks to ytfzf for the Makefile and tmpmail as a reference on how to structure bash scripts.