A user-friendly tool for accessing and watching live streams, videos, and clips from Twitch.
https://github.com/haaag/PyTwitch/assets/81921095/e8f07a06-d9dd-47e0-a6d4-f9fba455be16
For authentication, you can set environment vars in your shell
and export them or use the
.env
file and put it in the root of the project.
env-template file
# Twitch credentials
TWITCH_CLIENT_ID="xxxxx"
TWITCH_ACCESS_TOKEN="xxx"
TWITCH_USER_ID="123456"
user:read:follows
# Clone repository
$ git clone "https://github.com/haaag/pytwitch.git"
$ cd pytwitch
# Create virtual environment & source
$ python -m venv .venv
$ source .venv/bin/activate
# Install requirements
(.venv) $ pip install -r requirements.txt
# Install
(.venv) $ pip install .
After installation you can use the command pytwitch
Or use a alias like alias pt='pytwitch -e ~/path/to/envfile/.env'
$ pytwtich -h
Simple tool menu for watching streams, videos from twitch.
arguments:
-m, --menu select menu [rofi|dmenu] (default: rofi)
-e, --env path to env file
-C, --channel search by channel query
-G, --games search by game or category
-v, --verbose increase verbosity (use -v, -vv, or -vvv)
-h, --help show this help
options:
--no-markup disable pango markup (rofi)
--no-conf disable `mpv` configuration
Keybind | Usage |
---|---|
alt-k | list keybinds |
alt-s | search by category or game |
alt-c | search by channel |
alt-v | list channel's videos |
alt-t | group by category or game |
alt-o | open stream chat in browser |
alt-i | show item information |
alt-m | show top streams |
alt-g | show top games with streams |
argparse
helpkeybinds