wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2025 winget.ragerworks.com

Loading...
Install newsletter-cli using Winget - wingetCollections
  1. Go back
  2. Packages
  3. newsletter-cli
newsletter-cli logo

newsletter-cli Loïc Kalbermatter

cli email golang imap newsletter terminal tui
Use this command to install newsletter-cli:
winget install --id=Loickal.NewsletterCLI -e

Newsletter-cli is a terminal-based tool designed to help users analyze and unsubscribe from newsletters directly from their inbox. The software connects via IMAP, identifies recurring newsletter senders, and provides an interactive Textual User Interface (TUI) for efficient management of subscriptions.

Key Features:

  • Connects securely via IMAP to popular email providers like Gmail and Outlook.
  • Uses smart detection to identify newsletter senders and categorize emails.
  • Offers a modern TUI built with Charm Bracelet Bubble Tea for intuitive navigation.
  • Supports mass unsubscribe functionality with options to select multiple newsletters at once.
  • Automatically handles unsubscribes via SMTP or List-Unsubscribe headers.
  • Stores credentials securely using age encryption and maintains an encrypted local database.

Audience & Benefit: Ideal for individuals who receive a high volume of newsletters and want to take control of their inbox. This tool allows users to analyze newsletter traffic, identify recurring senders, and unsubscribe from unwanted emails directly within the terminal, all while maintaining privacy and security.

README

📬 Newsletter CLI

> A beautiful, privacy-friendly terminal tool to analyze and unsubscribe from newsletters — right from your inbox.

Current Version: v1.0.0-BETA-1 🚧 Beta Release - See CHANGELOG.md for details.

Go Version License: AGPL v3 Build Status Release

🧠 Overview

Newsletter CLI connects to your mailbox (via IMAP), analyzes incoming messages, identifies recurring newsletter senders, and lets you unsubscribe from them interactively — all within a modern Bubble Tea TUI.

It’s local-first, secure, and open-source.
No servers, no tracking, no nonsense.

✨ Features

Core Features (Free & Open Source)

✅ Connect via IMAP (Gmail, Outlook, etc.) with auto-discovery
✅ Smart newsletter detection
✅ Aggregated sender statistics
✅ Interactive TUI built with Charm Bracelet Bubble Tea
✅ Mass unsubscribe with multiselect support
✅ Automatic mailto: unsubscribe via SMTP
✅ One-click unsubscribe via List-Unsubscribe header
✅ Persistent tracking of unsubscribed newsletters
✅ Multiple account management (add, switch, delete accounts)

  • Note: First account is free. Additional accounts require premium subscription
    ✅ Secure encryption using age (ChaCha20Poly1305)
    ✅ Encrypted local credential storage
    ✅ Config saved under ~/.config/newsletter-cli/config.json

🌟 Premium Features (Subscription Required)

Available via subscription - See Premium Features section below.

✅ Cloud Sync - Sync accounts and unsubscribed lists across devices ✅ - Web-based analytics with charts and trends ✅ - Newsletter categorization and quality scoring ✅ - Track API usage and monitor your account ✅ - Tier-based API limits (Starter, Pro, Enterprise)

Versions
1.0.0-BETA-1
0.3.0
0.2.0
Website
github.com
License
Last updated
11/11/2025
Download latest version

Analytics Dashboard

Advanced Analytics

Usage Statistics

Rate Limiting
  • Note: Rate limits may change and will be communicated in updates
    ✅ Account Limits - Server-side enforced account limits per tier
  • Starter: 3 accounts, Pro: 10 accounts, Enterprise: 50 accounts
  • Cannot be bypassed by modifying client code
    ✅ Secure API - Optional HMAC request signing for extra security

🧱 Installation

🐹 Go Install

go install github.com/loickal/newsletter-cli@latest

🍺 Homebrew

brew tap loickal/newsletter-cli
brew install newsletter-cli

🪟 Winget (Windows) - Coming Soon

Microsoft approval pending. Once approved:

winget install Loickal.NewsletterCLI

Alternative for Windows: Use Go install or download binaries from GitHub releases.

🐳 Docker

docker run --rm -it -v ~/.config/newsletter-cli:/config loickal/newsletter-cli analyze

🚀 Quick Start

1️⃣ Login once

newsletter-cli login

Enter your IMAP credentials — they're verified and saved locally (encrypted with age encryption).

2️⃣ Analyze newsletters

newsletter-cli analyze

➡️ Displays an interactive dashboard:

╭──────────────────────────────────────────────╮
│  📬 Newsletter Overview                       │
│  Total: 5 newsletters • 42 emails            │
│──────────────────────────────────────────────│
│  ✓✓ GitHub News Digest          (12 emails)  │
│     ✅ Already unsubscribed                   │
│  ▸ AWS Weekly Updates          (5 emails)   │
│     🔗 unsubscribe.link/abc123               │
│  📬 Stack Overflow Digest       (3 emails)  │
│     🔗 mailto:unsubscribe@stackoverflow.com │
│                                              │
│  [↑↓] Navigate  [Space] Select  [U] Mass    │
│  [u] Single  [/] Search  [Esc] Clear  [q]   │
╰──────────────────────────────────────────────╯

3️⃣ Manage Accounts

newsletter-cli

Navigate to "👤 Accounts" to:

  • Add multiple email accounts
  • Switch between accounts
  • Delete accounts
  • View active account

