geczy/ipa-bot

ipa-bot is a Telegram bot that allows users to request and decrypt iOS apps from the App Store. It provides a convenient way to download and decrypt IPA files, making them available for installation on devices.

IPA Bot

This is a Telegram bot for downloading and decrypting iOS app files (.ipa).

Prerequisites

To run this bot, make sure you have the following software installed:

• Node.js (version >= 19.0.0, < 20.0.0)
• Yarn package manager
• Jailbroken iPhone on iOS 16
  • OpenSSH with root login access
  • Frida run frida-server -D on the device
  • AppSync Unified

Installation

1. Clone this repository:

   git clone https://github.com/geczy/ipa-bot.git

2. Navigate to the project directory:

   cd ipa-bot

3. Install the dependencies:

   yarn install

   a. You'll need to install mongosh manually by visiting their page and following their instructions: https://www.mongodb.com/docs/mongodb-shell/install

4. Rename the .env.example file to .env:

   mv .env.example .env

5. Open the .env file and provide the necessary values for the environment variables.

Usage

To start the bot, run the following command:

yarn start

The bot will connect to Telegram and start listening for commands.

Available Commands

The following commands are available for interacting with the IPA Bot:

• /request <App Store URL>: Downloads and decrypts the iOS app specified by the provided App Store URL. The decrypted app file will be uploaded to the chat.
• /reboot: Restarts the bot. This command is only available to administrators specified in the ADMIN_IDS environment variable.
• /delete <App Store URL>: Deletes the app information and files associated with the provided App Store URL from the database and file system. This command is only available to administrators specified in the ADMIN_IDS environment variable.

Please make sure to provide valid App Store URLs when using the /request and /delete commands.

Note: The bot can only process one app download or deletion request at a time. If there is already an ongoing request, additional requests will be added to a queue and processed in order once the previous request is completed.

Running into errors while requesting an app?

You will need to install MongoSH if you haven't already. You can follow their tutorial here: https://www.mongodb.com/docs/mongodb-shell/install

There may also be some other packages that you need to manually install. In order to see a detailed error message, you can run the bash script that you see in your Terminal upon requesting an app. It should look something like this:

bash ./src/bash-decryptor/download-ipa.sh 1137397744 us 0123456789 ''

From here, you'll recieve an error message indicating what the issue is.

License

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

Credits

This project uses the following dependencies:

• ipatool - A tool for working with iOS app packages (.ipa).
• bagbak - A tool for decrypting encrypted iOS app packages (.ipa).

Contributing

Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please create an issue or submit a pull request.

ipa-bot's Issues

sha

Need a little bit of help with usage (err: Decryption process closed)

Hey, I was hesitant to make an issue for this but I've been trying to troubleshoot and get things working but can't seem to figure this one issue out.

I have the Telegram bot all setup, yarn & node are installed, and so is everything else (Frida, AppSync, and OpenSSH is available with root). My iPhone X is on 16.1.2 and is jailbroken with palera1n.

When I run the command /request <app link> I run into this issue:

For my first time setting everything up, I used Windows 11. However for my second time I tried using Ubuntu on WSL-2 with no luck either (same issue on both Windows and WSL).

If you need any more information, feel free to ask and I'll provide.

Can this only be deployed on a local server?

Can I deploy it on vps?

syntax error near unexpected token `}'

Hi, I get an error when I run the following command

bash ./src/bash-decryptor/download-ipa.sh 1137397744 us 0123456789 ''

error

./src/bash-decryptor/download-ipa.sh: line 278: syntax error near unexpected token }' ./src/bash-decryptor/download-ipa.sh: line 278: }'