GMTUI is a fast, keyboard-driven Gmail client for the terminal. It focuses on cached, low-latency inbox navigation, a composable UI, and async Gmail API calls without blocking the render loop.
cargo install gmtui
git clone https://github.com/programmersd21/gmtui
cd gmtui
cargo build --release
config.toml (default path: platform config directory + gmtui/config.toml)
# OAuth (required)
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
token_cache_path = "token.json" # optional, default: config_dir/gmtui/token.json
# UI + cache
theme = "dark" # dark | light
page_size = 20
cache_ttl_secs = 300
[keybindings]
down = "j" # also supports Down
up = "k" # also supports Up
open = "Enter"
compose = "c"
reply = "r"
delete = "d"
search = "/"
refresh = "R"
quit = "q"
next_tab = "Tab"
prev_tab = "Shift+Tab"
load_more = "L"
help = "?"
| Action | Key |
|---|---|
| Down | j / Down |
| Up | k / Up |
| Open | Enter |
| Compose | c |
| Reply | r |
| Delete | d |
| Search | / |
| Refresh | R |
| Quit | q |
| Next Tab | Tab |
| Prev Tab | Shift+Tab |
| Load More | L |
| Help | ? |
$ gmtui
/ rust
Rust newsletter
Rust async roundup
<Enter>
Available themes: dark, light.
- Channel-based async event loop
- Gmail list/get/send/delete/modify
- Cache with TTL + lazy load
- Search overlay filtering
- Email view with scrolling
- Composer with reply prefill
- Sorting (date/sender/subject)
- Sidebar categories + unread counts
- Theming with dark/light
- Status bar with key hints
See CONTRIBUTING.md for development workflow and code style.
License: MIT