Keybindings

Dashboard:

  • ↑↓ - Navigate newsletters
  • Space - Select/deselect for mass unsubscribe
  • U - Unsubscribe from all selected newsletters
  • u - Single unsubscribe (opens browser for HTTP links)
  • / - Search/filter newsletters
  • Esc - Clear selection
  • q - Quit

⚙️ Configuration

PathDescription
~/.config/newsletter-cli/config.jsonStores all email accounts with encrypted passwords
~/.config/newsletter-cli/unsubscribed.jsonTracks newsletters you've unsubscribed from

CLI Flags

You can override credentials using CLI flags:

newsletter-cli analyze --email foo@example.com --server imap.example.com:993 --days 60

Multiple Accounts

Manage multiple email accounts:

  • First account is free - No subscription required
  • Additional accounts require premium subscription
  • Each account is stored with encrypted credentials
  • Switch between accounts from the Accounts screen
  • Each account has its own unsubscribe history

🌟 Premium Features

Newsletter CLI offers premium features via subscription to support development and infrastructure costs.

Available Plans

PlanPriceFeaturesAccount Limit
Starter$5/monthCloud sync, Basic analytics, Web dashboard3 accounts
Pro$12/monthEverything in Starter + Advanced analytics, Smart scheduling (coming soon)10 accounts
Enterprise$50/monthEverything in Pro + Team features, Compliance reporting (coming soon)50 accounts

Premium Features Overview

☁️ Cloud Sync

  • Sync email accounts across all your devices
  • Sync unsubscribed newsletters list
  • Automatic conflict resolution with three-way merge
  • Offline queue for failed syncs
  • Automatic retry with background processing
  • Account limits enforced server-side - Cannot be bypassed by modifying client code

📊 Analytics Dashboard

  • Beautiful web-based dashboard with interactive charts
  • View trends over day, week, month, or year
  • Newsletter and email statistics
  • Unsubscribe tracking and insights
  • One-click access from CLI ([w] key in Premium screen)

🎯 Advanced Analytics (Pro+)

  • Newsletter Categorization: Automatic classification into 7 categories
    • Technology, Finance, Marketing, Subscriptions, Promotional, News/Media, Other
  • Quality Scoring: 0-100 score based on frequency, unsubscribe ease, and category
    • Displayed in CLI with star ratings (⭐⭐⭐⭐⭐)
  • Period-over-Period Insights: Compare current vs previous periods
    • Percentage changes and trend analysis

📈 Usage Statistics

  • Track API usage over time
  • View requests per endpoint
  • Monitor rate limit status
  • Access via CLI ([v] key in Premium screen)

🔒 Security Features

  • Tier-based rate limiting (30-500 requests/minute based on plan)
    • Note: Rate limits are subject to change and will be communicated via updates
  • Usage tracking for abuse detection
  • Optional HMAC request signing
  • Server-side feature validation (cannot be bypassed)

Getting Started with Premium

  1. Launch the app and navigate to ☁️ Premium from the main menu
  2. Register/Login with your email and password
  3. Subscribe - Press [u] to view plans and subscribe via Stripe
  4. Enable features - Premium features activate automatically after subscription

Premium Configuration

Premium settings are stored in ~/.config/newsletter-cli/premium.json:

  • API credentials (encrypted)
  • Sync preferences
  • Analytics settings
  • Subscription status

🗺️ Roadmap

The full roadmap is available in ROADMAP.md.

PhaseFocusStatus
v0.2.0Mass unsubscribe, mailto support, multiple accounts✅ Complete
v0.4.0CI/CD & release pipeline✅ Complete
v1.0.0-BETA-1Premium features, cloud sync, analytics, account limits✅ Current
v1.0.0Stable release with comprehensive testing🔜 Future

🧩 Tech Stack

AreaLibrary
CLI Frameworkspf13/cobra
UI / TUIcharmbracelet/bubbletea, lipgloss
IMAP Accessemersion/go-imap
Encryptionfilippo.io/age
SMTPnet/smtp (for mailto unsubscribe)
PackagingGoReleaser

🧪 Development

Clone and run locally:

git clone https://github.com/loickal/newsletter-cli.git
cd newsletter-cli
go run main.go analyze

Run all tests:

go test ./...

🧠 Semantic Commits

Follow the Conventional Commits style:

TypeExample
feat(ui)add search filter to TUI
feat(unsubscribe)implement mass unsubscribe
fix(imap)handle auth errors gracefully
chore(release)bump to v0.2.0

🤝 Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a feature branch (feat/add-spinner)
  3. Write clear, semantic commits
  4. Open a PR → review & merge

Please read ROADMAP.md for feature planning before proposing major changes.

🪪 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

AGPL-3.0 is a strong copyleft license that requires:

  • You may use, modify, and distribute the software
  • If you modify the software and provide it over a network, you must share the source code
  • All modifications must be released under the same AGPL-3.0 license

See the LICENSE file for the full license text, or visit https://www.gnu.org/licenses/agpl-3.0.html for more information.

© 2025 Loïc Kalbermatter

🌟 Acknowledgements

Thanks to the maintainers of:

  • emersion/go-imap
  • charmbracelet/bubbletea
  • spf13/cobra
  • filippo.io/age

…and everyone contributing to open-source terminal tooling ❤️

> "Take control of your inbox. One unsubscribe at a time." — newsletter-cli