AdOchi: A Free, Open-Source Ad & Scam Blocker That Beats YouTube's Black Screen
TL;DR: AdOchi is a free, open-source (GPL-3.0) ad, tracker and scam blocker for Android and for Chrome, Edge, Brave, Opera and Firefox. Most blockers now cause YouTube's black screen. AdOchi doesn't block YouTube's ads.
TL;DR: AdOchi is a free, open-source (GPL-3.0) ad, tracker and scam blocker for Android and for Chrome, Edge, Brave, Opera and Firefox. Most blockers now cause YouTube's black screen. AdOchi doesn't block YouTube's ads. It lets them load, then plays them muted, invisible and at 16ร speed, so a 15-second ad is over in about one second. It also blocks 370,000+ scam and phishing domains, and it runs fully on your device. There's no account and it has no servers of its own.
Last updated: November 2026 ยท AdOchi v1.3
Quick facts
| What it is | An ad, tracker and scam blocker |
| Platforms | Android app, plus a browser extension for Chrome, Edge, Brave, Opera and Firefox |
| Price | Free |
| License | GNU GPL v3.0 |
| Ad and tracker list | 210,000+ domains |
| Scam, phishing and malware list | 370,000+ domains |
| Data collected | None: no account, no analytics, no servers of its own |
| Tech | Kotlin + Jetpack Compose (Android), Manifest V3 declarativeNetRequest (extension) |
| Made by | x8code, Karachi, Pakistan |
sami-hussain-dev
/
AdOchi
Free, open-source ad, tracker & scam blocker for Android and Chrome/Edge/Brave/Firefox. Blocks ads in apps, games & browsers, removes Facebook/YouTube ads and stops phishing sites. 100% on-device, no account. Made by x8code.
AdOchi
Free ad, tracker and scam blocker for Android and every major browser.
YouTube without ads and without the black screen. Facebook without sponsored posts. Scam sites stopped before they load.
No account. No servers. Nothing leaves your device.
Download (one click)
Each button downloads the newest version straight away. How to install ยท All releases
Why AdOchi?
In 2025โ2026 YouTube started punishing ad blockers. When a blocker deletes the ads from the player's data, the video sits on a black screen with a spinning circle for as long as the ad would have run, or it never starts at all. That's why many blockers suddenly stopped working.
For signed-in viewers YouTube went further: "Ad blockers violate YouTube's Terms of Service. Video playback is blocked". It looks for blocked ad requests, hidden ad boxes, ads jumped to their end and Skip buttons pressed by a script.
AdOchi givesโฆ
The problem: ad blockers started breaking YouTube
In 2025 and 2026, YouTube started fighting back against ad blockers. The usual approach is to block ad requests or delete the ads from the player's data. That now backfires:
- The video sits on a black screen with a spinner for as long as the ad would have run.
- Sometimes it never starts at all.
- Signed-in users can get "Ad blockers violate YouTube's Terms of Service. Video playback is blocked."
YouTube looks for four signals: blocked ad requests, hidden ad boxes, ads that jump straight to their end, and Skip buttons clicked by a script. A blocker that does any of these can get caught.
So I took a different approach.
The fix: let the ad load, and don't let anyone see it
On YouTube, AdOchi blocks nothing and hides no ad boxes in the player. The ad loads as normal. Then AdOchi:
- mutes it,
- makes it invisible (
opacity: 0on the ad's video), and - plays it at 16ร, the top speed browsers allow.
A 15-second ad is gone in about a second. YouTube sees an ad that loaded and played to the end, because that's what happened.
Measured in Chrome on the same videos (November 2026)
| Setup | Before the video starts |
|---|---|
| No blocker | 6 s + 66 s of ads |
| Blockers that delete YouTube's ad data | 8โ10 s black screen (some signed-in users say it never starts) |
| AdOchi 1.3 | No black screen. Ads muted, hidden and played at 16ร. With no ad, the video starts at once |
The interesting part: keeping the ad fast when YouTube resets it
The hard part wasn't speeding the ad up. It was keeping it sped up. YouTube's player sets an ad back to 1ร and turns the sound on when it starts, and again between the ads in a break. In version 1.2 that meant some ads played at normal speed.
Version 1.3 wraps the playbackRate and muted setters on HTMLMediaElement.prototype. While an ad runs, the player's writes are stored instead of applied. When the player reads the values back, it gets exactly what it wrote. So the player is happy, and the ad stays at 16ร and silent.
Here's a simplified version of the idea:
// While an ad runs, AdOchi owns the <video>'s speed.
// YouTube's player can still "set" it: we store the value and
// return it when the player reads it back, so it only sees its own values.
const held = new WeakMap(); // video -> { want: { playbackRate, muted } }
const d = Object.getOwnPropertyDescriptor(HTMLMediaElement.prototype, 'playbackRate');
Object.defineProperty(HTMLMediaElement.prototype, 'playbackRate', {
configurable: true,
enumerable: d.enumerable,
get: new Proxy(d.get, {
apply: (target, video, args) =>
held.has(video) ? held.get(video).want.playbackRate
: Reflect.apply(target, video, args),
}),
set: new Proxy(d.set, {
apply: (target, video, args) => {
if (!held.has(video)) return Reflect.apply(target, video, args);
held.get(video).want.playbackRate = +args[0]; // remember it, don't apply it
},
}),
});
Why Proxy and not a plain function? A proxied native function still reports function () { [native code] } when you call toString() on it. To the page, the getter and setter look untouched.
A few more details from the real code (cleaner.js):
-
Speed fallback: it tries
[16, 10, 8, 4, 2]and uses the fastest rate the browser accepts. - No seeking, no clicks: YouTube ignores scripted clicks on Skip, and an ad that jumps to its end is easy to spot. So AdOchi does neither.
- Your settings come back: when the break ends, your own speed (for example 1.5ร) and your sound settings return.
- Safe mode: if YouTube still refuses to play, AdOchi notices. It steps back from YouTube for 6 hours and reloads the video, so the video always plays.
The same cleaner.js is shared by the Android app's built-in browser and the browser extension, so both get the fix.
What AdOchi does: features
๐ฑ Android app
| Feature | What it does |
|---|---|
| ๐ซ Blocks ads in every app, browser and game | A local DNS filter with 210,000+ ad and tracker domains |
| โถ๏ธ Clean Browser | YouTube, Facebook, Instagram, TikTok and X without video ads or sponsored posts |
| ๐ง Background play | YouTube keeps playing with the screen off. Pause / Next / Close sit in the notification |
| ๐ก๏ธ Scam, phishing and malware blocking | 370,000+ domains, plus an alert that names the app that tried to open one |
| ๐ Phone scan | Finds apps that can read your SMS/OTPs, control your screen (Accessibility), act as device admin or hide their icon |
| ๐ฌ Message checks | Share any WhatsApp or SMS message to AdOchi to check its link |
| ๐ Privacy report and time saved | Shows which apps try to track you and how much ad time you got back |
| ๐ฎ Ad-free offline games | Cuts the internet for games that don't need it |
| โ๏ธ More | Default-browser mode, Quick Settings tile, DNS-over-HTTPS, Private DNS light mode, weekly report, and home-screen shortcuts for YouTube (no ads) and Facebook (no ads) |
Why not inside the official YouTube and Facebook apps? Those apps load ads from the same servers as your videos and feed. No DNS blocker can remove those ads without breaking the app. Instead, open YouTube and Facebook inside AdOchi. The home-screen shortcut makes that one tap.
๐งฉ Browser extension (Chrome, Edge, Brave, Opera, Firefox)
-
Fast blocking: it uses the same ad, tracker and scam lists. The browser runs them itself through Manifest V3
declarativeNetRequest, with no slow JavaScript filtering. - YouTube with no black screen, and Facebook without sponsored posts or video ad breaks.
- Time-saved counter. Share it on WhatsApp, X or Facebook in one tap.
- Popup controls: see what was blocked on this page, pause on one site, and turn each list on or off.
๐ก๏ธ Scam protection that people actually need
Fake ads and scam links are one of the main ways people lose their bank logins and OTP codes. When you open a known scam, phishing or malware site, AdOchi shows a warning page instead of the site:
How it works under the hood
On Android, AdOchi uses Android's VpnService to run a local DNS tunnel. Nothing goes to a remote VPN server. When an app looks up a domain, AdOchi checks it against the blocklists on the device. Blocked domains get no answer. Allowed lookups go to the public DNS resolver you choose, over DNS-over-HTTPS if you turn it on.
In the browser, the build script turns the same blocklists into declarativeNetRequest rules. The browser enforces them natively, which is fast and fits Manifest V3.
The build has safety checks. It never blocks a list of essential sites, whatever a blocklist says. That list includes Google, Facebook, WhatsApp, YouTube, Pakistani banks and wallets, and government sites. The build fails if a core ad network is missing from the lists.
app/ Android app (Kotlin, Jetpack Compose)
src/main/java/com/adochi/
core/ blocklists, filter engine, link inspector, phone scanner, stats
vpn/ local DNS tunnel, DNS-over-HTTPS, Quick Settings tile
browser/ Clean Browser (WebView), background play, scam warning page
guard/ Message Guard (full flavor)
ui/ screens and components
src/main/assets/ cleaner.js (shared with the extension), media.js, built-in lists
extension/
src/ manifest, background, popup, warning page
tools/build.mjs list download + rule generation + packaging
test/e2e.mjs real-browser test in headless Chrome
Install AdOchi in 1 minute
Android
- On your phone, download AdOchi.apk.
- Open the file. If Android asks, allow "Install unknown apps" for your browser.
- Open AdOchi and tap the big button. Android asks once to allow the VPN. That's the local filter, and nothing goes to any server.
Chrome, Edge, Brave and Opera
- Download AdOchi-Extension-Chrome-Edge-Brave.zip and unzip it.
- Open
chrome://extensions(Edge:edge://extensions, Brave:brave://extensions). - Turn on Developer mode.
- Click Load unpacked and pick the folder that has
manifest.jsondirectly inside it.
Firefox
- Download AdOchi-Extension-Firefox.zip.
- Open
about:debugging#/runtime/this-firefox, click Load Temporary Add-on and pick the ZIP.
Store listings for the Chrome Web Store and Firefox Add-ons are on the way. Until then, use the steps above.
Build it from source
Android (JDK 17+, Android SDK with compileSdk 36):
./gradlew assembleDirectDebug # debug build
./gradlew testDirectDebugUnitTest # unit tests
node app/src/test/js/cleaner_test.js # page-cleaner checks
There are two product flavors. direct is the APK to share. full adds automatic Message Guard through notification access.
Browser extension (Node.js 20+):
node extension/tools/build.mjs # download lists, build Chrome + Firefox, zip them
node extension/tools/build.mjs --cached # rebuild from lists downloaded earlier
node extension/test/e2e.mjs chrome # test blocking, warning page and popup in headless Chrome
Privacy: what leaves your device?
Nothing, unless you tap Share.
- Blocklists download straight from their public sources.
- Allowed DNS lookups go to the public resolver you choose.
- Messages are checked offline and never stored.
- Time saved is counted on your device.
There's no account, no analytics and no AdOchi server. The code is GPL-3.0, so you can check every line yourself.
FAQ
What is AdOchi?
AdOchi is a free, open-source ad, tracker and scam blocker for Android and for the Chrome, Edge, Brave, Opera and Firefox browsers. It's made by x8code, a software house in Karachi, Pakistan.
Is AdOchi free?
Yes. AdOchi is completely free and open source under the GNU GPL v3.0 license. It has no paid tier, no ads and no account.
How does AdOchi block YouTube ads without the black screen?
It doesn't block them. It lets YouTube's ads load, then plays them muted, invisible and at 16ร speed. YouTube sees an ad that played normally, so it doesn't show the black screen or the "playback is blocked" message.
Does AdOchi work inside the official YouTube and Facebook apps?
No. Those apps load ads from the same servers as your content, so no blocker can remove them there safely. Open YouTube and Facebook inside AdOchi's Clean Browser instead. A home-screen shortcut makes it one tap.
Why does the Android app ask for VPN permission?
Android only lets an app filter DNS for the whole phone through its VpnService API. AdOchi uses it for a local filter on your phone. Your traffic isn't sent to any VPN server.
Does AdOchi collect my data?
No. AdOchi has no account, no analytics and no servers of its own. Blocklists come from public sources, and messages are checked offline and never stored.
Does AdOchi work with Manifest V3?
Yes. The browser extension is built on Manifest V3 and uses declarativeNetRequest, so it works in current Chrome, Edge and Brave.
Which blocklists does AdOchi use?
HaGeZi DNS blocklists, OISD, AdGuard DNS filter, StevenBlack hosts, Phishing Army and malware-filter. Each list keeps its own license. Big thanks to their maintainers.
Help AdOchi grow ๐
If AdOchi saves you time, or saves someone you know from a scam link:
- โญ Star the repo on GitHub. It's the main way other people find it.
- ๐ค Share your "time saved" from the popup.
- ๐ Did an ad get through? Open an issue with the site and what you saw.
- ๐ ๏ธ PRs are welcome, especially for new ad-break wordings and scam patterns in your language.
I'd love feedback from the dev.to community. What's the most annoying ad or scam you've run into lately? Tell me in the comments ๐
Built by **Muhammad Sami Hussain, Founder & Lead Software Engineer at x8code, a software house in Karachi, Pakistan.
Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes โ full credit and traffic to the original publisher.

