repository·main·Indexed 26 days ago
https://github.com/majd/ipatoolA command-line tool for searching the App Store and downloading encrypted iOS and tvOS app packages (.ipa files). It provides functionality to authenticate with an Apple ID, search for apps by term, obtain app licenses, list available versions, and retrieve version metadata.
You can install ipatool using Homebrew on macOS or by downloading the latest binary manually from the GitHub releases page.
$ brew install ipatoolYou can compile ipatool using the Go toolchain.
To build the binary:
go build -o ipatoolTo run tests:
go test -v github.com/majd/ipatool/...```
```shell
$ go build -o ipatoolThe Args struct is used to configure the NewClient constructor.
| Field | Type | Description |
|---|---|---|
CookieJar | CookieJar | An implementation of the CookieJar interface used for managing session cookies. |
Use the auth command to manage your App Store credentials. This is required to search for and download apps.
Commands:
login: Login to the App Store.info: Show current account info.revoke: Revoke your App Store credentials.Global Flags:
--format <format>: Set output format to text or json (default: text).--non-interactive: Run in non-interactive session.--verbose: Enable verbose logs.Use the purchase command to obtain a license for a specific app from the App Store.
Flags:
-b, --bundle-identifier <string>: Bundle identifier of the target iOS app (required).Use the search command to find iOS and tvOS apps by a search term.
Flags:
-l, --limit <int>: Maximum amount of search results to retrieve (default: 5).--platform <string>: Platform to search: iphone, ipad, or appletv.Use the get-version-metadata command to retrieve metadata for a specific version of an app using its external version identifier (returned by list-versions).
Flags:
-i, --app-id <int>: ID of the target iOS app (required).-b, --bundle-identifier <string>: The bundle identifier of the target iOS app (overrides the app ID).--external-version-id <string>: External version identifier of the target iOS app (required).Use the download command to download encrypted iOS and tvOS app packages.
Flags:
-i, --app-id <int>: ID of the target iOS app (required).-b, --bundle-identifier <string>: The bundle identifier of the target iOS app (overrides the app ID).--external-version-id <string>: External version identifier (defaults to latest version if not specified).-o, --output <string>: The destination path of the downloaded app package.--platform <string>: Platform to download for: iphone, ipad, or appletv.--purchase: Automatically attempt to obtain a license for the app if needed.Use the list-versions command to see which versions of an iOS app are available for download.
Flags:
-i, --app-id <int>: ID of the target iOS app (required).-b, --bundle-identifier <string>: The bundle identifier of the target iOS app (overrides the app ID).--keychain-passphrase <string>: Passphrase for unlocking keychain.*http.Request and *http.Response objects directly without the automatic unmarshaling provided by Send, use the Do method. This method uses the client's internal configuration, including the CookieJar and Transport.Client[R] interface provides a Send method to execute high-level requests. It handles payload serialization, header injection, cookie persistence, and automatic unmarshaling of the response into the generic type R based on the ResponseFormat specified in the Request object.NewRequest method is a helper on the Client interface to create a standard *http.Request object. It is a wrapper around http.NewRequest.