Windows packaged app
Download the latest packaged executable from GitHub Releases:
Windows source install
git clone https://github.com/kiacoder/blackout-kit.git cd blackout-kit python -m pip install . blackout version
The core install includes the Typer CLI and local checks. GUI, capture, media, and torrent dependencies remain optional.
Linux source/runtime install
python3 -m pip install . mkdir -p bins chmod +x bins/blackout-engine blackout version
Linux requires the managed executable bins/blackout-engine and currently supports only xray, tun, hysteria2, and tuic.
Safe first run
blackout demo blackout doctor --local-only blackout capabilities blackout route blackout setup blackout ready <engine> blackout connect
blackout setup is the guided keyboard workflow. It is read-only in JSON or non-interactive mode. Automatic runtime downloads are staged and require matching SHA-256 release metadata; manual sources remain labeled unverified.
After a proxy change
Blackout Kit records the exact local proxy target it owns and restores or clears it only when the current proxy still matches that target. If another program changes the proxy, Blackout Kit leaves it untouched.
Local state, not remote proof
The capability matrix and readiness checks describe platform support, local runtimes, settings, saved configuration shape, and local ports. They do not prove that an upstream server or filtered network is reachable.