Bltz

A fast terminal email client written in Rust.

Screenshots

Screenshots coming soon

Features

• Multi-account support - Manage multiple email accounts simultaneously
• OAuth2 & password authentication - Secure login with Gmail OAuth2 device flow or traditional passwords
• Vim-style keybindings - Navigate efficiently with familiar Vim motions (Arrow key mode also available)
• Email threading - Conversations grouped intelligently by Message-ID and subject
• Fast full-text search - Search across all your emails
• Offline caching - SQLite-backed cache for fast access
• Desktop notifications - Get notified of new emails
• Secure credential storage - Passwords stored in system keyring
• AI features (optional) - Email summarization and grammar polish via OpenRouter

Installation

Pre-built Binaries

Download the latest release from the Releases page.

# Linux x86_64
curl -LO https://github.com/Mountlex/bltz/releases/latest/download/bltz-linux-x86_64.tar.gz
tar xzf bltz-linux-x86_64.tar.gz
sudo mv bltz /usr/local/bin/

# macOS x86_64
curl -LO https://github.com/Mountlex/bltz/releases/latest/download/bltz-macos-x86_64.tar.gz
tar xzf bltz-macos-x86_64.tar.gz
sudo mv bltz /usr/local/bin/

Cargo Install

cargo install bltz

Build from Source

git clone https://github.com/Mountlex/bltz.git
cd bltz
cargo build --release
./target/release/bltz

Package Managers

• Homebrew: brew install bltz (coming soon)
• AUR: yay -S bltz (coming soon)

Configuration

Bltz stores its configuration at ~/.config/bltz/config.toml.

Initial Setup

Run the setup wizard to configure your first account:

bltz setup

Manual Configuration

Create ~/.config/bltz/config.toml:

[general]
keybindings = "vim"  # or "arrows"
theme = "dark"       # or "light"

[[accounts]]
name = "Personal"
email = "you@gmail.com"
imap_host = "imap.gmail.com"
imap_port = 993
smtp_host = "smtp.gmail.com"
smtp_port = 587
auth = "oauth2"      # or "password"

See config.example.toml for a complete example.

AI Features (Optional)

AI features are disabled by default. To enable email summarization and grammar polish:

[ai]
api_key = "sk-or-v1-..."           # OpenRouter API key
enable_summarization = true
enable_polish = true
model = "anthropic/claude-3-haiku" # Optional, this is the default

Usage

bltz          # Start the email client
bltz setup    # Run account setup wizard
bltz help     # Show usage information

Debug Mode

RUST_LOG=debug bltz

Logs are written to ~/.config/bltz/bltz.log.

Keybindings

Navigation (Vim Mode)

Actions

AI Features

File Locations

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Security

For security vulnerabilities, please see SECURITY.md.

License

This project is licensed under the MIT License - see the LICENSE file for details.