Twitch Menu

⭐ About

A user-friendly tool for easily accessing and watching live streams, videos, and clips from Twitch, it presents a menu interface for seamless browsing and streaming.

⚡️ Requirements

• Player:
  • ⭐ mpv (default)
  • streamlink
• Launcher:
  • dmenu
  • Rofi
  • fzf (WIP)

➕ Dependencies

• httpx
• python-dotenv
• pyselector

🔒Credentials

For authentication, you can set environment vars in your shell 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"

🔓Credentials directions

• Twitch token generator
  • Scope: user:read:follows
• Twitch Channel ID and User ID Converter

📦 Installation

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

🛠️ Usage

After installation you can use the command pytwitch

# Use rofi menu by default
(.venv) $ pytwitch

# You can use it with dmenu or rofi
(.venv) $ pytwitch -m dmenu

# or
(.venv) $ pytwitch --menu=fzf

# Help
(.venv) $ pytwitch --help

🖼️ Gifs

🔗 References

• Twitch API
• Twitch API Reference

🧰 TODO

• Create/Update requirements/dependencies

• Complete Usage

• Update screenshots

• Better logging

• Finish tests

• Update GIFs

• Update argparse help

  • Display keybinds

• ignore