Make your source

To distribute your apps with iTweakHub you need to first create an AltStore source, which is just a self-hosted JSON file containing basic metadata about your apps.

Last updated 1 month ago

Make your source

To distribute your apps with iTweakHub you need to first create an AltStore source, which is just a self-hosted JSON file containing basic metadata about your apps.

Example Source

Instructions

Source

{
  "name": "My Example Source",
  "identifier": "com.example.MyApps",
  "subtitle": "A source for all of my apps",
  "description": "Welcome to my source! Here you'll find all of my apps.",
  "iconURL": "https://example.com/source_icon.png",
  "headerURL": "https://example.com/source_header.png",
  "website": "https://example.com",
  "tintColor": "#F54F32",
  "featuredApps": [
    "com.example.myapp",
    "com.example.anotherapp"
  ],
  "apps": [],
  "news": [],
}

name (string)

The name of your source as it will appear in iTweakHub.

subtitle (string)

(optional)A short, one-sentence description of your source. This will appear underneath the source's name on its About page.

description (string)

(optional)A full-length description of your source. This can include any information you believe is relevant for your source, such as information about your apps or additional links.

iconURL (string)

(optional)A link to an image that will be used to visually identify your source. It will appear as a circle.If not provided, this defaults to the iconURL of the first app listed in your source.

headerURL (string)

(optional)A link to an image that will be displayed as the header of your source's About page. The image will be blurred by default, but can be viewed by swiping the source's info banner.We recommended using a 3:2 aspect ratio for best results.If not provided, this defaults to your source's iconURL.

website (string)

(optional)A link to the primary website for your source. It will be displayed underneath your source's name on its About page.

tintColor (string)

