Adblock4limbo: JavaScript and CSS Ad Removal for iOS Proxy Tools

What Adblock4limbo Covers and Who It Is For

Adblock4limbo is an ad-blocking collection started on 2020-11-01 that targets iOS browser users running a proxy tool (Quantumult X, Surge, Shadowrocket, Loon, or Stash) or a userscript manager (Tampermonkey). It removes ads from a maintained list of approximately 30 sites through JavaScript injection and CSS selector rules delivered via MITM (man-in-the-middle) script rewriting.

The site categories covered include Chinese online video platforms (such as CN影视, 剧迷网, 独播库, 欧乐影院, libvio, and 韩剧TV), search engines (Google and Bing content farm results, Baidu image and text ads, Baidu 知道), ACG and manga sites (hitomi, anime1, hanime1, 绅士漫画, 禁漫天堂), and adult video sites (Jable with M3U8 extraction, MissAV, Pornhub, Xvideos, 91porn, and others). The complete maintained list is in the file Adblock4limbo.weblist, which the README says is updated in real time.

For desktop browsers, the README directs PC and Mac users to uBlock Origin, a browser extension, rather than this project. Android users are directed to Firefox with uBlock Origin. Adblock4limbo is therefore specifically a solution for the iOS mobile browser use case where browser extensions are not available and proxy-level injection is the primary mechanism.

How the Blocking Works: MITM and Script Injection

Adblock4limbo works through MITM decryption of HTTPS traffic by the proxy tool. The proxy tool intercepts the page response, the script rewrite rule runs, and Adblock4limbo.js injects ad-blocking CSS selectors and JavaScript into the page before it reaches the browser. This is why the proxy tool must have MitM, Rewrite, and Script enabled, and why the site's domain must be listed in the hostname configuration.

Three JavaScript files make up the blocking layer. Adblock4limbo.js is the rewrite script that inserts the CSS selectors and per-site blocking logic into page responses. Adblock4limbo.user.js is the Tampermonkey userscript version of the same blocking logic for userscript managers. Adblock4limbo.function.js powers the navigation page that can be injected into any site.

The CSS selectors cover generic ad patterns plus site-specific rules. For search engines, the blocking removes not just paid ads but also content farm results (低质内容农场) from Google and Bing result pages. For video sites, the blocking skips or removes pre-roll ad countdowns and popup overlays. The exact scope for each site is visible in the Adblock4limbo.weblist file.

Setting Up in Quantumult X and Surge

For Quantumult X, the setup requires adding two references: a routing list and a rewrite reference. The routing list URL is:

https://limbopro.com/Adblock4limbo.list

The rewrite reference URL is:

https://limbopro.com/Adblock4limbo.conf

After adding these references, configure the MITM certificate if not already done, then clear the browser cache before testing.

For Surge, install the module by navigating to Surge > Home > Modules > Install New Module and pasting:

https://limbopro.com/Adblock4limbo.sgmodule

After module installation, update external resources by going to the configuration list and tapping Update All. Then configure routing: add a new external rule set with the Reject policy and the following URL:

https://raw.githubusercontent.com/limbopro/Adblock4limbo/main/Adblock4limbo_surge.list

The README notes that updating external resources after module installation is a step many users miss. MitM, Rewrite, and Script must be enabled in Surge for the blocking to take effect.

Adding the Navigation and Script to Arbitrary Sites

Beyond the maintained site list, the README documents a method for injecting Adblock4limbo's navigation page and its 18,000+ generic ad-blocking CSS selectors into any site. The approach requires configuring the proxy tool's MITM to decrypt that site's domain and adding a script rewrite rule.

An example configuration from the README for applying the script to BBC News and TED illustrates the pattern:

hostname = www.bbc.com, www.ted.com

The script path to reference in the rewrite rule is:

https://limbopro.com/Adguard/Adblock4limbo.js

The README provides regular expression examples for matching page responses while excluding CSS, JavaScript, video, and font files. Feedback for new site requests can be submitted through GitHub Issues; the README states that valuable site requests are typically handled within 24 hours.

For new issue submissions, the required information is: the site domain, the page URL where ads appear, the ad type (GIF, popup, bottom banner, etc.), and the proxy tool or browser extension being used.

Limitations, Desktop Alternatives, and Maintenance

Adblock4limbo has three hard constraints. First, it requires a running proxy tool on the device: Quantumult X, Surge, Shadowrocket, Loon, or Stash for iOS, or Tampermonkey for any desktop browser. Without one of these, the injection mechanism does not exist. Second, it works only on iOS browsers as the primary target: the README states this scope explicitly and recommends uBlock Origin for desktop and Android.

UBlock Origin is a browser extension for desktop Chrome and Firefox that blocks ads through filter lists without requiring a proxy tool or MITM certificate. It works at the browser level rather than the network level. The fundamental difference in approach is that Adblock4limbo patches site responses at the proxy layer on iOS, while uBlock Origin filters requests and hides elements directly in the browser on desktop.

Third, the project requires ongoing maintenance as sites add new ad formats or change domains. Blocked sites that have changed domain are struck through in the README's table. Users who find ads on a maintained site should check that the external resources are up to date and that the browser cache has been cleared before submitting a report.

The last push was on 2026-09-15. The repository is not archived, and the maintained site list continues to grow through community issue submissions. The license is MIT.

Editorial conclusion

Adblock4limbo is the right choice for iOS users who already run Quantumult X, Surge, or Shadowrocket and want ad blocking for the specific Chinese video sites, search engines, and ACG sites it covers. It is not appropriate for PC or Mac desktop browsers: the README explicitly recommends uBlock Origin for those users. The project has been updated since 2020-11-01 and received its last push on 2026-09-15, indicating ongoing maintenance. The license is MIT.

Frequently asked questions

Official sources

1. Issues
2. License: MIT
3. limbopro/Adblock4limbo on GitHub
4. Project website
5. README