heartmore/icloud-hme

★ 13PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((icloud-hme))
    What it does
      Bulk alias creation
      Hide My Email automation
      Scheduled runs
    Interfaces
      Local web dashboard
      Command-line tool
    Dashboard Features
      Daily and total counts
      Alias list with copy option
      Export controls
      Scheduler toggle
    Scheduler
      Runs once per hour
      Backs off at Apple limit
      Server-time syncing
    Setup
      Python 3.10 required
      iCloud Plus subscription
      Chrome cookie export

mindmap root((icloud-hme)) What it does Bulk alias creation Hide My Email automation Scheduled runs Interfaces Local web dashboard Command-line tool Dashboard Features Daily and total counts Alias list with copy option Export controls Scheduler toggle Scheduler Runs once per hour Backs off at Apple limit Server-time syncing Setup Python 3.10 required iCloud Plus subscription Chrome cookie export

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Create dozens of iCloud Hide My Email aliases automatically without visiting Apple settings each time.

USE CASE 2

Run an hourly scheduler that creates aliases until Apple's daily limit is hit, then backs off and retries automatically.

USE CASE 3

Export a full list of all your existing iCloud aliases with copy and download options for auditing which alias you gave to which service.

USE CASE 4

Run the alias generator on a home server using the CLI without needing a display or browser.

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an active iCloud+ subscription and exporting iCloud session cookies from Chrome using a browser extension.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

icloud-hme is a Python tool that automates the creation of private email aliases using Apple's Hide My Email feature. If you have an iCloud+ subscription, Apple lets you create disposable @icloud.com addresses that forward to your real inbox. This tool can create those addresses in bulk without visiting the settings page each time. The tool has two ways to use it. The first is a simple web interface that runs locally in your browser. It shows a dashboard with counts of how many aliases were created today and in total, a list of all your aliases with copy and export options, and controls for the built-in scheduler. The second is a command-line interface for people who prefer working in a terminal or want to run it on a server without a display. The scheduler is the main feature for unattended use. It runs a job at a random point within 15 minutes of each hour, creates aliases until Apple signals a limit has been reached, then waits for the next cycle. If two consecutive attempts hit the limit immediately, it backs off and retries after about five minutes. All timing uses the time reported by the server over HTTP rather than the local system clock, so it stays accurate even if the machine's clock drifts. To authenticate, you supply your iCloud session cookies, which you can export from Chrome using a browser extension or let the tool extract automatically on Windows. The cookies are saved locally after the first import so you do not need to paste them again on restart. The project requires Python 3.10 or newer and an active iCloud+ subscription. It works on Windows, macOS, and Linux. The license is MIT.

Copy-paste prompts

Prompt 1

Set up icloud-hme with my iCloud session cookies exported from Chrome, then start the scheduler to create new Hide My Email aliases every hour until I hit Apple's limit.

Prompt 2

Use the icloud-hme web dashboard to export all my existing Hide My Email aliases to a file so I can see which address I gave to which service.

Prompt 3

Configure icloud-hme on a Linux home server using the CLI mode so it creates aliases automatically overnight while I am not at my Mac.

Open on GitHub → Explain another repo

← heartmore on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.