A minimal Twitch CLI client. Browse categories and streams with fzf, play with mpv.
Project description
Twitch Play
A minimal Twitch CLI app built on top of mpv, streamlink, and fzf.
Requirements
- Python 3.10+
- mpv
- streamlink
- fzf
Installation
Quick install (recommended)
$ pipx install twitch-play
Or with pip:
$ pip install twitch-play
Then run:
$ twitch-play
From source
$ git clone https://github.com/kasramp/twitch-play
$ cd twitch-play
$ python -m venv venv && source venv/bin/activate
$ pip install -r requirements.txt
$ ./play-twitch
Configuration
There's a Client ID in the config.py file, which you can use for experiments. Ideally, you want to create your own app and use it, following the steps below:
- Go to dev.twitch.tv/console and register a new app.
- Set the OAuth redirect URL to
http://localhost:8765/callbackand category to Website Integration. - Copy your Client ID and set it in
twitch_play/config.py.
Usage
| Key | Action |
|---|---|
| Enter | Play stream at best quality |
| Ctrl-L | Play at 480p |
| Ctrl-H | Play at 720p |
| Ctrl-B | Play at best quality |
| Ctrl-O | Pick quality from list |
| Ctrl-F | Search categories (category screen) |
| Esc | Go back |
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file twitch_play-0.1.2.tar.gz.
File metadata
- Download URL: twitch_play-0.1.2.tar.gz
- Upload date:
- Size: 19.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f495f344751c253d60102efc295890f30c0e0dcebd5b86e06965f6db50ff3473
|
|
| MD5 |
aa762cdb7e90293226088a262170834a
|
|
| BLAKE2b-256 |
59c32943f9ccab3b55de8e0c6976e6a44e936197d5ecc7ed431b646e8c6e9e5f
|
File details
Details for the file twitch_play-0.1.2-py3-none-any.whl.
File metadata
- Download URL: twitch_play-0.1.2-py3-none-any.whl
- Upload date:
- Size: 19.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
393d15d952d44600377c3d24f925e778f193f9eded742816f9a9aeba72cbe5c8
|
|
| MD5 |
8172ccd9c8f5b1fbf3b690493474089a
|
|
| BLAKE2b-256 |
1c1111c693816e7b19811c64b2eeff1077859a4639907f0d99d93c3c53115b37
|