explaingit

frayude/throttnux

Analysis updated 2026-06-24

63PythonAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

Linux CLI that throttles any other device on the same LAN by ARP spoofing it onto your machine and rate-limiting its traffic with tc, no router access required.

Mindmap

mindmap
  root((throttnux))
    Inputs
      LAN scan target
      Bandwidth cap
      Network interface
    Outputs
      ARP spoof routing
      Throttled forwarding
      Live bandwidth meter
    Use Cases
      Cap a noisy neighbour on Wi-Fi
      Test app behaviour on slow links
      Network experimentation
    Tech Stack
      Python
      Linux
      arpspoof
      tc
Click or tap to explore — scroll the page freely

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 build with it?

USE CASE 1

Cap a roommate or guest device using too much shared Wi-Fi bandwidth

USE CASE 2

Simulate a slow connection on a real phone for app QA

USE CASE 3

Teach an intro lesson on ARP spoofing and Linux traffic shaping in a controlled lab

What is it built with?

PythonLinuxarpspooftc

How does it compare?

frayude/throttnuxobsproject/loganalyzerzqbxdev/webchat2api
Stars636362
LanguagePythonPythonPython
Last pushed2026-03-04
MaintenanceMaintained
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audienceops devopsgeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Linux only, needs sudo for arpspoof and tc, and your machine must stay on for the throttle to persist.

In plain English

Throttnux is a Linux command-line program that lets you slow down the internet connection of any other device on your local network, without logging into the router or changing its settings. The README gives a familiar scenario: someone on the same Wi-Fi is using all the bandwidth, and you want to cap them. You run this tool on your own Linux machine and it does the rest. It only works on Linux because it depends on two standard Linux utilities, arpspoof and tc, which do not exist on Windows or macOS. The way it works is described in two steps. First, it uses a trick called ARP spoofing, which sends fake network messages to the target device so the device thinks your computer is the router. All of its traffic then flows through your machine on its way to the real router. Second, your machine uses the Linux traffic shaping tool tc to slow that traffic down to whatever speed you pick before forwarding it on. Installation is a clone of the repository followed by a setup script that you run with sudo. You then start the program with sudo and a Python command. Everything after that is interactive. It auto-detects your network interface and gateway, scans for devices on the network, lists them with their IP and vendor, and asks you to pick one and choose a bandwidth limit like 1, 2, or 3 megabits per second, or a custom value. Once active, the screen shows a live bandwidth meter that updates every second. Pressing Ctrl+C stops the throttling, removes the traffic shaping rules, and restores the target device to its normal connection. The README is upfront about limits and ethics. Your machine must stay on for the throttling to keep working, because ARP spoofing has to run continuously. And the disclaimer says the tool is for networks you own or have permission to manage, not for use on networks you do not control.

Copy-paste prompts

Prompt 1
Install throttnux on Ubuntu, run the setup script, and throttle one device on my home LAN to 2 Mbps
Prompt 2
Walk through how throttnux combines arpspoof and tc to route a target's traffic through my machine
Prompt 3
Add a feature to throttnux that schedules the throttle window for specific hours of the day
Prompt 4
Explain the ethics disclaimer in throttnux and what changes if I run it on a network I do not own

Frequently asked questions

What is throttnux?

Linux CLI that throttles any other device on the same LAN by ARP spoofing it onto your machine and rate-limiting its traffic with tc, no router access required.

What language is throttnux written in?

Mainly Python. The stack also includes Python, Linux, arpspoof.

How hard is throttnux to set up?

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

Who is throttnux for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.