Skip to content

ejm554/fastmail-bulk-manager

Repository files navigation

Fastmail Subscriptions Manager

Caution

This software is in active development. Changes may occur without warning, and documentation is not guaranteed to be up-to-date Always test safely with a Fastmail trial account, or create backups if using an existing account.

About

A web-based tool for efficiently managing subscription-based email in Fastmail.

Begin by creating a Subscriptions folder. As you manually move new email messages from your Inbox to this Subscriptions folder, you can use the tool later to intelligently offer you the option to move all older messages from specific senders and/or you can use it to create rules to move future messages.

Cross-Device Integration: Detects messages moved to Subscriptions from any device, regardless of whether you used the official Fastmail apps for iPhone or Android, the web interface, or any email client that connects to Fastmail via IMAP/JMAP.

Quick Start

  1. Test safely: Use a Fastmail trial account or create backups of your existing account
  2. Download the HTML file from this repository
  3. Open the file in any modern web browser
  4. Generate an App Password in Fastmail (Settings → Privacy & Security → App Passwords)
  5. Connect and start managing your Subscriptions email efficiently

Key Features

  • Periodic Review Interface: Scan Subscriptions folder and group recent messages by sender
  • Safety First: All actions require explicit confirmation dialogs
  • Bulk Operations: Select multiple senders for batch processing
  • Message Moving: Move all Inbox messages from selected senders to Subscriptions folder
  • Auto-Rule Creation: Generate Sieve filter rules for automatic future filtering
  • Universal Compatibility: Works on any modern browser across all operating systems

How It Works

  1. Mobile Workflow: Use Fastmail's mobile apps to manually move unwanted emails throughout the day from Inbox to Subscriptions folder
  2. Desktop Review: Run this tool periodically to batch-process all those senders
  3. Smart Actions: Use tool to move any remaining messages in Inbox and/or create rules for future emails
  4. Cross-Platform: Detects moves from any device or email client via direct JMAP connection

Example Workflow: Move emails on your phone during commutes, then run weekly cleanup sessions on your laptop to batch-process all those senders and create rules.

Documentation

Roadmap

See ROADMAP.md for detailed feature plans and development priorities.

Near-term focus:

  • Multi-folder support (Project folders, Newsletters, etc. simultaneously)
  • Enhanced user experience and safety features
  • Community-driven feature development

Technical Details

  • Platform: Works on any modern web browser across all operating systems
  • No Installation: Single HTML file - just open and use
  • Security: Direct JMAP connection to Fastmail, uses app passwords, no third-party servers
  • Extensibility: Built with toolkit foundation for future complementary tools
  • Educational: Extensively commented code for learning web development and email APIs

Support & Community

Status & Disclaimers

Caution

This software is in active development. Changes may occur without warning, and documentation is not guaranteed to be up-to-date Always test safely with a Fastmail trial account, or create backups if using an existing account.

Not affiliated with Fastmail - This is an independent community tool.

License

MIT License - See LICENSE file for details.

About

Web-based tool for managing subscription emails in Fastmail

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published