Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Roshan-R/termv

A terminal iptv player written in bash
https://github.com/Roshan-R/termv

bash cli command-line fzf linux makefile mpv shell shell-script terminal tv

Last synced: about 1 month ago
JSON representation

A terminal iptv player written in bash

Host: GitHub
URL: https://github.com/Roshan-R/termv
Owner: Roshan-R
License: gpl-3.0
Created: 2021-04-18T10:27:11.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2023-11-09T05:42:33.000Z (7 months ago)
Last Synced: 2024-02-01T11:07:32.960Z (5 months ago)
Topics: bash, cli, command-line, fzf, linux, makefile, mpv, shell, shell-script, terminal, tv
Language: Shell
Homepage:
Size: 74.2 KB
Stars: 203
Watchers: 9
Forks: 18
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

cli-apps - termv - A terminal IPTV player written in bash. (<a name="viewers"></a>Viewers)
awesome-iptv - termv - A terminal IPTV player written in bash. (Apps)
awesome-stars - termv - R | 220 | (Shell)
awesome - termv - A terminal iptv player written in bash (Shell)
awesome-cli-apps - termv - A terminal IPTV player written in bash. (<a name="viewers"></a>Viewers)

README

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](https://github.com/iptv-org/iptv).

For an example for a custom channels list and how to make one yourself, visit [this gist](https://gist.github.com/Roshan-R/7eddda0789297d86219fda21876b2632).

For windows support, consider using [termv-rs](https://github.com/Roshan-R/termv-rs), a rewrite of termv in rust.

## Dependencies
- `curl`
- `mpv`
- `gawk`
- [`jq`](https://github.com/stedolan/jq)
- [`fzf`](https://github.com/junegunn/fzf)
- `xdo` (optional, for `-s` flag)

## Usage

```console
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
```sh
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)
```sh
yay -S termv
```

### Nix
Users of the Nix package manager with [`flakes`](https://nixos.wiki/wiki/Flakes) support can execute termv using
```sh
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

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

+ **Install with the Makefile**

```sh
sudo make install
```

+ **Uninstall with the Makefile**

```sh
sudo make uninstall
```

## Credits
A big thank you to all the [`contributors`](https://github.com/Roshan-R/termv/graphs/contributors)

Thanks to [`ytfzf`](https://github.com/pystardust/ytfzf) for the Makefile and
[`tmpmail`](https://github.com/sdushantha/tmpmail) as a reference on how to structure bash scripts.