You should have following items before using this tool:
- An apple account (with @icloud.com as suffix) with iCloud Plus
- 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 the tool.
Mac User: If you are not able to rename the file, you can use
touch .env
to create the file in the same directory as executable file.
- 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
- Navigate to iCloud settings in your browser and log in
- Click on the Cookie-Editor extension and export cookies with
Header String
format - Paste the exported cookies into a file named
.env
asICLOUD_COOKIES
Example Cookie:
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”;
- Sign in to your Apple Account on account.apple.com
- In the Sign-In and Security section, select App-Specific Passwords.
- Select Generate an app-specific password, then follow the steps on your screen.
- Copy the generated password and paste it into a file named
.env
asICLOUD_APP_PASSWORD
Double-click the executable file to run the tool.
- Open Terminal
- Navigate to the directory where the executable file is located
./CursorKeepAlive
This project is created solely for educational purposes. The author(s) do not assume any responsibility or liability for:
- Any misuse of the code or related materials.
- Any damages or legal implications arising from the use of this project.
- The accuracy, completeness, or usefulness of the provided content.
By using this project, you agree that you are doing so at your own risk. This project is not intended for use in production environments, and no warranties or guarantees are provided. If you have any legal or ethical concerns, please refrain from using this repository.
This project can't be done without the help of these amazing projects:
If you want to contribute to this project, please feel free to open a pull request.
This product is distributed under a proprietary license. You can review the full license agreement at the following link: CC BY-NC-ND 4.0.