Skip to main content

Twitch Play

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

Requirements

Installation

$ 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:

  1. Go to dev.twitch.tv/console and register a new app.
  2. Set the OAuth redirect URL to http://localhost:8765/callback and category to Website Integration.
  3. 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-C Copy channel name to the clipboard
Ctrl-F Search categories (category screen)
Esc Go back

Chat

Key Action
/ Search
p Pause chat scrolling
k Go up in the chat
j Go down in the chat

Metadata

Release files for twitch-play 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for twitch-play 0.2.3
File Size Uploaded Provenance Actions
twitch_play-0.2.3.tar.gz 23.6 kB Without provenance Details for twitch_play-0.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for twitch-play 0.2.3
File Interpreter ABI Platform Actions
twitch_play-0.2.3-py3-none-any.whl Python 3 none any Details for twitch_play-0.2.3-py3-none-any.whl

Total release size: 47.6 kB

Release files / twitch_play-0.2.3.tar.gz

Download URL twitch_play-0.2.3.tar.gz
Size 23.6 kB
Tags Source
SHA-256 checksum
How to use checksums
bb9ec84e8223497fd1009b1a0ca7aa14cc6f151b75fd8ba4add246946d5baae7
BLAKE2b-256 checksum
How to use checksums
ba26aed53e9233b9b7ff3e2c7326bf7ec7b97ad5f384bb92885e117aa7d6fa2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / twitch_play-0.2.3-py3-none-any.whl

Download URL twitch_play-0.2.3-py3-none-any.whl
Size 24.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
91dc75a1bd6117ed214d63c7d396d6ff9bc9892e7353aaeea2d906cf461abf58
BLAKE2b-256 checksum
How to use checksums
c73baf6837697f26be676b7849c9a63e3d9a34360de2b66e3ab6ad1784e11dda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Security for twitch-play 0.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page