📄 README.md

Asspp

The Ultimate Multi-Region App Store Manager.

Asspp is a powerful client designed for users who need to manage multiple Apple IDs across different countries and regions. Switch stores instantly, download apps from anywhere, and manage your IPA library—all without logging out of your device.

简体中文 🇨🇳

✨ Why Asspp?

🌍 Multi-Region Access: Browse and search the US, Japan, China, or any other App Store region seamlessly. No more switching system accounts just to check an app.
👥 Multi-Account Support: Add unlimited Apple IDs. Asspp automatically uses the correct account for the store you are browsing.
📦 IPA Management: Download official, signed IPAs directly from Apple's servers for backup or sideloading.
⏪ History Versions: Need an older version of an app? Asspp makes it easy to find and download previous releases.
📱 Cross-Platform: Native experience on both iOS and macOS.

📥 Installation

iOS

Option 1: Auto-Build & Sign (Recommended)

Fork this repository to automatically build and sign the app with your own developer certificate. This gives you a permanent OTA installation link that stays up-to-date with the latest changes.

👉 Setup Guide

Option 2: Manual Install

Download the latest .ipa from Releases.
Sign and install using your preferred tool (e.g., SideStore, AltStore, TrollStore, or other signing service).

macOS

Download the latest .zip from Releases.
Unzip and move Asspp.app to your Applications folder.
First Run and Trusting the App (Recommended):

Try double-clicking to open the app. If you see "App can’t be opened because the developer cannot be verified" or a similar message:

In Finder, locate Asspp.app, Control-click (or right-click) the app and choose Open, then click Open again in the dialog. This will create a one-time trust exception for the app.

If Control-clicking does not work or the app is still blocked:

Open System Settings -> Privacy & Security (or System Preferences -> Security & Privacy on older macOS). In the General/Security section, look for the blocked app and click Open Anyway or Allow. You may need to enter an administrator password.

Recommendation: Download from this repository's Releases and verify the release details to ensure the source is trusted before trusting and opening the app.

> These steps follow macOS Gatekeeper practices and help minimize security risks while allowing you to run unsigned or self-signed apps.

🛠 Requirements

iOS: iOS 17.0 or later.
macOS: macOS 15.0 or later.
Apple ID: Required to communicate with App Store APIs.

🚨 Special Notice

Asspp utilizes the same underlying communication protocol as ipatool. According to community speculation (unverified), previous outages of this protocol were likely caused by:

Widespread usage triggering Apple's risk control mechanisms.
Protocol modifications following the patching of an iCloud security vulnerability.
Adjustments to Apple's front-end gateways, which now enforce stricter traffic allocation and request validation.

Given the increasingly strict management of these APIs, if the protocol becomes invalid again in the future, this project may not be able to provide further fixes.

⚠️ Important Security Warnings:

Protect your GUID: Please treat your device GUID as a highly sensitive password. Never share or leak it to anyone.
Do NOT use your primary Apple ID: We strongly advise using a secondary or burner account with this tool. If your account is banned by Apple, it could potentially result in an unremovable Activation Lock on your device (while there are no confirmed cases of this happening yet, we cannot make any guarantees).

⚠️ Disclaimer

This project is for educational and research purposes only. It is not affiliated with Apple Inc. Use at your own risk.

🥰 Acknowledgments

ipatool-ios and localhost.direct are no longer used in the project.

📄 License

MIT License. See LICENSE for details.