Metadata-Version: 2.4
Name: twitch-play
Version: 0.1.1
Summary: A minimal Twitch CLI client. Browse categories and streams with fzf, play with mpv.
Author: kasramp
License: GPL-3.0
Project-URL: Homepage, https://github.com/kasramp/twitch-play
Project-URL: Repository, https://github.com/kasramp/twitch-play
Project-URL: Issues, https://github.com/kasramp/twitch-play/issues
Keywords: twitch,mpv,streamlink,fzf,cli,tui,streaming,twitch-client,terminal
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: flask
Requires-Dist: streamlink
Requires-Dist: pyfzf
Dynamic: license-file

# Twitch Play

A minimal Twitch CLI app built on top of mpv, streamlink, and fzf.

## Requirements

- Python 3.10+
- [mpv](https://mpv.io)
- [streamlink](https://streamlink.github.io)
- [fzf](https://github.com/junegunn/fzf)

## Setup

There's a clientId 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:

1. Register an app at [dev.twitch.tv/console](https://dev.twitch.tv/console), set OAuth redirect to `http://localhost:8765/callback`, type **Website Integration**, and copy your Client ID.
2. Set your Client ID in `twitch_play/config.py`.

```bash
$ 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
```

## 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 |
