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 |
| tooi | Text-based user interface for Mastodon, Pleroma and friends |
| mastodon.el | Emacs client for Mastodon |
| Perch | Social client for Mastodon and Bluesky |
| Gomphotherium | Provides a CLI as well as a TUI |
| tut | Command-line interface written in Go |
| tootstream | Python-based command-line interface |
| madonctl | Golang command line interface for the Mastodon API |
| Tooters | Rust TUI-based Mastodon app |
| mastotui | Distraction-free terminal client for Mastodon |
Read our verdict in the software roundup.
 LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |
Please read our Comment Policy before commenting.