Installation

Prerequisites

Before you install, make sure you have the following:

• Python 3.6 or later — python.org/downloads

• pip — included with Python 3.4+; verify with pip --version

• Administrator or root privileges — required to send ARP packets and capture network traffic

• A Roku device connected to your local network

• A Pi-hole server running on your local network

You must run the script with administrator privileges on Windows (Run as Administrator) or root/sudo on macOS and Linux. Without elevated permissions, the tool cannot send ARP packets or capture DNS traffic.

Install

Windows

1

Step 1: Install Npcap

Scapy requires a packet capture driver on Windows. Download and install Npcap from npcap.com. During installation, enable the option “Install Npcap in WinPcap API-compatible mode”.

2

Step 2: Clone the repository

Open a Command Prompt or PowerShell window as Administrator and run:

git clone https://github.com/maddog1110/pi-hole-on-roku-without-router-access.git
cd pi-hole-on-roku-without-router-access

3

Step 3: Install Python dependencies

pip install -r requirements.txt

4

Step 4: Verify the installation

python roku_pihole.py --help

macOS

Linux

Dependencies

The only runtime dependency is Scapy, a Python packet manipulation library. It is listed in requirements.txt and installed by pip install -r requirements.txt.

Dependency	Purpose
scapy	ARP spoofing and DNS packet capture/forwarding