🛍️AltStore Classic

AltStore 2.2

April 16, 2025

New

• Supports sideloading apps with “Increased Memory Limit” entitlement

• Supports localized titles, subtitles, and descriptions in sources

• Added `altstore-classic://` URL scheme

• Added Bluesky social media button to Settings

Improved

• Hides “See All” button in Browse tab for sources with just 1 app

• Changed icon back to Classic icon by default

• Uses separate Patreon API token from AltStore PAL to improve rate-limiting

• Changed Patreon URL back to direct link

• Replaced hardcoded API keys with dynamically-loaded ones

• Switches to classic linker to silence “no platform load command found” warnings

Fixed

• Fixed choosing alternate app icon on iPad

• Fixed “Join Patreon” sheet appearance in dark mode

• Fixed installing apps before adding source via deep link

• Fixed handling source deep link when already viewing source details

• Fixed redundant app update appearing after resigning expired app

• Fixed not immediately showing updates for some installed apps

• Fixed not showing OPEN for installed apps when previewing source via deep link

• Fixed not showing OPEN for installed apps when previewing already-added Recommended Source

AltStore 2.0.2

November 21, 2024

• Fixed App IDs collection view assertion crash on iOS 18

• Fixed My Apps tab collection view assertion crash on iOS 18

• Fixed "Handshake Failed" error when signing-in

AltStore 2.0.1

November 13, 2024

• Added dark mode & tinted variants of primary app icon

• Added new Home Screen quick actions with support info

• Fixed crash when fetching source containing app larger than 2GB

• Delays fetching Friend Zone patrons until user first opens Patreon screen

• Fixed handling Patreon rate limit errors

• Fixed crash updating apps when there is more than 1 update available

AltStore 2.0

September 28, 2024

New

Sources

• Add any 3rd-party source, in addition to existing Recommended Sources!

• New dedicated Sources tab to easily manage and browse sources

• Separate "Add Source" screen to simplify adding sources

• Preview sources before adding them to AltStore

  • View detailed information as well as any additional links

  • Browse all apps and news for a source

  • "Featured Apps" section showcases a source's best apps

• Supports remote blocking malicious sources

Redesigned Browse Tab

• New "card" design for app listings

• View most recently updated apps at a glance

• Browse apps by source or by 8 new categories

• Scroll through featured apps from each source

• Change sort order of apps when browsing by source or category

• Tap category name to easily switch between categories when browsing

• Swipe through all screenshots directly from Browse tab

Patreon

• 3rd-party sources can now distribute Patreon-exclusive apps to patrons, including free members

• Donate to developers' Patreons and download Patreon-exclusive apps all within AltStore

• Supports "custom" pledge amounts so patrons can donate what they want

• Shows required pledge amount for Patreon apps (if provided)

App Icon

• Brand new app icon

• Choose alternate app icons in Settings

Detailed App Permissions

• View all entitlements and privacy permissions for an app from its store page

• Tap any permission to view a detailed description

• Automatically verifies permissions are accurate before installing

• Asks user to review permissions when installing and updating apps

  • When installing a new app, all entitlements will be shown

  • When updating an app, only added entitlements will be shown

Source JSON

• Supports JSON5

• buildVersion parameter allows distributing multiple builds with same app version

• sha256 parameter lets AltStore verify downloaded .ipa's have the correct SHA-256 hash

• appPermissions parameter declares all permissions used by an app and its extensions

• marketingVersion parameter allows customizing the version displayed to the user

Misc.

• Added social media follow buttons to Settings

• Handles “search” and “view app” deep links

  • Search: altstore://search?q=[query]

  • View App: altstore://viewApp?bundleID=[app bundle ID]

Improved

Screenshots

• Supports screenshots of different sizes

• Supports both iPhone and iPad specific screenshots

• Automatically rounds screenshots taken with Face ID iPhone

• Preview screenshots full-screen by tapping them from an app's store page

• Dismiss full-screen screenshots with swipe gesture

App Verification

• Verifies downloaded app version matches source

• Verifies downloaded app build version matches source

• Verifies downloaded app’s permissions match source

• Verifies downloaded .ipa matches SHA-256 hash (if provided)

Source Verification

• Verifies source's identifier doesn't change after refreshing

• Verifies source’s identifier doesn’t match existing sources when adding

