buskill - Lock or shutdown if your device is stolen (for use with laptop kill cord)
Contents
Description
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 discon‐
nected (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 lo‐
gin sessions (eg online banking) from theft.
Examples
buskill--list-triggers : Display all possible triggers, then exits.
buskill--triggerlock-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--triggersoft-shutdown--arm : Arm the buskill app with the 'soft-shutdown' trigger so that a
USB hotplug removal event will cause the device to shutdown
Name
buskill - Lock or shutdown if your device is stolen (for use with laptop kill cord)
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.
See Also
This manpage is limited in scope. The BusKill project's main documentation (complete with images and
videos) is available at docs.buskill.in (https://docs.buskill.in)
• Full Documentation (https://docs.buskill.in)
• Official BusKill Project Website (https://buskill.in)
Synopsis
buskill [options]
