Skip to content

Repository files navigation

Version MIT License Manifest V3 32 Languages 35+ Tools

Clify Logo

Clify (Formerly Zap)

YouTube, Uncluttered.
Free, open-source YouTube blocker with 5-layer ad blocking, Shorts removal, SponsorBlock, audio equalizer, age-gate bypass, and 35+ focus tools. Manual install, 100% private.

Landing Page · Download · Product Hunt


Features

5-Layer Ad Blocker

uBlock Origin-level protection built specifically for YouTube.

  • Layer 1: declarativeNetRequest — 593+ static filter rules (412 ad domains + 181 YouTube ad URL patterns)
  • Layer 2: DOM removal — Scans every 600ms for 238 ad selectors across 15 categories
  • Layer 3: Network interception — fetch/XHR hook with 135 ad domains + 29 regex URL patterns
  • Layer 4: Scriptlet injection — Anti-adblock bypass, ad detection flag overrides, nag popup blocking
  • Layer 5: Procedural cosmetic filtering — Text-content-based element hiding + 227 remote cosmetic selectors

Remote filter lists — On install, Clify syncs clify-filters.txt (uBlock Origin / AdGuard style): 1,272 network rules + 227 cosmetic selectors, refreshed every 12 hours with a bundled offline fallback. No manual updates required.

Shorts Remover

Completely removes YouTube Shorts from your feed, sidebar, search results, and dedicated tab. Reclaims your attention from algorithmic short-form content.

SponsorBlock Integration

Skips sponsored segments, intros, outros, highlight reels, and filler with community-powered data.

  • 3-URL fallback chain for reliability
  • Smart outro detection with progress bar visualization
  • Verified segment preference and segment merging
  • Default ON — works out of the box

Audio Equalizer

5-band Web Audio API equalizer with real-time control.

  • Bands: 60Hz (bass), 250Hz, 1kHz, 4kHz, 12kHz (treble)
  • 9 presets: Flat, Bass Boost, Treble Boost, Vocal, Rock, Electronic, Classical, Podcast, Custom
  • Per-band sliders (-12dB to +12dB) in the dashboard
  • Gains persist across sessions

Age-Gate Bypass

Automatically bypasses age verification screens, consent dialogs, and "Sign in to confirm" prompts. Clicks proceed buttons, removes overlays, and force-shows the video player.

Live Stream Cleaner

Hide distracting elements during live streams.

  • Hide live chat panel
  • Hide Super Chat donations
  • Hide member badges and tickers
  • All toggles independently configurable

Channel Manager

Block or allow specific channels with full-screen visual overlays on both search results and watch pages.

  • Add by channel name, URL, or channel ID
  • Intelligent search with extractChannelIdFromInput()
  • Normalized comparison for consistent matching
  • Block counter badge on the extension icon

Keyword Manager

Filter videos by title content with advanced matching.

  • One keyword per line or comma-separated
  • Pipe | for synonyms: movie|film|cinema|picture
  • Supports 32 languages simultaneously
  • 5,000+ keywords supported
  • Crown icon badge in the help section

Watch Later Queue

Queue videos for later viewing with a built-in playlist manager.

Scheduled Blocking

Set custom time-based schedules for when blocking is active. Focus mode during work hours, relaxed mode on weekends.

Content Density Meter

Analyzes video metadata to calculate a quality score. Rolling 20-video window tracks your consumption patterns with color-coded badges (green/yellow/red).

Monetization Badge

Detects channel monetization status using 7 detection methods. Displays a filled pill badge with SVG icon directly on video thumbnails.

Language Block

Blocks content in specific languages using Unicode script detection (22 scripts + Latin) with title-only filtering fallback.

Picture-in-Picture Button

Native-styled PiP toggle button injected into the YouTube player controls. Uses Tabler icon SVG with 2-second re-inject interval for reliability.


Dashboard

Tabbed interface with 4 sections:

  • Dashboard — Stats overview, daily/weekly blocking charts, time saved, channel scores
  • Blocked — Sub-tabs for Videos, Channels, Keywords, and Watch Later management
  • Protection — Sub-tabs for Ad Blocker config, More Features (Shorts, SponsorBlock, Age-Gate, Live Stream, PiP), and Language blocking
  • Stats — Usage statistics with weekly activity chart