• Verifies all privacy permissions have a valid usageDescription

• Throws error when adding marketplace source to non-marketplace AltStore (and vice versa)

• Includes missing last Coding Path value for DecodingError.keyNotFound

• Deprecates identifier key

News Tab

• Changed image aspect ratio to 3:2

• Updated font to use dynamic text styles

• Uses uniform height for all News Items on source's detail page

Logging

• Switched to OSLog.framework for important tasks

• Export detailed logs via Error Log from Settings tab

Image Caching

• Increased cache limit to reduce how often AltStore refetches images

• Clear image cache with “Clear Cache…” option in Settings

Misc.

• Limits relative dates to "Today" and "Yesterday"

• Changed "WiFi" spelling to "Wi-Fi"

• Displays version # for updates in My Apps tab

• Replaced AppCenter dependency with TelemetryDeck

• Added Privacy manifest

• Updated Patreon sign-out alert message to apply to all pledged apps

• Rethrows Core Data save errors after installing apps

• Captures #fileID and #line for OperationError.appNotFound

• Enforces consistent minimum size for PillButton

• Updates AppViewController to use UINavigationBarAppearance APIs

Fixed

Resigning Apps

• Fixed various issues resigning certain apps

• Fixed app sometimes freezing when installing/refreshing apps

• Fixed resigning apps with entitlements the original app doesn’t have

• Fixed resigning apps without required entitlements

• Fixed resigning apps with wildcard `keychain-access-groups` entitlement

• Fixed resigning apps with non-English alphanumeric characters in name

User Interface

• Fixed Settings tab bar disappearing on iOS 18

• Fixed squished banners on App IDs screen

• Fixed button titles flashing when scrolling into view

• Fixed incorrect corner radius animation for app + source detail screens

• Fixed "More" button appearing by accident if text height exactly equals collapsed height

• Fixed not showing "more updates" button when there are more than 2 updates

• Fixed erroneously showing “Unsupported Updates Available” message

• Fixed showing “Update” button on app store page when no supported update is available

• Fixed incorrect cell height for some News items

• Fixed missing blur when pushing AppViewController onto modal navigation controller

Misc.

• Fixed crash when adding source with the same name as another source

• Fixed “Core Data error” if error occurs while parsing Source JSON

• Fixed redundant app update appearing after failing to backup/restore app

• Fixed not showing toast view if error occurs during initial sources fetch

• Fixed incorrectly handling various cancelled operations

• Fixed error fetching Friend Zone patrons due to unexpected nil name

• Fixed incorrectly merging app versions for same app from different sources

• Fixed migration error on launch if AltStore app group does not exist

• Fixed "missing app group" error if AltStore app group is not the first one listed in Info.plist

• Fixed accidentally saving "Operation Cancelled" errors to Error Log

• [iPad] Fixed crash when removing apps from My Apps tab

• Fixed CollapsingTextView “TextKit 1 compatibility mode” runtime warning

• Fixed "transformable properties not using secure transformer" runtime warnings

• Fixed "unsatisfiable constraints" runtime error for InstalledAppsCollectionFooterView

AltStore 1.7

September 18, 2023

New

"Active Apps" Widget (iOS 17+)

• View remaining days for ALL active apps from Home Screen

• Refresh apps directly from home screen by tapping countdown timers

Improved

Shortcuts Support

• Converted existing "Refresh Apps" shortcut into App Shortcut

• Available by default in "App Shortcuts" section of Shortcuts app

• Displays accurate progress when refreshing apps via Shortcuts app

Widgets

• Updated existing home screen widget to support refreshing apps by tapping countdown (iOS 17+)

• Explicitly reloads widget timelines on app launch

Fixed

• Fixed updating apps with manually-removed app extensions (e.g. uYou+)

• Fixed not refreshing AltStore last when refreshing via Shortcut

• Fixed race condition causing duplicate background refresh notifications (or none)

• Fixed Error Log not displaying all detailed info for certain errors

AltStore 1.6.3

April 12, 2023

• Fixed error fetching Friend Zone patrons due to unexpected nil name

• Fixed incorrect cell height for some News items

AltStore 1.6.2

March 22, 2023

• Fixed “no provisioning profile with the requested identifier…” error when sideloading and refreshing apps

AltStore 1.6.1

February 20, 2023

