buskill1

Usage

Overview

buskill is a cross-platform CLI and GUI app that can lock or shutdown your computer when a USB hotplug removal event occurs.

It's designed to work with the BusKill laptop kill cord, which is a hardware dead man switch that tethers a user to their computer via a USB cable with an integrated magnetic breakaway. If the cable is disconnected (eg by a snatch-and-run thief stealing the user's machine), then this software can trigger the computer to lock or shutdown -- thus protecting encrypted files (eg bitcoin private keys) or current login sessions (eg online banking) from theft.

Options

-h, --help : Show this help message and exit.

--version : Print version and exit.

--list-triggers : List all available triggers.

-v, --verbose : Increase output verbosity.

-t , --trigger : Choose trigger to execute. See --list-triggers for all possible values.

-T, --run-trigger : Immediately execute the trigger on start.

-a, --arm : Arms BusKill.

Examples

buskill --list-triggers : Display all possible triggers, then exits.

buskill --trigger lock-screen --arm : Arm the buskill app with the 'lock-screen' trigger so that a USB hotplug removal event will lock the device's screen

buskill --trigger soft-shutdown --arm : Arm the buskill app with the 'soft-shutdown' trigger so that a USB hotplug removal event will cause the device to shutdown