youTube_ads_4_pi-hole

<div align="center">

# 🚫 YouTube Ads Blocklist for Pi-hole

**A community-maintained list of YouTube ad-serving domains — add one link to Pi-hole and you're done.**

<!-- Status badges: change the text/colour when something changes. update.ps1 rewrites the date automatically. -->
![Blocking status](https://img.shields.io/badge/blocking-working-brightgreen?style=for-the-badge)
![List updated](https://img.shields.io/badge/list%20updated-Nov%209th%202026-blue?style=for-the-badge)
![Pi-hole v5 and v6](https://img.shields.io/badge/Pi--hole-v5%20%7C%20v6-96060c?style=for-the-badge&logo=pihole&logoColor=white)

<!-- Plain-text copy of the badge facts so search engines and AI assistants can read them. update.ps1 keeps it current. -->
Last updated: **Nov 9th 2026** - **16,110 domains** in the list - works with **Pi-hole v5 and v6**, **AdGuard Home**, **pfBlockerNG**, **Technitium** and any other DNS blocker that accepts a hosts-style domain list.

[![PayPal](https://img.shields.io/badge/PayPal-donate-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/KBoghdady?locale.x=en_US)
[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/xmh7j53o1)

</div>

---

## 📋 Table of contents

- [Option 1 · Add the list to Pi-hole (recommended)](#-option-1--add-the-list-to-pi-hole-recommended)
- [Option 2 · Run the script](#-option-2--run-the-script)
- [Other DNS blockers (AdGuard Home, pfBlockerNG, Technitium, Blocky)](#-other-dns-blockers-adguard-home-pfblockerng-technitium-blocky)
- [What it does and doesn't do](#-what-it-does-and-doesnt-do)
- [How it works](#-how-it-works)
- [The crowd list (optional)](#-the-crowd-list-optional)
- [Troubleshooting](#-troubleshooting)
- [Privacy](#-privacy)
- [Contributing](#-contributing)
- [Support the project](#-support-the-project)

---

## ⚡ Option 1 · Add the list to Pi-hole (recommended)

The easiest way — nothing to install. Pi-hole downloads the list itself and refreshes it every time gravity updates.

1. Open the Pi-hole web interface → **Lists** (Pi-hole v6) or **Group Management → Adlists** (Pi-hole v5).
2. Paste this address into the **Address** field and click **Add**:
   ```
   https://raw.githubusercontent.com/kboghdady/youTube_ads_4_pi-hole/refs/heads/master/youtubelist.txt
   ```
3. Update gravity so the list takes effect: **Tools → Update Gravity**, or from the terminal:
   ```bash
   pihole -g
   ```

That's it. Pi-hole re-downloads the list on every gravity update (weekly by default — run `pihole -g` any time to get the latest version sooner). The published list already excludes everything in `ignore.list`, so videos keep playing.

> 💡 Using Pi-hole's default blocklist (StevenBlack hosts)? It blocks `s.youtube.com`, which breaks video playback. Allow it once:
> ```bash
> pihole allow s.youtube.com      # Pi-hole v6
> pihole -w s.youtube.com         # Pi-hole v5
> ```

---

## 🧰 Option