Mastui is a modern Mastodon client for your terminal. Built with Python and the powerful Textual framework, it provides a highly efficient, multi-column layout that lets you keep an eye on all the action at once.
Whether you’re a power user who wants to manage multiple accounts or someone who just loves the terminal, Mastui is designed to be your new favorite way to interact with Mastodon.
This is free and open source software.
Features include:
- Multi-Column Layout: Home, Local, Federated, Mentions, and DM timelines can be shown side-by-side. Layout automatically collapses for narrow terminals.
- Multi-Profile & Sandboxed Config: Every account has its own config directory, keymap, credentials, cache, and custom theme overrides.
- Timeline Power Features:
- Like, boost, reply, edit, and view threads directly from the keyboard
- Jump to the top (g), refresh (r), or move between columns with configurable bindings
- Persistent SQLite cache enables offline reading and super fast scrolling
- Rich Composer:
- Content warnings, poll builder, visibility controls, and language selector.
- Autocomplete for @mentions and #hashtags sourced from your follows and the local instance.
- Inline preview of original post when replying.
- Media Friendly:
- Inline image previews with ANSI, Sixel, or TGP renderers (auto-detect)
- Polls rendered with vote counts or interactive voting UI
- URL extractor modal lets you copy media/card links without leaving the TUI
- Personalization:
- Quick theme switches plus custom CSS overrides
- Keybinding editor with per-profile keymap.json
- Options modal to toggle timelines, enable image caching, configure auto-refresh cadence, and curate the language list used in the composer
- Productivity niceties:
- Search panel for people, tags, and posts.
- Hashtag timeline modal.
- Profile and conversation screens with follow/mute/block actions.
- Log viewer (F12).
- Cross-platform support – runs under Linux, Android, macOS, and Windows.
Website: github.com/kimusan/mastui
Support:
Developer: Kim Schulz
License: MIT License
Mastui is written in Python. Learn Python with our recommended free books and free tutorials.
Return to Text-Based Mastodon Clients
Related Software
| Mastodon Clients | |
|---|---|
| toot | CLI and TUI client written in Python |
| Mastui | Built with Python and the powerful Textual framework |
| mastodon.el | Emacs client for Mastodon |
| tut | Command-line interface written in Go |
| tootstream | Python-based command-line interface |
| Gomphotherium | Provides a CLI as well as a TUI |
| madonctl | Golang command line interface for the Mastodon API |
Read our verdict in the software roundup.
 Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |