Arguments

Usage

python roku_pihole.py [OPTIONS]

All arguments are optional except --roku. If you run the script without any arguments, it launches the interactive text-based interface instead.

For examples of how to use these arguments in practice, see Command-line mode.

Arguments

--roku

Type: string Required

IP address of the Roku device you want to redirect DNS queries from. You must provide this argument to run in command-line mode.

python roku_pihole.py --roku 192.168.1.100

--router

Type: string

IP address of your router. If you omit this argument, the tool attempts to auto-detect the default gateway on your network. Provide it explicitly if auto-detection fails or produces the wrong result.

python roku_pihole.py --roku 192.168.1.100 --router 192.168.1.1

--pihole

Type: string Default: 192.168.50.66

IP address of your Pi-hole server. DNS queries intercepted from the Roku device are forwarded to this address. Defaults to 192.168.50.66 if not specified.

python roku_pihole.py --roku 192.168.1.100 --pihole 192.168.1.2

--log-level

Type: string

Logging verbosity level. Accepted values are DEBUG, INFO, WARNING, ERROR, and CRITICAL. Use DEBUG to see detailed output when diagnosing issues.

python roku_pihole.py --roku 192.168.1.100 --log-level DEBUG

Complete example

The following command specifies all four arguments explicitly:

python roku_pihole.py \
  --roku 192.168.1.100 \
  --router 192.168.1.1 \
  --pihole 192.168.1.2 \
  --log-level INFO

This intercepts DNS queries from the Roku at 192.168.1.100, spoofing ARP between it and the router at 192.168.1.1, and forwards all DNS queries to the Pi-hole at 192.168.1.2.