Features:

  • Dark/light theme (neutral black #0a0a0f dark, solid white light)
  • All settings auto-save to chrome.storage.sync
  • 32-language translation system with RTL support
  • Tabler Icons bundled locally (no CDN)

Internationalization

Full UI translation in 32 languages: English, Spanish, French, German, Italian, Portuguese, Arabic, Hindi, Bengali, Chinese (Simplified & Traditional), Japanese, Korean, Russian, Turkish, Polish, Dutch, Vietnamese, Indonesian, Malay, Swedish, Norwegian, Danish, Finnish, Czech, Romanian, Ukrainian, Hebrew, Swahili, Tamil, Telugu, Thai, Greek.


Downloads

Version Chrome / Chromium (MV3) Firefox
v17.0.0 (latest) clify-v17.0.0-chrome.zip clify-v17.0.0-firefox.zip / clify-firefox-v17.0.0.xpi

Both builds share the same v17.0.0 codebase and features. The Chrome build uses the Chromium MV3 API (chrome.*), the Firefox build uses the WebExtensions API (browser.*) for full AMO compatibility.

Installation

Manual Install (Chrome / Chromium)

  1. Download clify-v17.0.0-chrome.zip
  2. Extract the ZIP file
  3. Open chrome://extensions/
  4. Enable Developer mode (top right toggle)
  5. Click Load unpacked and select the extracted folder
  6. Pin the extension and open the dashboard

Firefox / Firefox Android

  1. Download clify-firefox-v17.0.0.xpi (or the clify-v17.0.0-firefox.zip for manual loading)
  2. Open about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on and select the manifest.json from the extracted ZIP
  4. For permanent install, submit the XPI to addons.mozilla.org

Android (Kiwi Browser / Quetta Browser)

  1. Download clify-v17.0.0-chrome.zip on your phone
  2. Extract using a file manager
  3. Open Kiwi or Quetta Browser → chrome://extensions/
  4. Enable Developer mode → Load unpacked → select the folder
  5. Browse YouTube with full Clify support

Supported Browsers

Chrome, Edge, Brave, Opera, Vivaldi, Arc, Kiwi, Quetta, Firefox, Firefox Android, Yandex, Samsung Internet, Ungoogled Chromium, Thorium, and all other Chromium-based browsers.


Project Structure

Clify 21 C/                  # Chrome / Chromium build (MV3, chrome.* API)
├── manifest.json          # Manifest V3 configuration
├── background.js          # Service worker, declarativeNetRequest rules, notifications, remote filter sync
├── content.js             # YouTube content script (ad blocker, features, DOM manipulation)
├── clify-filters.txt      # Remote filter list (1,272 network rules + 227 cosmetic selectors, uBO/AG style)
├── dashboard.html         # Dashboard UI (4 tabs, 32 language blocks)
├── dashboard.css          # Dashboard styles (dark/light theme, glassmorphism)
├── dashboard.js           # Dashboard logic, settings persistence, i18n system
├── attribution.js         # Developer attribution
├── ownership.js           # Ownership verification
├── icons/                 # Extension icons (16x16 to 128x128)
├── fonts/                 # Bundled Tabler Icons fonts
├── tabler-icons.min.css   # Tabler Icons stylesheet (local, no CDN)
├── logo.png               # Custom logo
├── vendor/                # Third-party dependencies
├── admin/                 # Admin panel
├── DEVELOPER.txt          # Developer info
├── LEGAL.md               # Legal notices
└── PRIVACY.md             # Privacy policy

Clify 21 C Firefox/         # Firefox build (WebExtensions, browser.* API, AMO-ready)
├── (same structure, browser.* API)

Privacy

Clify respects your privacy:

  • Local processing — All keyword matching and blocking happens in your browser
  • No telemetry — Zero analytics, tracking, or data collection
  • No servers — All data stored in chrome.storage.local / chrome.storage.sync
  • Open source — Fully transparent codebase, audit anytime
  • Optional newsletter — Email signup is completely separate and optional

Tech Stack

Component Technology
Platform Chrome Extension (Manifest V3, chrome.*) + Firefox WebExtensions (browser.*)
Ad Blocking declarativeNetRequest + DOM removal + fetch/XHR interception + scriptlet injection + remote uBO/AG filter lists (12h auto-refresh)
Audio Web Audio API (5 BiquadFilterNode bands)
SponsorBlock REST API with 3-URL fallback chain
UI Framework Vanilla JS, CSS Custom Properties
Icons Tabler Icons (bundled locally)
Fonts Inter + JetBrains Mono (Google Fonts)
Notifications Telegram Bot API (opt-in)

Contributing

We welcome contributions:

  • Code — Fix bugs, add features, improve performance
  • Translations — Help translate to more languages (32 supported, room for more)
  • Testing — Report bugs with steps to reproduce
  • Design — Improve UI/UX, suggest new features
  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test on YouTube with the extension loaded
  5. Submit a pull request

Changelog

Version Highlights
v17.0.0 uBO/AG-level ad-block expansion (593+ DNR rules, 238 DOM selectors, 412 ad domains), remote filter lists (1,272 network + 227 cosmetic, 12h auto-refresh), Fake Channel Block (16 handles + 61 patterns + custom list), YouTube toast notifications, Support Ticket System (global + per-user IDs, system diagnostics)
v16.0.0 Age-Gate Bypass, Audio Equalizer (5-band, 9 presets), Live Stream Cleaner, custom logo, footer tooltip morph animation
v15.0.0 Sub-tabs in Blocked & Protection tabs, Usage Stats redesign, Watch Later empty state, Mojibake encoding fixes
v14.0.0 Content Density Meter, Monetization Badge, Language Block (22 scripts), PiP Button, Channel blocking overlays
v13.0.0 uBlock Origin-level ad blocker upgrade (180+ selectors, 120+ domains, scriptlet injection)
v12.0.0 Dashboard tab merger (8→4), SponsorBlock improvements (3-URL fallback, smart outro), Dashboard settings persistence
v11.0.0 Changelog redesign (timeline), Product Hunt badge, Usage Stats charts
v10.0.0 Live Stream Cleaner config, Keyword Pack badge, Footer restructured
v9.0.0 Notification system (Telegram), Admin panel, Channel Manager visual redesign
v8.0.0 Tabler Icons bundled locally, BOM fix, Dark/Light theme refinement

License

MIT License — do whatever you want.


Credits

Built with:


Made by Dipto Design Studio

About

Ads? Gone. Shorts? Gone. Clickbait? Gone. YouTube? Fixed.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages