Skip to content

tuitter/tuitter

Repository files navigation

Tuitter

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.

Tuitter Timeline


Features

Performance and UX

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

Rich Rendering

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

Privacy First

  • Local Storage: Your tokens and settings are stored securely on your machine (keyring/DPAPI).
  • Direct Backend: Communicates directly with our optimized FastAPI backend.

Screenshots

Timeline Settings
Timeline Settings
Media Viewer Chat View
Viewer Chat

Quick Start

Recommended Installation (pipx)

The easiest way to install Tuitter is via pipx, which handles virtual environment isolation and puts the command on your PATH.

pipx install tuitter

One-Liner Installation scripts

If you don't have pipx or prefer an automated script:

macOS / Linux / WSL:

curl -fsSL https://raw.githubusercontent.com/tuitter/tuitter/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/tuitter/tuitter/main/install.ps1 | iex

Advanced: Install from Source

pipx install "git+https://github.com/tuitter/tuitter.git"

Global Shortcuts

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

Community and Support


Made for the terminal.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages