๐๏ธ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 versionsha256
parameter lets AltStore verify downloaded .ipa's have the correct SHA-256 hashappPermissions
parameter declares all permissions used by an app and its extensionsmarketingVersion
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
forOperationError.appNotFound
Enforces consistent minimum size for
PillButton
Updates
AppViewController
to useUINavigationBarAppearance
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 warningFixed "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 1000AltServer.ServerError
codes start at 2000AltStore.AppleDeveloperError
codes start at 3000Uses underlying error messages (if available) for several
AltServer.ServerError
errorsEncodes/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 messagesAlways 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โ buttonFixed โ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