matcha

---

             __       __
    ____ ___  ____ _/ /______/ /_  ____ _
    / __ '__ \/ __ '/ __/ ___/ __ \/ __ '/
  / / / / / / /_/ / /_/ /__/ / / / /_/ /
/_/ /_/ /_/\__,_/\__/\___/_/ /_/\__,_/

---

A beautiful and functional email client for your terminal, built with Go and the charming Bubble Tea TUI library. Never leave your command line to check your inbox or send an email again!

Features ✨

• View Your Inbox: Fetches and displays a list of your most recent emails.
• Read Emails: Select an email from your inbox to view its content.
• Compose and Send: A simple and intuitive interface for writing and sending new emails.
• Beautiful TUI: A clean and modern terminal user interface that's a pleasure to use.
• Secure: Uses a local configuration file to store your credentials securely.
• Supported Providers: Works with Gmail and iCloud.

Installation 🚀

There are several ways to install Matcha.

Package Managers

Homebrew 🍺 (macOS & Linux)

brew tap floatpane/matcha
brew install matcha

After installation, run:

matcha

to get started.

Install using Snap

sudo snap install matcha

Build from Source 🔨

Matcha is written in Go. To build it manually:

1. Ensure you have Go installed (go version).

2. Clone the repository:

   git clone https://github.com/floatpane/matcha.git
   

3. Navigate to the project folder:

   cd matcha
   

4. Build the binary:

   go build -trimpath -ldflags="-s -w" -o matcha
   

   For an even smaller binary, compress with UPX (install via brew install upx or apt install upx):

   upx --best --lzma matcha
   

[!WARNING] UPX compression does NOT work on macOS ARM builds. See #97

1. Run it:

   ./matcha
   

License 📄

This project is distributed under the MIT License. See the LICENSE file for more information.