Veteris

How to setup a custom Veteris backend

Last updated: 02/02/2025

This guide explains how to set up and use the Difteris server with Veteris 1.7.2.

The github for this project can be found here.

Prerequisites:

Ensure you have the following installed:

• Python 3
• Libraries: Flask, Pillow, packaging
• .NET Core 3.1 or higher (required for IPA Sorter).

Run the command below to install all python libraries.

pip install Flask Pillow packaging

Part 1: Difteris Server Setup

Step 1: Download the Server Files

Download the Difteris server files and place them in your desired directory.

Step 2: Prepare IPA Files

1. Place all IPA files in the "New_IPAs" folder.

2. Run IPASorter.exe via the command line.

3. Processed IPAs will be categorised into folders based on their minimum iOS requirements. Any failed apps will be moved to the "incomplete" folder.

Example folder structure:

Example of processed ipa file name:

Step 3: Index IPAs

Run "1_Index_New_IPAS.py":

- Enter the name for the category you want the apps you are scanning to be put under.

- Specify whether you want the IPAs moved automatically. If selected, the folder structure static/ipas/(Category Name) will be created if it doesn’t already exist and the ipas will be moved.

Step 4: Index IPA Icons

Run "2_Index_IPA_Icons.py":

- This script scans all new IPAs and retrieves their icons. If an icon isn’t found, a placeholder image is used.

- Icons are stored in static/icons and named using the IPA’s bundle ID.

Step 5: Start the Server

Run 3_Difteris_Server.py:

- The server will run on port 5010 (this cannot currently be changed, as the tweak only modifies the IP).

Adding More IPAs

To add additional IPAs to new or existing categories, repeat Steps 2, 3, and 4. For existing categories, ensure you type the category name exactly.

Part 2: Veteris Client Setup

Step 1: Downgrade Veteris

Use Cydia’s downgrade option or uninstall Veteris, then download and install the .deb file from here.

Step 2: Install Veteris Redirect

- Install from the github repository at VeterisRedirect/packages/com.notdbrand.veterisredirect_1.7.2-4+debug_iphoneos-arm.deb.

- Add my cydia repo and install it from there.

- Alternatively, compile it yourself using Theos.

Step 3: Configure Veteris Redirect

1. Open Settings and navigate to Veteris Redirect.

2. Enter the IP address or URL of your server. (Do not include http:// or the port number.)

Step 4: Apply the Tweak

1. Click the back button.

2. Re-enter the tweak page to ensure the address is saved. Simply hitting respring won’t save the address (most of the time).

3. Now hit the respring button.

Enjoy!

You should now be able to start Veteris, which will connect to your server.

Additional Resources

If I missed something or there is an issue somewhere, email me. ([email protected])