Introduction

twitch-tui is a Terminal User Interface for reading and interacting with Twitch chat users.

The ideal setup would be this application and streamlink, to obliterate all need for a browser while watching streams.

This book is still under construction, so some sections might still be missing. Feel free to submit an issue if you find that something needs improvement.

Quick start

This application has vim and emacs inspired keybinds. That means you will start out in visual mode.

The default start screen is the dashboard. This can be configured with first_state in the config file.

Once in the application, hitting ? or h will bring up the keybind window. To go back to the previous window, hit Esc.

To go to a channel, either hit Enter or an integer between square brackets to go to the corresponding channel.

To get a message to pop up in the chat, press i or c, then type your message and hit Enter. If you want to cancel typing a message, hit Esc.

You can go back to the dashboard by hitting S (Shift + s).

Insert modes at this time are message search (Ctrl + f), channel swapper (s), and the previously mentioned insert mode (i or c).

To see all the options with keybinds, either head over to the keybinds section of this book, or press ? while in visual mode.

Configuration and installation

The how-to of getting this application up and running.

• Installation
• Configuration
• Flake

Installation

Cargo

After installing Rust, use the following command to install twitch-tui:

cargo install twitch-tui

For a specific version, head over to the releases page and select the release you want.

Installing a version such as 2.0.0-alpha.1 would be cargo install twitch-tui --version "2.0.0-alpha.1".

(PPT and AUR repos coming soon)

To uninstall, run the command cargo uninstall twitch-tui.

Nix

twitch-tui is also a Nix Flake! You can build and run it on nix using:

nix run github:Xithrius/twitch-tui

Configuration

Config file

After running twt for the first time, a config file will be generated at the following locations, depending on your OS:

• Linux/MacOS: ~/.config/twt/config.toml
• Windows: %appdata%\twt\config.toml

You can find the default configuration values here.

Auth

Get an OAuth token from Twitch, and put the value in one of two places:

1. The token variable in the config.toml that was previously generated.
2. The environment variable TWT_TOKEN.

The environment variable will be used first, even if a token exists in config.toml. If one doesn't exist there, your config token will be used.

Emotes

Use a terminal that fully supports the graphics protocol, such as kitty or WezTerm.

Enable the emotes by setting twitch_emotes, betterttv_emotes and/or seventv_emotes to true.

The emotes will be downloaded to ~/.cache/twt/ on Linux/MacOs and %appdata%\twt\cache\ on Windows.

Run it

Run twt in the terminal. For help, twt --help.

Keybind guide

All of the keybinds are in this section.

• Dashboard
• Normal
• Insert mode(s)

Normal mode keybind map

Can be the start state by configuring first_state in the config to either "normal" or "default".

Insert mode(s) keybind map

Message sending and searching, along with channel swapping keybinds are explained in this section.