A collection of ad-blocking and premium-unlocking plugins for Loon, an advanced network tool for iOS.

• Available Plugins
• Features
• Requirements
• Installation
• How These Plugins Work
• Troubleshooting
• Updates
• Star History
• Disclaimer
• License
• Author

• 🚫 Blocks the main mobile ad networks (AdMob, Meta Audience Network, AppLovin, Unity Ads, Vungle, InMobi, Mintegral, Pangle and others)
• 🔒 Rule-based only, no MITM or certificate required
• ⚠️ Note: Loon applies plugin rules to all traffic, so these ad networks are blocked in every app
• ✅ Facebook login keeps working

• 🚫 Remove playback, Home, Search and scroll advertisements
• 🧹 Optional switches to hide the discovery feed on the Now Playing screen, the membership info and the AI DJ entry
• ⚙️ Local protobuf override by default (Premium configuration snapshot chosen by app version: 9.1.76+ or older, with the ad, upsell and capping flags fixed afterwards), also on the configuration and account attribute refreshes introduced by app 9.1.98; remote modification available as an alternative switch
• ⚠️ Note: Audio quality cannot be set to "Very High"

• 🚫 Block ads in the feed, search results (including the pages loaded while scrolling), Shorts and player
• ⏯️ Optional background playback
• 🌍 Translate existing subtitle tracks to zh-CN or en-US
• 🙈 Hide the Shorts shelf from the Home feed or from every feed and search results
• 🧭 Hide the Shorts tab and the Create button from the bottom bar
• 🚷 Manual or remote channel blocklist, with optional hourly refresh of the remote list
• 🔍 Built-in logging tool for troubleshooting

• 🔓 Unlock SoundCloud Go+ premium features
• 🎵 Access to premium-only tracks and content
• 🧹 Optionally removes the Upgrade tab and the "listen without ads" badge

• 🚫 No ads in the card stack, Explore and match list
• 🙈 Hides the Gold/Platinum upsell modals, tooltips and merchandising cards
• 🎬 The rewarded video that grants extra likes keeps working
• ⚠️ Premium features are not unlocked: likes, Rewind, Passport and Likes You are enforced by the server

Removes the ads from the Home timeline of the X (Twitter) web app: x.com opened in Safari or added to the Home Screen as a web app. It filters the HomeTimeline and HomeLatestTimeline GraphQL responses and drops the entries X marks as promoted.

• Removes promoted posts (entries whose id starts with promoted, or that carry promotedMetadata), including promoted items inside conversation modules.
• Removes the carousel modules X uses for multi-card ads (optional, on by default).
• Optional: hide the "Who to follow" suggestions and the message prompts.
• Cursors and paging instructions are never touched, so infinite scroll keeps working. Responses without ads are passed through untouched.
• MITM on x.com only.
• The native X app is not supported: it pins its certificates on api.x.com and api.twitter.com and refuses the Loon certificate, so its traffic can neither be inspected nor modified. Verified on real captures.

The script is tested against anonymized fixtures: run npm test from the repository root.

• iOS device with Loon installed (version 3.2.6 or newer, 3.5.1 or newer for the YouTube and Spotify plugins)
• QUIC fallback protection enabled in Loon settings
• MITM enabled with a trusted certificate for Spotify, YouTube, SoundCloud and Tinder
• Not supported on tvOS devices
• For Spotify: log in again after enabling the plugin

1. Make sure you have Loon installed (v3.2.6+)
2. Enable QUIC fallback protection in Loon settings
3. Click on the download link for the desired plugin:
   • Badoo AdBlock Plugin
   • Spotify Plugin
   • YouTube Plugin
   • SoundCloud Plugin
   • Tinder AdBlock Plugin
4. Loon will prompt you to add the plugin - confirm by tapping "Add Plugin"
5. For YouTube and Spotify, you can configure plugin settings in the Loon app
6. Restart the respective app
7. Wait a few moments for the plugin to take effect

These plugins use various techniques to enhance your app experience:

• Rule-based blocking: Rejects connections to ad networks at the domain level
• URL Rewriting: Blocks ad requests and modifies network responses
• Script Injection: Modifies app behavior to enable premium features
• MitM (Man-in-the-Middle): Intercepts and modifies traffic securely
• Header Manipulation: Bypasses restrictions by modifying request headers

Badoo AdBlock Plugin Issues:

• If ads still appear, force-close and reopen Badoo
• Some sponsored content served from Badoo's own domains cannot be blocked without MITM

Spotify Plugin Issues:

• Log in again after enabling the plugin
• Enable only one of the two protobuf scripts, not both
• Restart the app and wait a few minutes for changes to take effect
• Some premium features may still be unavailable (e.g., very high audio quality)
• After a Spotify update, update the plugin in Loon too: the configuration snapshot follows the app version

YouTube Plugin Issues:

• Make sure MITM is enabled and the Loon certificate is trusted
• If ads still appear, try clearing the app cache or reinstalling YouTube
• Background playback requires enabling "Background App Refresh" for YouTube
• Use the built-in logging tool to collect diagnostics

SoundCloud Plugin Issues:

• Restart the app after installing the plugin
• Some region-restricted content may still be unavailable

Tinder AdBlock Plugin Issues:

• Force-close Tinder and reopen it so the configuration is fetched again
• Check that MITM is active for api.gotinder.com
• Like limits and Gold features stay as they are: they are enforced by Tinder's servers

Check back regularly for updates to existing plugins and new additions to the collection.

The YouTube scripts are built from readable sources:

• src/YouTube/request.js and src/YouTube/response.js are the sources, with section comments.
• Scripts/YouTube/*.min.js are generated with terser: run npm install once, then npm run build from the repository root after every change to the sources.
• Never edit the minified files by hand: the header of each one carries the SHA-256 of the source it was built from.

These plugins are for personal use only. Use at your own risk. The developer is not responsible for any issues that may arise from using these plugins, including but not limited to account restrictions or app functionality.

The plugins are not affiliated with Badoo, Spotify, YouTube, SoundCloud, Tinder, or their parent companies in any way.

MIT License

devchristian1337

Made with ❤️ for the Loon community