๐Ÿ›๏ธAltStore Classic

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

Last updated