A standalone Android companion for managing Apple iCloud+ Hide My Email addresses.
HideMyEmail Android is an independent Android companion to rtunazzz/hidemyemail-generator. It brings the essential Hide My Email workflow from a desktop-oriented tool to an Android phone, so users can manage their own iCloud+ aliases without relying on an iPhone.
It is intentionally maintained as a separate project. It complements the upstream CLI rather than changing or replacing its desktop workflow.
- Supports both global iCloud and iCloud China endpoints.
- Imports an iCloud session as either a raw
Cookieheader or Copy as cURL text. - Detects the appropriate iCloud region and maildomain host automatically when possible.
- Validates the signed-in Apple account before actions are performed.
- Generates Hide My Email addresses with labels and a configurable quantity.
- Lists active and inactive Hide My Email addresses.
- Maintains a local phone-side list with
unused,used, andtrashstates. - Copies aliases to the Android clipboard with one tap.
- Uses only the iCloud endpoints required for the selected operation; there is no companion server.
Install the latest APK from the Releases page. The published APK is a debug-signed build for direct installation on Android devices.
- Download and install the latest APK from Releases.
- Sign in to your own iCloud account in a browser and open the Hide My Email page.
- Copy the request
Cookieheader, or use browser DevTools Copy as cURL for an iCloud request. - Open the app, paste the value in Settings, then tap Validate account.
- Use the Generate, Addresses, and Local tabs to manage aliases.
Requirements: JDK 17+ and Android SDK Platform 34.
.\gradlew.bat testDebugUnitTest
.\gradlew.bat assembleDebugThe generated APK is written to app/build/outputs/apk/debug/app-debug.apk.
This repository is a companion project, not a request to add Android code to the upstream repository's main branch. The original desktop/CLI project remains available at rtunazzz/hidemyemail-generator. This app is designed to complement it for Android-only workflows.
The app stores its configuration and local address-state records on the device. Do not commit browser cookies, APK signing keys, or device-local configuration files to source control.
HideMyEmail Android 是 rtunazzz/hidemyemail-generator 的独立 Android 补充项目。它将原本偏桌面端的 iCloud+「隐藏邮件地址」操作带到 Android 手机上，方便没有 iPhone 的用户在自己的设备上管理别名邮箱。
本项目刻意保持独立维护：它补充上游 CLI 的使用场景，不修改、也不替代上游桌面端工作流。
- 同时支持国际区 iCloud 与中国大陆区 iCloud 端点。
- 支持粘贴原始
CookieHeader 或浏览器开发者工具的 Copy as cURL 内容。 - 自动识别 iCloud 区域和可用的 maildomain 主机。
- 操作前可校验当前登录的 Apple 账户。
- 按标签和数量生成隐藏邮件地址。
- 查看使用中与已停用的隐藏邮件地址。
- 在手机本地按「未使用 / 已使用 / 垃圾箱」整理地址状态。
- 一键复制隐藏邮箱地址。
- 仅直接请求完成所需功能的 iCloud 接口，不依赖额外中转服务器。
请在 Releases 页面下载最新 APK。当前发布包为便于直接安装的 debug 签名版本。
- 从 Releases 下载并安装最新 APK。
- 在浏览器登录自己的 iCloud，并打开「隐藏邮件地址」页面。
- 从相关请求复制
CookieHeader，或在开发者工具中选择 Copy as cURL。 - 打开 App，在「配置」页粘贴内容并点击「校验账号」。
- 使用「生成」「地址」「本地」页面管理隐藏邮箱。
需要 JDK 17+ 与 Android SDK Platform 34：
.\gradlew.bat testDebugUnitTest
.\gradlew.bat assembleDebug生成的 APK 位于 app/build/outputs/apk/debug/app-debug.apk。
本仓库是独立的 Android 补充项目，并不请求将 Android 代码合入上游仓库的 main 分支。原始桌面端/CLI 项目仍位于 rtunazzz/hidemyemail-generator；本 App 仅为 Android 场景提供配套能力。
App 会在设备本地保存配置与地址状态记录。请不要将浏览器 Cookie、APK 签名密钥或设备本地配置提交到代码仓库。
MIT. The original upstream copyright notice is retained in the license file.