icloud-hme 1.0.0

Generate and manage iCloud+ HideMyEmail addresses from the command line

iCloud HideMyEmail Generator

Python CLI tool for generating and managing iCloud+ HideMyEmail addresses with multi-account support

Table of Contents

• iCloud HideMyEmail Generator
  • Table of Contents
  • Overview
  • Installation
  • Quick Start
  • Commands
    • Authentication
    • Generate Emails
    • List Emails
    • Export Emails
    • Manage Accounts
  • Rate Limits
  • Data Storage
  • Python API Usage
  • Contributing
  • License
  • Author

Overview

With an iCloud+ subscription you get this nice "HideMyMail" feature that let's you create random email addresses that forward to your personal inbox. Let's use our subscription at its best and easily generate them instead of buying address lists.

There are some other similar open source projects around, but I hated the fact that the login was via a "copy and paste" cookies logic. Here you get everything done properly with full SRP authentication and 2FA support.

Installation

pip install icloud-hme

Or install from source:

git clone https://github.com/glizzykingdreko/icloud-hidemymail-generator
cd icloud-hidemymail-generator
pip install -e .

Quick Start

# 1. Authenticate with your iCloud account
icloud-hme auth

# 2. Generate 5 new email aliases
icloud-hme generate -n 5

# 3. Export all emails to CSV
icloud-hme export --format csv

Commands

Authentication

# Interactive login with 2FA support
icloud-hme auth

# Or provide email directly
icloud-hme auth -e [e-mail]

Generate Emails

# Interactive generation (prompts for count)
icloud-hme generate

# Generate 5 permanent emails
icloud-hme generate -n 5

# Generate with custom label
icloud-hme generate -n 10 --label shopping

# Generate temporary emails (not reserved)
icloud-hme generate -n 3 --temp

# Generate and save to file
icloud-hme generate -n 5 --output emails.csv --format csv

# Use specific account
icloud-hme generate -n 5 --account [e-mail]

List Emails

# List all HideMyEmail addresses
icloud-hme list

# List for specific account
icloud-hme list --account [e-mail]

Export Emails

# Export to CSV (prompts for output path)
icloud-hme export

# Export to JSON
icloud-hme export --format json

# Export only active emails
icloud-hme export --filter active

# Custom output path
icloud-hme export --output ~/Desktop/my_emails --format csv

Manage Accounts

# List authenticated accounts
icloud-hme accounts

# Remove an account
icloud-hme logout

Rate Limits

Apple enforces the following rate limits on HideMyEmail:

Limit	Value
Per 30 minutes	~5 emails × family members
Total per account	~700 emails

The CLI automatically detects rate limits and displays warnings when they're hit.

Data Storage

All data is stored locally in ~/.icloud-hme/:

~/.icloud-hme/
├── account1_at_icloud_com/
│   ├── session.json      # Authentication tokens
│   └── emails.json       # Generated emails log
└── account2_at_icloud_com/
    └── ...

Session tokens and all of your data is stored locally.

Python API Usage

You can also use the library programmatically:

from icloud_hme import ICloudSession, HideMyEmailGenerator

# Authenticate
session = ICloudSession()
session.login("[e-mail]", "password")

# Generate emails
generator = HideMyEmailGenerator(session)
emails = generator.generate_multiple(
    count=5,
    reserve=True,
    label_prefix="api_test"
)

for email in emails:
    print(email)

Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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

Author

If you found this project helpful or interesting, consider starring the repo and following me for more tools, or buy me a coffee to keep me going ☕