Mastui — a retro‑modern Mastodon client for your terminal

Blazing‑fast TUI built with Python and Textual. Multi‑column timelines, image rendering (ANSI/Sixel/TGP), persistent cache, and an elegant keyboard‑driven workflow.

➜ Quick install Follow @Mastui

kim@tty0:~$ pipx install mastui
kim@tty0:~$ mastui

Features

Multi‑column layout

View Home, Notifications, and Federated at once. Toggle which timelines to show.

Persistent cache

SQLite‑backed caching keeps scrolling silky‑smooth and resilient to network hiccups.

Compose & reply

Full composer with character counter, CWs, polls, language selection and more.

Keyboard‑driven

Like, boost, reply, open profiles and threads with quick shortcuts.

Image rendering

View images right in your terminal (Auto/ANSI/Sixel/TGP) with a persistent image cache.

Themeable

Multiple light & dark themes built‑in. Configure per‑timeline refresh intervals.

Install

Recommended: pipx

# 1) Install pipx (if needed)
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# 2) Install Mastui
pipx install mastui

# Run it
mastui

pipx keeps apps isolated from your system Python and lets you run them from anywhere.

Upgrade

pipx upgrade mastui

From source (dev)

git clone https://github.com/kimusan/mastui
cd mastui
# using Poetry
poetry install
poetry run mastui

Mastui is built with Python, Textual, Poetry, httpx, Mastodon.py and more.

Tech stack

Python

Modern async‑friendly core.

Textual

The next‑gen TUI framework powering the UI.

Poetry

Dependency and virtualenv management.

Mastui is open‑source under the MIT license. Contributions welcome!