Mailtide v1.0.0

July 14, 2025 · View on GitHub

A lightweight Python-based CLI email client. Mailtide allows you to browse and manage IMAP inboxes via terminal aswell as send emails.

Features

  • View and browse folders from major IMAP providers
  • Compose and send emails with attachments
  • Move emails between folders
  • Download attachments to disk
  • Works with most major email providers:
    • Gmail, Yahoo, Outlook, iCloud, ProtonMail, Zoho, GMX, Yandex, FastMail, and more
  • Terminal User Interface powered by 'curses'
  • Plain text and HTML parsing support

Installation

# Clone the repo
git clone https://github.com/LandonH2007/mailtide.git
cd mailtide

# Install the .deb package
sudo dpkg -i mailtide_v1.0.0.deb

# If any dependencies are missing, fix them
sudo apt --fix-broken install

Then run it:

mailtide

Controls

KeyAction
Shift+SSign in
Shift+OSign out
Shift+FEnter folder
Shift+ELoad and list messages
Shift+RRead email
Shift+MMove email
Shift+DDownload attachments
Shift+CCompose message
Shift+QQuit
Shift+rRefresh current folder
Shift+V / Shift+TPage down / up

Composition

KeyAction
^sSave as draft
^lLoad draft
^gSend email
^aAttach file
^xExit compose mode
/ Navigate message lines
EnterNew line
TabInsert tab character

App Passwords & Security

If you're using Gmail, Yahoo, or other services with 2FA, you may need to generate an app-specific password and use it instead of your normal password. Your password is not saved between sessions.

License

This project is licensed under the MIT License.

Contributing

Pull requests and feedback are welcome.

Author

Landon Haught

Made with a lot of frustration and trial & error,