twitchez - TUI client for twitch.tv with thumbnails support that works right in your terminal
Reason this release was yanked:
developer intent was to make a stable release
Project description
twitchez
twitchez - TUI client for twitch.tv with thumbnails support that works right in your terminal.
Support of rendering images by the terminal is not required, ueberzugpp will handle that.
You may ask -- "Is this magic?" -- Well YES, the black magic! Welcome to the club!
Since v0.0.7 twitchez supports ueberzugpp -- this expands list of supported platforms:
linux / macOS / windows / freeBSD / X11 / Wayland / any terminal with SIXEL support e.g.
WezTerm
Leave a star to show interest in further development of the project ⭐️
CLICK TO WATCH DEMO VIDEO
Features
- 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 the ueberzugpp (optional dependency)
Configuration
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
Pip
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.
Install ueberzugpp to display thumbnails (Optional)
If ueberzugpp is not installed text mode without thumbnails will be used.
You also can build from source
and install build dir e.g. # sudo cmake --install build
Troubleshooting
If you installed ueberzugpp but still not see thumbnails:
- override default ueberzugpp output via twitchez user config (check default.conf it has example)
- check available output options in ueberzugpp via
$ ueberzugpp layer --help
- x11 and/or wayland (may not be available if disabled in compilation) -- build ueberzugpp from source
- if you want to draw via e.g. sixel, make sure that your terminal have such capability
- WezTerm has sixel support, try to launch twitchez in it
If thumbnails partially overlap underlying text (it is very font dependent):
- set width/height modifier in user config
- adjust your terminal font size by +1 etc
- try different terminal font
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for twitchez-0.0.7rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fd599cd6c8ae698ac5876b34dfb115e65c3e39822b6703cb1c260b47711c940 |
|
MD5 | cab2da77e715fc16653e5861f4d3e4bb |
|
BLAKE2b-256 | c44f8512a6d731ac955cc4af60b5c561b71b78158ae7d41dc080c5668ab14b21 |