Asspp README

The project's README from github.com/Lakr233/Asspp. As one markdown file: 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.

简体中文 🇨🇳

Preview

✨ Why Asspp?

📥 Installation

iOS

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

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

macOS

  1. Download the latest .zip from Releases.

  2. Unzip and move Asspp.app to your Applications folder.

  3. First Run and Trusting the App (Recommended):

    1. 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.
    2. 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.
    3. 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

🚨 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:

  1. Widespread usage triggering Apple's risk control mechanisms.
  2. Protocol modifications following the patching of an iCloud security vulnerability.
  3. 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:

  1. Protect your GUID: Please treat your device GUID as a highly sensitive password. Never share or leak it to anyone.
  2. 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.

Sponsor

LookInside helps you inspect a running iOS or macOS app UI from your Mac.


Copyright © 2025 Lakr Aream. All Rights Reserved.

Fable 5 Verified

Asspp (Lakr233/Asspp)

ios-app
Searching Database…

What is this?Asspp is a client app that lets you manage multiple Apple IDs across different App Store regions, so you can browse, search, and download apps from any country's store without logging out and switching system accounts.
Is this installed on my phone or is it a tool I run on a computer?It's a native app you install directly on iOS or macOS, not a desktop tool that talks to your phone remotely.
How do I install it on iOS or Mac?On iOS, either fork the repo for auto-build-and-sign with your own certificate (gives a permanent OTA link), or manually download the .ipa from Releases and sign it with SideStore, AltStore, TrollStore, etc. On macOS, download the .zip from Releases, unzip, move Asspp.app to Applications, then right-click and choose Open to bypass Gatekeeper's unverified-developer warning.
Do I need an Apple ID to use this?Yes, an Apple ID is required because the app communicates directly with Apple's App Store APIs.
Is it safe to use my main Apple ID with this?No — the README strongly advises against using your primary Apple ID, since a ban could potentially trigger an unremovable Activation Lock on your device; it also warns to never leak your device GUID. The underlying protocol could also stop working again at any time due to Apple's tightening restrictions.
What OS versions does it need?It requires iOS 17.0 or later, or macOS 15.0 or later.
Is there a licensing catch?It's MIT licensed with no stated restrictions beyond the standard MIT terms.
Can I download old versions of an app, not just the latest?Yes, Asspp lets you find and download history versions of an app, not just the current release.
Why might Apple's download protocol stop working someday?Asspp uses the same protocol as ipatool, and the author speculates past outages were caused by heavy usage triggering Apple's risk controls, iCloud security patches, or stricter gateway traffic validation — if it breaks again, a fix might not be possible.
Is this an official Apple product?No, it is explicitly unaffiliated with Apple and is described as being for educational and research purposes only, used at your own risk.
Can IPAs downloaded through Asspp be used for sideloading?Yes, it downloads official, signed IPAs directly from Apple's servers, which can be used for backup or sideloading.
Creator
Lakr233
Size
10.6 MB
Stars
6K
Age
2y
Commits · 90 Days