Apollo-ImprovedCustomApi (v2)

iOS tweak for Apollo for Reddit app that lets you continue using Apollo with your own API keys after its shutdown in June 2023. The tweak also unlocks several Ultra features and includes several enhancements and fixes.

Features

General

• Use Apollo with your own Reddit and Imgur API keys (don't have one?)
• Customizable redirect URI and user agent
• Fully working Imgur integration (view, delete, upload single and multi-image albums)
• Native Reddit image upload support
• Liquid Glass UI enhancements for iOS 26
• Suppress wallpaper popups and in-app announcements
• Pixel Pals support on newer iPhone models
• Reddit /s/ share links support
• Image viewer and video playback fixes and enhancements
• Proxy Imgur images through DuckDuckGo for regional blocks
• Deep linking support for Steam, YouTube Shorts
• Auto-collapse pinned comments

Unlocked Ultra Features and Easter Eggs

• New Comments Highlightifier
• Saved Categories
• App Icons + Wallpapers (Community Icon Pack, SPCA Animals, Ultra Icons, "sekrit" app icons)
• Pixel Pals (including hidden "Artificial Superintelligence")
• Themes (including hidden "Chumbus" theme)

New Features

• Backup & Restore: Export and import Apollo and tweak settings as a .zip
• Custom Subreddit Sources: Use external URLs for random and trending subreddits
• Recently Read Posts: View all recently read posts from the Profile tab
• Editable Saved Categories: Add, rename, and delete saved post categories (Settings > Saved Categories)
• Bulk in-place translation: Translate posts and comments in-place with configurable provider and target language (Settings > Translation)
• Tap timestamp for creation date: Tap a comment or post's relative-time label to see the absolute creation date and time
• Tag Filters: Blur NSFW and/or Spoiler posts (including titles) in feeds, with per-subreddit overrides (Settings > Tag Filters)
• Inline Media Previews: Render images, GIFs, videos, and Imgur albums inline within posts and comments (Settings > Custom API > Media > Inline Media Previews)
• User Profile Pictures: Show Reddit user avatars next to usernames in feeds, comments, and user profiles (Settings > Custom API > Media > Show User Profile Pictures)

Known Issues

• Long-tapping share links open in the in-app browser
• Native Reddit multi-image and video uploads are not yet supported

Safari integration

I recommend using the Open-In-Apollo userscript to automatically open Reddit links in Apollo.

Looking for IPA?

One source where you can get the fully tweaked IPA is Balackburn/Apollo.

Don't have an API key?

Important

Reddit and Imgur no longer allow new API key creation so you'll need to share or use existing keys.

See this guide for workarounds (proceed at your own risk).

When using credentials from another app, set the Reddit API Key (OAuth client ID), Redirect URI, and User Agent in the tweak settings to match the app's values. You'll also need to register the redirect URI scheme in the IPA (see below).

More discussion in #82.

Custom Redirect URI

The redirect URI scheme (the part before ://) must be registered in the Apollo IPA's Info.plist under CFBundleURLTypes, otherwise the OAuth callback won't return to Apollo. Add your scheme with patch.sh or the Patch IPA GitHub Action:

./patch.sh Apollo.ipa --url-schemes custom

Resulting Info.plist entry:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>twitterkit-xyz</string>
      <string>apollo</string>
      <string>custom</string> <!-- enables custom://reddit-oauth -->
    </array>
  </dict>
</array>

Patching IPA

patch.sh and the Patch IPA GitHub Action apply optional patches to a stock Apollo IPA. They do not inject the tweak - use Sideloadly or build-ipa.sh for that.

./patch.sh <path_to_ipa> [--liquid-glass] [--url-schemes <schemes>] [--remove-code-signature] [-o <output>]

Available patches:

• --liquid-glass - enables the iOS 26 Liquid Glass UI and installs a pack of Liquid Glass icons that can be switched between in the tweak's in-app icon picker.
• --url-schemes <list> - adds comma-separated URL schemes to CFBundleURLTypes (see Custom Redirect URI).
• --remove-code-signature - strips the existing code signature.

To run via GitHub Actions, fork this repo and trigger Actions > Patch IPA. The IPA source can be a direct URL or a release artifact from your fork.

Sideloadly

Recommended configuration:

• Use automatic bundle ID: unchecked (e.g. com.foo.Apollo)
• Signing Mode: Apple ID Sideload
• Inject dylibs/frameworks: checked - add the .deb via +dylib/deb/bundle
  • Cydia Substrate: checked
  • Substitute / Sideload Spoofer: unchecked

Build Injected IPA Locally

build-ipa.sh builds the tweak .deb and injects it into a stock Apollo IPA. Requires azule or cyan installed locally; signing/sideloading is still handled by your preferred signer.

make package
./build-ipa.sh --ipa ./Apollo.ipa [--deb ./packages/<tweak>.deb] [-o ./packages/Apollo-Tweaked.ipa]

Build

Requirements:

• Theos

Instructions:

1. git clone https://github.com/JeffreyCA/Apollo-ImprovedCustomApi
2. cd Apollo-ImprovedCustomApi
3. git submodule update --init --recursive
4. make package or make package THEOS_PACKAGE_SCHEME=rootless for rootless variant

Credits

• Apollo-CustomApiCredentials by @EthanArbuckle
• ApolloAPI by @ryannair05
• ApolloPatcher by @ichitaso
• GitHub Copilot and Claude Code