git404hub

what is ftl fr?

pi-hole/ftl — explained in plain English

Analysis updated 2026-07-25 · repo last pushed 2026-07-25

⭐ low-key fire1,680CAudience · ops devopsComplexity · 3/5ActiveSetup · moderate

tl;dr

The engine behind Pi-hole that blocks ads network-wide by intercepting DNS requests, built on top of dnsmasq, and provides dashboard statistics through an interactive API.

vibe map

mindmap
  root((repo))
    What it does
      Blocks ads network-wide
      Intercepts DNS requests
      Provides dashboard stats
    Tech stack
      C language
      dnsmasq
      Linux
    Use cases
      Block ads on smart TV
      Block ads on old devices
      Raspberry Pi ad blocker
    Audience
      Home network admins
      Raspberry Pi users
      Office network managers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run Pi-hole on a Raspberry Pi to block ads across all devices on your home network.

VIBE 2

Block ads on devices that can't install their own ad blockers, like smart TVs and older tablets.

VIBE 3

Track and view statistics on which domains and ads were blocked via an interactive API.

what's the stack?

CdnsmasqLinux

how it stacks up fr

pi-hole/ftlpeng-zhihui/peakvercel-labs/zero
Stars1,6801,8291,465
LanguageCCC
Last pushed2026-07-252022-12-12
MaintenanceActiveDormant
Setup difficultymoderatehardmoderate
Complexity3/54/54/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Replaces dnsmasq entirely, so it will disable any existing dnsmasq installation already running on your machine.

No license information was provided in the explanation.

in plain english

Pi-hole is a popular tool that blocks ads across every device on your home or office network, phones, laptops, smart TVs, everything, without needing to install separate ad blockers on each one. FTLDNS is the engine that makes it all work behind the scenes, handling the actual DNS requests (the lookup step that happens whenever a device tries to reach a website) and generating the statistics you see in the dashboard. At a high level, it works by intercepting every request a device makes to load a website. If the requested domain is on a blocklist, the request is denied before it ever leaves your network. What makes this engine special is that it's built directly on top of an existing, well-tested DNS tool called dnsmasq, rather than being written from scratch. This means it can inherit all the reliability of that mature tool while adding the extra features Pi-hole needs, like tracking which sites were blocked and serving up that data through an interactive API. The primary audience is anyone running Pi-hole on a Linux machine or a small device like a Raspberry Pi. If you've ever wanted to block ads on your smart TV, your phone, or an older tablet that can't run its own ad blocker, this is the layer that makes that possible. It's designed to be lightweight enough to run on minimal hardware, including the tiny Raspberry Pi Zero. One important tradeoff to be aware of: because this engine essentially replaces dnsmasq, it will disable any existing copy of that tool already running on your machine. The two can't coexist. For most people this won't matter, but if you're already using dnsmasq for something else on the same device, you'll need to plan around that.

prompts (copy fr)

prompt 1
How do I install and configure FTLDNS on a Raspberry Pi Zero to block ads across my home network?
prompt 2
What happens if I already have dnsmasq running on my machine and I want to install FTLDNS? How do I resolve the conflict?
prompt 3
Help me understand how FTLDNS intercepts DNS requests and serves block statistics through its API so I can build a custom dashboard.

Frequently asked questions

what is ftl fr?

The engine behind Pi-hole that blocks ads network-wide by intercepting DNS requests, built on top of dnsmasq, and provides dashboard statistics through an interactive API.

What language is ftl written in?

Mainly C. The stack also includes C, dnsmasq, Linux.

Is ftl actively maintained?

Active — commit in last 30 days (last push 2026-07-25).

What license does ftl use?

No license information was provided in the explanation.

How hard is ftl to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ftl for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.