• “Clear Cache” button removes temporary files and deleted app backups to free up disk space

• Disable new “Enforce 3-App Limit” setting to sideload more than 3 apps via MacDirtyCow exploit*

• Fixed crash when viewing Sources on iOS 12

*Requires iOS 14.0 - 16.1.2 (excluding 15.7.2). iOS 16.2 or later not supported.

AltStore 1.6

January 30, 2023

New

Lock Screen Widget (iOS 16 only)

• Counts down days until AltStore expires

• Available in 2 different styles: “text” and “icon”

Error Log

• View past errors in more detail

• Tap an error to copy the error message or error code

• Search for error code directly in AltStore FAQ

• “View More Details” button to view detailed error information

• Access via new “Techy Things” section in AltStore settings

iOS Version Compatibility

• Supports app updates with minimum or maximum OS requirements

• Hides app updates if they’re not compatible with current device

• Falls back to downloading last compatible version on older devices

• View all unsupported updates from My Apps tab

Revamped Error Handling

• Completely revamped error handling to include as much information as possible, which should make debugging certain issues much easier

• Revised error messages to be more descriptive and provide more suggestions

• Revised error domain format to [Module].[ErrorType]

• AltStore.OperationError codes start at 1000

• AltServer.ServerError codes start at 2000

• AltStore.AppleDeveloperError codes start at 3000

• Uses underlying error messages (if available) for several AltServer.ServerError errors

• Encodes/Decodes all Codable user info values, not just recognized types

Misc.

• Adds pull-to-refresh to check for updates

• Supports new “versions” key in source JSON

• Supports updating apps from app detail page

Improved

Source Validation

• Verifies sources don't contain duplicate app bundle identifiers

• Verifies sources don't contain duplicate app versions

• Shows error if a source is configured incorrectly instead of silently failing

Misc.

• Updated LaunchViewController error alert to display more detailed error messages

• Always displays loading indicator when fetching Friend Zone patrons

• Improves error message when .ipa does not exist at provided downloadURL

• Caches MergeErrors when refreshing sources to view later from Sources page

Fixed

• Fixed CollapsingTextView incorrectly showing “more” button

• Fixed “error migrating persistent store” issue

• Fixed widgets potentially not updating after refreshing apps

• Fixed simultaneous database access from multiple AltStores

• Fixed incorrect app name and iOS version in "Unsupported iOS version" error message

• Fixed refreshing tweaked apps with removed app extensions

• Fixed error encoding CodableError Int/UInt user info values

• Fixed adding failures to NSErrors with nil localizedFailureReasons

• Fixed incorrect error toast view color when sign-in fails

AltStore 1.5.1

July 14, 2022

• Fixed signing in with Apple IDs that contain capital letters

• Fixed signing in with Apple IDs that have 2FA enabled but don’t have any registered trusted devices

• Fixed repeatedly asking some users to sign in every time they refresh their apps

• Fixed “Application is missing application-identifier” error when sideloading or (de-)activating certain apps

• Fixed “Incorrect Apple ID or password” error after changing an Apple ID’s primary email address

• Fixed crash when receiving unknown error codes from AltServer

AltStore 1.5

May 6, 2022

New

Trusted Sources

• Download and update certain third party apps entirely through AltStore

• Add Trusted Sources directly from the new Sources page

• Trusted Sources are sources we’ve explicitly approved because they meet our safety standards

• Support for adding any source by URL will be coming later

AltJIT

• Allows sideloaded apps to use Just-in-Time (JIT) compilation

• Long-press an app in My Apps, then choose “Enable JIT” – a few seconds later you should see an AltStore notification saying “Successfully Enabled JIT”

  • Your device must be on the same WiFi network as AltServer or connected to your computer via USB

• JIT will remain enabled until the app is quit from the app switcher or purged from memory in the background

• Requires iOS 14 or later

• Requires AltServer 1.5 or later

Improved

• Supports landscape app screenshots

• Adds Shane to credits and Patreon screen

• Prefetches & caches Friend Zone patrons to offset the Patreon API’s slow response time

Fixed

• Fixed a potential crash when sideloading certain apps

• Fixed some apps having access to AltStore’s app group after being (de-)activated

• Fixed crash when adding or removing sources that have News items

• Fixed Core Data error when not connected to internet due to saving non-NSSecureEncoding items from NSError’s userInfo