A Swift package and command-line tool for managing Apple apps, including searching, downloading, and authenticating with Apple services.
For a version with a graphical user interface (GUI) and an on-device installer, check out Asspp.
- Authentication: Login and logout from Apple accounts
- Search: Search for apps in the App Store
- Download: Download apps using your Apple account
- Versions: Retrieve version information for apps
- Swift 5.9 or later
- macOS 12+
Clone the repository and run the tool directly:
git clone https://github.com/Lakr233/ApplePackage.git
cd ApplePackage
swift run ApplePackageTool <subcommand>For example:
swift run ApplePackageTool --helpAuthenticate with your Apple account:
applepackage login <email> <password> [--code <2fa-code>]<email>: Your Apple ID email address<password>: Your Apple ID password--code: Optional 2FA verification code
Remove stored credentials for an account:
applepackage logout <email><email>: The email address of the account to logout
Search for apps in the App Store:
applepackage search <term> [--country <country-code>] [--limit <number>]<term>: Search term--country: Country code (default: US)--limit: Maximum number of results (default: 10)
List available versions for an app:
applepackage versions <email> <bundle-id><email>: Your Apple ID email address<bundle-id>: The bundle identifier of the app
Download an app:
applepackage download <email> <bundle-id> [--version-id <version>] --output <path><email>: Your Apple ID email address<bundle-id>: The bundle identifier of the app--version-id: Optional specific version ID to download--output: Output path for the downloaded file
Add ApplePackage as a dependency in your Swift package:
dependencies: [
.package(url: "https://github.com/Lakr233/ApplePackage.git", from: "1.0.0")
]Import and use:
import ApplePackage
// Example: Search for apps
let results = try await Searcher.search(term: "example", countryCode: "US", limit: 10)Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
This tool is for educational and personal use only. Please respect Apple's terms of service and copyright laws when using this software. We are not responsible if your Apple account gets banned or any other issues arise from using this tool.