Twitch via the terminal
2025-12-21 15:19:20 +00:00
assets Make bash the default! 2025-11-26 16:12:23 +00:00
.gitignore Add ideas file 2024-09-15 00:45:51 +01:00
LICENSE Add LICENSE 2024-06-01 16:59:32 +00:00
README.md remove and from commands 2025-12-11 14:16:14 +00:00
twinge Tweak 2025-12-21 15:19:20 +00:00

Logo, stylised words "twinge"

Twitch via the terminal!

Dependancies

streamlink, jq, curl and a video player

Note

Works best with vlc or mpv.

Debian / Ubuntu

sudo apt install streamlink jq curl

Fedora

sudo dnf install streamlink jq curl

OpenSuse

sudo zypper install streamlink jq curl

Arch

sudo pacman -S streamlink jq curl

Setup

Linux

  1. git clone https://gitlab.com/tripplehelix/twinge.git or download Latest Release.
  2. chmod +x ./twinge
  3. ./twinge

Note

Once setup has been completed ~/.config/twinge/twinge.conf will be created.

Screenshot

Preview

Usage

You use the arrow keys or w/s to scroll the list and make a selection with the space key for 480p or enter for best quality. You can close out with q or ctrl+c.

If you need to rerun the setup script, simply run twinge with --setup.

Twinge – Twitch in the terminal

Usage: twinge [OPTION] [QUERY]

  -f, --following       List followed streams
  -p, --popular         Top 100 streams
  -g, --game NAME       Top streams for game
  -t, --streamer USER   Dpecific streamer
  -o, --open USER       Open twitch page in browser
  -h, --help            This screen
  -v, --version         Show version
  --setup               First-time configuration

TUI Controls:
  ↑/↓ or w/s            Navigate streams
  Enter                 Open stream (best quality)
  Space                 Open stream (lowest quality)
  f                     Show followed streams
  p                     Show popular streams
  g                     Search by game
  t                     Search by streamer
  o                     Open in browser
  q, ctrl+q             Quit

Examples:
  twinge                Show followed streams
  twinge -p             Show popular streams
  twinge -g "Valorant"  Search game streams
  twinge -t shroud      Search specific streamer
  twinge -o shroud      Open streamer in browser

The legacy python version of the script can be still downloaded, however it's no longer updated.
https://codeberg.org/tripplehelix/twinge/releases/tag/v2.0.0