chatuino

A Twitch chat client that runs in your terminal.

More screenshots

Table of Contents

• Intro
• Features
• Installation
• Usage
• License

Intro

If you spend time in Twitch chat and prefer working in a terminal, Chatuino gives you a native experience without the browser overhead. It handles multiple accounts, displays emotes directly in supported terminals, and stays out of your way.

The project draws inspiration from Chatterino and twitch-tui.

Features

• Multiple accounts with easy switching
• Join any number of chats simultaneously
• Anonymous lurking without an account
• Emotes rendered in-terminal (Kitty, Ghostty)
• 7TV and BTTV emote support
• Tab completion for emotes and usernames
• User inspect mode for viewing chat history per user
• Mention notifications and live alerts in dedicated tabs
• Message search and local chat logging
• Moderator tools with quick timeout shortcuts
• Custom commands with templating support
• Theming and configurable keybinds
• Self-hostable server component

For the full list, see Features.

Installation

Arch Linux: Install chatuino-bin from the AUR.

Install script (Linux/macOS):

curl -sSfL https://chatuino.net/install | sh

Options:

# Install to a specific directory
curl -sSfL https://chatuino.net/install | sh -s -- -b /usr/local/bin

# Install a specific version
curl -sSfL https://chatuino.net/install | sh -s -- -v v0.6.2

Pre-built binaries: Available on the releases page.

Install from source:

go install github.com/julez-dev/chatuino@latest

Usage

Run chatuino --help to see available commands.

Opening tabs from the command line

Use --tab to open Chatuino with specific tabs:

chatuino --tab streamer1 --tab streamer2
chatuino --tab myuser@streamer1 --tab notification
chatuino --tab anonymous@streamer1 --tab streamer2

When --tab is used, Chatuino runs in detached mode and does not load or save state to disk. See Features for the full syntax reference.

Adding an account

chatuino account

This opens the account manager. To link a Twitch account, you'll need to authenticate through https://chatuino.net/auth/start (or your own server) and paste the resulting token.

Configuration

See Settings for keybinds, emote display options, chat logging, and other configuration.

Self-hosting

Chatuino connects to chatuino.net by default for authentication and API proxying. If you prefer to run your own server, follow the self-host guide.

Contributing

Contributions are welcome! If you contribute to Chatuino, add yourself to contributor/contributors.json with your GitHub username, email, and optionally your Twitch login name to receive attribution and a special contributor badge in chat.

License

MIT. See LICENSE.