Before using this tool, you should have:
- An Apple account with iCloud Plus (email ending with @icloud.com)
- Download the latest version from GitHub Releases
- Choose the version according to your system:
Windows: Download CursorKeepAlive.exe directly Mac (Intel): Choose x64 version Mac (M series): Choose ARM64(aarch64) version
Open Terminal, navigate to the application directory Execute the following command to make the file executable:
chmod +x ./CursorKeepAlive
Follow the setup instructions below, then run
Mac users: If you cannot rename the file, use
touch .env
to create the file in the same directory.
- Download
.env.example
file and rename it to.env
- Fill in the
.env
file
ICLOUD_USER=Your Apple ID (!!! without @icloud.com)
ICLOUD_APP_PASSWORD=Your Apple ID app-specific password (explained below)
ICLOUD_COOKIES=Your iCloud cookies (explained below)
- Download Cookie-Editor Chrome extension
- Go to iCloud Settings in your browser and log in
- Click the Cookie-Editor extension and export cookies in
Header String
format - Paste the exported cookies into the
.env
file asICLOUD_COOKIES
Cookie example:
X_APPLE_WEB_KB-V5590FJFX4ZYGBSJEZRZBTFB9UU="xxxxxx";X-APPLE-DS-WEB-SESSION-TOKEN="xxxxxx";X-APPLE-UNIQUE-CLIENT-ID="xxxxxx";X-APPLE-WEB-ID=28672BD9012631BA3CBAE022A1DBAEE2D0AFD358;X-APPLE-WEBAUTH-HSA-TRUST="xxxxxx";X-APPLE-WEBAUTH-LOGIN="xxxxxx";X-APPLE-WEBAUTH-PCS-Cloudkit="xxxxxx";X-APPLE-WEBAUTH-PCS-Documents="xxxxxx";X-APPLE-WEBAUTH-PCS-Mail="xxxxxx";X-APPLE-WEBAUTH-PCS-News="xxxxxx";X-APPLE-WEBAUTH-PCS-Notes="xxxxxx";X-APPLE-WEBAUTH-PCS-Photos="xxxxxx";X-APPLE-WEBAUTH-PCS-Safari="xxxxxx";X-APPLE-WEBAUTH-PCS-Sharing="xxxxxx";X-APPLE-WEBAUTH-TOKEN="xxxxxx";X-APPLE-WEBAUTH-USER="xxxxxx";X-APPLE-WEBAUTH-VALIDATE="xxxxxx";
- Log in to your Apple account at account.apple.com
- In the Sign-in and Security section, select App-Specific Passwords
- Select Generate App-Specific Password and follow the on-screen instructions
- Copy the generated password and paste it into the
.env
file asICLOUD_APP_PASSWORD
Double-click the executable file to run the tool.
- Open Terminal
- Navigate to the directory containing the executable
- Run
./CursorKeepAlive
This project is created for educational purposes only. The author assumes no responsibility or liability for:
- Any misuse of the code or related materials
- Any damages or legal consequences arising from the use of this project
- The accuracy, completeness, or usefulness of the provided content
By using this project, you agree that you do so at your own risk. This project is not intended for production use and comes with no warranties or guarantees. If you have any legal or ethical concerns, please do not use this repository.
This project would not have been possible without the help of these excellent projects:
If you'd like to contribute to this project, feel free to submit pull requests.
This product is distributed under a proprietary license. You can view the complete license agreement at: CC BY-NC-ND 4.0.