• Option 1 · Add the list to Pi-hole (recommended)
• Option 2 · Run the script
• Other DNS blockers (AdGuard Home, pfBlockerNG, Technitium, Blocky)
• What it does and doesn't do
• How it works
• The crowd list (optional)
• Troubleshooting
• Privacy
• Contributing
• Support the project

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:

   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:

pihole allow s.youtube.com      # Pi-hole v6
pihole -w s.youtube.com         # Pi-hole v5

Prefer to have every domain as an exact entry in your denylist (visible under Domains in the web interface), add your own never-block entries, or pick up new domains every hour instead of at the next gravity update? Use youtube.sh.

Every time it runs it:

1. downloads the latest black.list from this repo,
2. drops everything that matches ignore.list (so videos keep playing),