Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Roshan-R/termv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

103 Commits

Repository files navigation

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
  • gawk
  • jq
  • fzf
  • xdo (optional, for -s flag)

Usage

Usage: termv [OPTIONS] query
Options:
 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

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.

AltStyle によって変換されたページ (->オリジナル) /