https://github.com/LandonH2007/mailtide
https://github.com/LandonH2007/mailtide
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/LandonH2007/mailtide
- Owner: LandonH2007
- License: mit
- Created: 2025-07-14T16:24:05.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-14T16:46:11.000Z (12 months ago)
- Last Synced: 2025-07-14T21:12:23.425Z (12 months ago)
- Size: 18.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - Mailtide - Lightweight Python-based CLI email client that allows you to browse and manage IMAP inboxes via terminal and send emails. (<a name="email"></a>Email)
- awesome-cli-apps - Mailtide - Lightweight Python-based CLI email client that allows you to browse and manage IMAP inboxes via terminal and send emails. (<a name="email"></a>Email)
README
# Mailtide v1.0.0
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
```bash
# 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:
```bash
mailtide
```
## Controls
### Main Menu
| Key | Action |
|------------|-------------------------------|
| `Shift+S` | Sign in |
| `Shift+O` | Sign out |
| `Shift+F` | Enter folder |
| `Shift+E` | Load and list messages |
| `Shift+R` | Read email |
| `Shift+M` | Move email |
| `Shift+D` | Download attachments |
| `Shift+C` | Compose message |
| `Shift+Q` | Quit |
| `Shift+r` | Refresh current folder |
| `Shift+V` / `Shift+T` | Page down / up |
### Composition
| Key | Action |
|--------------|-----------------------------|
| `^s` | Save as draft |
| `^l` | Load draft |
| `^g` | Send email |
| `^a` | Attach file |
| `^x` | Exit compose mode |
| `↑` / `↓` | Navigate message lines |
| `Enter` | New line |
| `Tab` | Insert 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](https://mit-license.org/).
## Contributing
Pull requests and feedback are welcome.
## Author
### Landon Haught
Made with a lot of frustration and trial & error,