NAME

       buskill - Lock or shutdown if your device is stolen (for use with laptop kill cord)

SYNOPSIS

       buskill [options]

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.

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

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)

AUTHORS

       Michael Altfield (<michael@michaelaltfield.net>) and The BusKill Team (<https://buskill.in/contact>).

                                                                                                      BUSKILL(1)