https://github.com/julez-dev/chatuino
A feature rich TUI Twitch IRC Client
https://github.com/julez-dev/chatuino
bubbletea chat go golang irc tui twitch twitchtv
Last synced: 4 months ago
JSON representation
A feature rich TUI Twitch IRC Client
- Host: GitHub
- URL: https://github.com/julez-dev/chatuino
- Owner: julez-dev
- License: mit
- Created: 2023-06-21T23:48:17.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-02-12T19:24:59.000Z (4 months ago)
- Last Synced: 2026-02-13T03:36:12.878Z (4 months ago)
- Topics: bubbletea, chat, go, golang, irc, tui, twitch, twitchtv
- Language: Go
- Homepage: http://chatuino.net
- Size: 42.8 MB
- Stars: 30
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
[](https://aur.archlinux.org/packages/chatuino-bin/)
A Twitch chat client that runs in your terminal.
[More screenshots](doc/SCREENSHOTS.md)
## Table of Contents
- [Intro](#intro)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [License](#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](https://github.com/Chatterino/chatterino2) and [twitch-tui](https://github.com/Xithrius/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](doc/FEATURES.md).
## Installation
**Arch Linux:** Install `chatuino-bin` from the AUR.
**Install script (Linux/macOS):**
```sh
curl -sSfL https://chatuino.net/install | sh
```
Options:
```sh
# 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](https://github.com/julez-dev/chatuino/releases).
**Install from source:**
```
go install github.com/julez-dev/chatuino@latest
```
## Usage
Run `chatuino --help` to see available commands.
### 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](doc/SETTINGS.md) 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](doc/SELF_HOST.md).
## 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](LICENSE).