The terminal-native social experience.
Tuitter is a high-performance, keyboard-first social client designed for developers and terminal enthusiasts. Built with a focus on speed, privacy, and aesthetic minimalism, it brings your social world directly into your dev environment.
- Instant Navigation: Switch between Timeline, Discover, and Messages with zero lag using global hotkeys 1-6.
- Vim Power: Navigate natively with j, k, h, l, gg, and G.
- Seamless Flow: Stay in your terminal. No context switching to heavy browser tabs.
- Media Viewer: Open any post's media in a full-resolution ASCII/Braille modal with 'o'.
- ASCII Avatars: Generate and customize expressive profile pictures using the built-in generator.
- Braille Art: High-fidelity image-to-braille conversion for an aesthetic terminal experience.
- Local Storage: Your tokens and settings are stored securely on your machine (keyring/DPAPI).
- Direct Backend: Communicates directly with our optimized FastAPI backend.
| Timeline | Settings |
|---|---|
![]() |
![]() |
| Media Viewer | Chat View |
|---|---|
![]() |
![]() |
The easiest way to install Tuitter is via pipx, which handles virtual environment isolation and puts the command on your PATH.
pipx install tuitterIf you don't have pipx or prefer an automated script:
macOS / Linux / WSL:
curl -fsSL https://raw.githubusercontent.com/tuitter/tuitter/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/tuitter/tuitter/main/install.ps1 | iexpipx install "git+https://github.com/tuitter/tuitter.git"| Key | Action |
|---|---|
| 1 - 6 | Switch Screens |
| p | View Profile |
| d | View Drafts |
| j / k | Navigate Down / Up |
| o | Open Full-Size Media |
| n | New Post |
| : | Command Mode (e.g., :q, :del) |
| esc | Close Modal / Cancel |
- Bugs and Features: GitHub Issues
- Built With: Textual and FastAPI
Made for the terminal.