(optional)A color that will be used to theme your source's About page. We recommend using a color that works well with your source's icon for consistent theming, but you are free to choose any color you want. Black and white tint colors will be automatically adjusted for legibility.This must be in hexadecimal format (e.g #F54F32 or C9B632)If not provided, this defaults to the tintColor of the first app listed in your source.

featuredApps (array of strings)

(optional)An ordered list of app bundleIdentifier's you want featured on your source's About page. Currently, only the first five will be displayed.If not provided, this defaults to the first five apps listed in your source.

apps (array of Apps)

An ordered list of the apps in your source.See Apps section below for more.

news (array of News Item)

A list of the News items in your source. The ordering does not matter because AltStore will display them in reverse chronological order according to their date.See News Items section below for more.

Apps

"apps": [
    {
        "name": "My Example App",
        "bundleIdentifier": "com.example.myapp",
        "developerName": "Example Developer",
        "subtitle": "An awesome app.",
        "localizedDescription": "This is an awesome app only available on iTweakHub.",
        "iconURL": "https://example.com/myapp_icon.png",
        "tintColor": "#F54F32",
        "screenshotURLs": [
            "https://example.com/myapp_screenshot1.png",
            "https://example.com/myapp_screenshot2.png",
            "https://example.com/myapp_screenshot3.png"
        ],
        "versions": [],
        "appPermissions": {},
    },
]

name (string)

The name of your app as it will appear on its store page.

bundleIdentifier (string)

Your app's bundle identifier (CFBundleIdentifier). It is case sensitive and should match exactly what is in your Info.plist.A source cannot have multiple apps with the same bundle identifier.

developerName (string)

The name of the developer or developers as it will appear on the store page.

subtitle (string)

(optional)A short, one-sentence description of your app that will appear in the Browse tab of AltStore.

localizedDescription (string)

A full-length description of your app. This can include any information you believe is relevant for your app, such as feature descriptions or additional links.

iconURL (string)

A link to you app's icon image. It will automatically be masked to an app icon shape.

tintColor (string)

(optional)The color used to theme your app's store page. We recommend using your app's existing tint color (if it has one), but you are free to choose any color you want.This must be in hexadecimal format (e.g #F54F32 or C9B632)

screenshots (array of Screenshots)

(optional)Screenshots of your app. We recommend showcasing your app's main features.Please see the Screenshots section below for detailed info and instructions.

versions (array of App Versions)

A list of all the published versions of your app.Please see the App Versions section below for detailed info and instructionsThe order of versions matters. AltStore uses the order to determine which version is the "latest" release. For more information, see Updating Apps

Screenshots

"screenshots": [ 
    "https://example.com/iphone_portrait_1.png",
    "https://example.com/iphone_portrait_2.png",
]

App Versions

"versions": [
  {
    "version": "1.0",
    "date": "2023-03-30",
    "localizedDescription": "First iTweakHub release!",
    "downloadURL": "https://myapp.com/myapp-1.0.ipa",
    "size": 79821,
    "minOSVersion": "12.0",
    "maxOSVersion": "16.3"
  },
]

version (string)

Your app's version number (CFBundleShortVersionString). It is case sensitive and should match exactly what is in your Info.plist.

date (string)

The release date for this version.This should be in ISO 8601 format (e.g. 2023-2-17 or 2023-02-17T12:00:00-06:00)

localizedDescription (string)

(optional)A description of what's new in this version. You can use this to tell users about new features, bugs fixes, etc.

downloadURL (string)

The URL where your .ipa is hosted.

minOSVersion (string)

(optional)The minimum iOS version supported by this release. AltStore will hide any updates that are not supported by the user's device.

maxOSVersion (string)

(optional)The maximum iOS version supported by this release (inclusive). AltStore will hide any updates that are not supported by the user's device.

News Items

"news": [
  {
    "title": "New Feature Announcement",
    "identifier": "new_feature",
    "caption": "Introducing a new feature in iTweakHub!",
    "date": "2023-03-15",
    "tintColor": "#F54F32",
    "imageURL": "https://example.com/new_feature_image.png",
    "notify": true,
    "url": "https://example.com/new_feature_details",
    "appID": "com.example.myapp"
  },
]

title (string)

The title of your News item.

identifier (string)

A unique value to distinguish this News item from others in your source.A source cannot have multiple News items with the same identifier.

caption (string)

A short, one-sentence description of your News item.

date (string)

The publishing date for this News item.This should be in ISO 8601 format (e.g. 2023-2-17 or 2023-02-17T12:00:00-06:00)

tintColor (string)

(optional)The background color for your News item.This must be in hexadecimal format (e.g #F54F32 or F65432)

imageURL (string)

(optional)A link to the image you want featured with your News item.This will be scaled to fill a 67:40 aspect ratio.

url (string)

(optional)A link that AltStore should open when the News item is tapped. Links will be opened in an in-app web browser.

appID (string)

(optional)The bundle identifier of an associated app. This will make the app's info banner appear below the News item, which will open the app's Store page when tapped.

Last updated 1 month ago

Example Source

Instructions

Source

{
  "name": "My Example Source",
  "identifier": "com.example.MyApps",
  "subtitle": "A source for all of my apps",
  "description": "Welcome to my source! Here you'll find all of my apps.",
  "iconURL": "https://example.com/source_icon.png",
  "headerURL": "https://example.com/source_header.png",
  "website": "https://example.com",
  "tintColor": "#F54F32",
  "featuredApps": [
    "com.example.myapp",
    "com.example.anotherapp"
  ],
  "apps": [],
  "news": [],
}

name (string)

The name of your source as it will appear in iTweakHub.

subtitle (string)

(optional)A short, one-sentence description of your source. This will appear underneath the source's name on its About page.

description (string)

(optional)A full-length description of your source. This can include any information you believe is relevant for your source, such as information about your apps or additional links.

iconURL (string)

(optional)A link to an image that will be used to visually identify your source. It will appear as a circle.If not provided, this defaults to the iconURL of the first app listed in your source.

headerURL (string)

website (string)

(optional)A link to the primary website for your source. It will be displayed underneath your source's name on its About page.

tintColor (string)

featuredApps (array of strings)

apps (array of Apps)

An ordered list of the apps in your source.See Apps section below for more.

news (array of News Item)

Apps

"apps": [
    {
        "name": "My Example App",
        "bundleIdentifier": "com.example.myapp",
        "developerName": "Example Developer",
        "subtitle": "An awesome app.",
        "localizedDescription": "This is an awesome app only available on iTweakHub.",
        "iconURL": "https://example.com/myapp_icon.png",
        "tintColor": "#F54F32",
        "screenshotURLs": [
            "https://example.com/myapp_screenshot1.png",
            "https://example.com/myapp_screenshot2.png",
            "https://example.com/myapp_screenshot3.png"
        ],
        "versions": [],
        "appPermissions": {},
    },
]

name (string)

The name of your app as it will appear on its store page.

bundleIdentifier (string)

Your app's bundle identifier (CFBundleIdentifier). It is case sensitive and should match exactly what is in your Info.plist.A source cannot have multiple apps with the same bundle identifier.

developerName (string)

The name of the developer or developers as it will appear on the store page.

subtitle (string)

(optional)A short, one-sentence description of your app that will appear in the Browse tab of AltStore.

localizedDescription (string)

A full-length description of your app. This can include any information you believe is relevant for your app, such as feature descriptions or additional links.

iconURL (string)

A link to you app's icon image. It will automatically be masked to an app icon shape.

tintColor (string)

screenshots (array of Screenshots)

(optional)Screenshots of your app. We recommend showcasing your app's main features.Please see the Screenshots section below for detailed info and instructions.

versions (array of App Versions)

Screenshots

"screenshots": [ 
    "https://example.com/iphone_portrait_1.png",
    "https://example.com/iphone_portrait_2.png",
]

App Versions

"versions": [
  {
    "version": "1.0",
    "date": "2023-03-30",
    "localizedDescription": "First iTweakHub release!",
    "downloadURL": "https://myapp.com/myapp-1.0.ipa",
    "size": 79821,
    "minOSVersion": "12.0",
    "maxOSVersion": "16.3"
  },
]

version (string)

Your app's version number (CFBundleShortVersionString). It is case sensitive and should match exactly what is in your Info.plist.

date (string)

The release date for this version.This should be in ISO 8601 format (e.g. 2023-2-17 or 2023-02-17T12:00:00-06:00)

localizedDescription (string)

(optional)A description of what's new in this version. You can use this to tell users about new features, bugs fixes, etc.

downloadURL (string)

The URL where your .ipa is hosted.

minOSVersion (string)

(optional)The minimum iOS version supported by this release. AltStore will hide any updates that are not supported by the user's device.

maxOSVersion (string)

(optional)The maximum iOS version supported by this release (inclusive). AltStore will hide any updates that are not supported by the user's device.

News Items

"news": [
  {
    "title": "New Feature Announcement",
    "identifier": "new_feature",
    "caption": "Introducing a new feature in iTweakHub!",
    "date": "2023-03-15",
    "tintColor": "#F54F32",
    "imageURL": "https://example.com/new_feature_image.png",
    "notify": true,
    "url": "https://example.com/new_feature_details",
    "appID": "com.example.myapp"
  },
]

title (string)

The title of your News item.

identifier (string)

A unique value to distinguish this News item from others in your source.A source cannot have multiple News items with the same identifier.

caption (string)

A short, one-sentence description of your News item.

date (string)

The publishing date for this News item.This should be in ISO 8601 format (e.g. 2023-2-17 or 2023-02-17T12:00:00-06:00)

tintColor (string)

(optional)The background color for your News item.This must be in hexadecimal format (e.g #F54F32 or F65432)

imageURL (string)

(optional)A link to the image you want featured with your News item.This will be scaled to fill a 67:40 aspect ratio.

url (string)

(optional)A link that AltStore should open when the News item is tapped. Links will be opened in an in-app web browser.

appID (string)

(optional)The bundle identifier of an associated app. This will make the app's info banner appear below the News item, which will open the app's Store page when tapped.