duckmail 0.1.0

Lightweight CLI for DuckDuckGo Email Protection

DuckMail CLI

Lightweight CLI for DuckDuckGo Email Protection - Manage your duck email addresses from the terminal.

English | Tiếng Việt

---

Quick Start

# Install
pip install -r requirements.txt
pip install -e .

# First time setup: Sign up via browser
# Visit https://duckduckgo.com/email/ to create account

# Login with your credentials
duckmail auth login

# Generate address and copy to clipboard
duckmail g -c

Note: Account signup must be done via browser at https://duckduckgo.com/email/ due to DuckDuckGo's bot protection. After signing up, use the CLI to login and manage your addresses.

Features

• 🔐 Secure Authentication - OTP-based login
• 📧 Generate Addresses - Create duck email addresses
• 📋 Copy to Clipboard - Auto-copy with -c flag
• ⚡ Fast & Lightweight - Quick commands with aliases
• 💾 Secure Storage - System keyring integration
• 🎨 Beautiful Output - Rich terminal UI

Command Aliases

• duckmail auth → duckmail a
• duckmail generate → duckmail g or duckmail gen
• duckmail info → duckmail i

Common Commands

# Authentication
duckmail auth login            # Login with username
duckmail auth logout           # Logout
duckmail auth status           # Check authentication status

# Generate
duckmail g                     # Generate 1 address
duckmail g -c                  # Generate & copy
duckmail g -n 5                # Generate 5 addresses

# Info
duckmail i                     # Account info
duckmail version               # Version

Documentation

📖 Complete Documentation - Full guide with:

• Installation instructions
• Usage examples
• API documentation
• Troubleshooting
• Command reference

Project Structure

duckmail/
├── duckmail/              # Main package
│   ├── api/              # API clients
│   ├── config/           # Configuration
│   ├── utils/            # Utilities
│   └── cli.py            # CLI interface
├── DOCS.md               # Complete documentation
├── PLAN.md               # Project plan
├── README.md             # This file
└── requirements.txt      # Dependencies

Development

# Setup
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
pip install -e .

# Run
duckmail --help

License

MIT License - See LICENSE file

Disclaimer

Unofficial tool, not affiliated with DuckDuckGo. Use at your own risk.

---

Made with ❤️ for the DuckDuckGo community 🦆