twitchez - TUI client for twitch.tv with thumbnails support that works right in your terminal.
Terminal is not required to support image rendering, ueberzug will handle that.
You may ask -- "Is this magic?" -- Well YES, the black magic! Welcome to the club!
twitchez-v.0.0.4.mp4
This project is still in the early stage of development, you may, and probably will, experience corrupted terminal state, so run this client in a separate terminal window so you don't get frustrated if the client accidentally crashes.
- Explore twitch without leaving your terminal
- Flexible configuration via user config (including custom cmd)
- Completely keyboard driven workflow
- Bookmarks & Tabs (add, delete, next/prev, jump to tab by name)
- Following live channels
- Streams per category
- Videos per channel (archive/past broadcasts, clips, highlights, uploads)
- Open video/stream url in external video player
(streamlink,
mpv,
or any other program via custom cmd)
- Three independent user cmd and keys to open url as (stream, video, extra)
- Copy url to clipboard
- Open chat url in default browser or via custom cmd
- Thumbnails are drawn by ueberzug (X11 only)
(ueberzug is an optional dependency)
- If ueberzug is not installed text mode without thumbnails will be used
If you do not know what X11 is - for you this means thumbnails will be drawn on Linux only (not exactly)
Look inside twitchez/config/
dir to see all available settings, those are defaults.
Do not change default config files, create new in the user config dir: config.conf
, keys.conf
.
The default user config dir is $XDG_CONFIG_HOME/twitchez/
, or $HOME/.config/twitchez/
by default.
Settings from default config files are used as fallback for settings you haven't changed in your user config.
Install twitchez via pip into user-wide environment:
$ pip3 install --user twitchez
or system-wide environment:
# pip3 install twitchez
To update, add the --upgrade
or -U
option.
If ueberzug is not installed or not supported by your platform text mode without thumbnails will be used.
- set width/height modifier in user config
- adjust your terminal font size by +1 etc
- try different terminal font