# buskill-app

**Repository Path**: onewayout/buskill-app

## Basic Information

- **Project Name**: buskill-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-02-09
- **Last Updated**: 2022-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![build](https://github.com/BusKill/buskill-app/workflows/build/badge.svg?branch=master)

# BusKill App

This is the codebase for our cross-platform (CLI and) GUI app for [BusKill](https://www.buskill.in). It works in Linux, Windows, and MacOS.

BusKill is a laptop kill cord that can trigger your computer to lock or shutdown when it's physically seperated from you.

<p align="center">
  <img src=".github-assets/busKill_demo.gif?raw=true" alt="BusKill Demo Video"/>
</p>

For more information on how to [buy](https://www.buskill.in/buy) or build your own BusKill cable, see the [BusKill Website](https://www.buskill.in):

 * [https://www.buskill.in](https://www.buskill.in)

![](.github-assets/busKill_featuredImage.jpg)

# Documentation

To read our comprehensive documentation, see:

 * [docs.buskill.in](https://docs.buskill.in)

## Install

For instructions on downloading and cryptographically verifying our latest release, see:

 * [Downloading the BusKill App](https://docs.buskill.in/buskill-app/en/stable/software_usr/download.html)
 * [Verifying the Download](https://docs.buskill.in/buskill-app/en/stable/software_usr/signature.html)

## Screenshots

BusKill is simple. When armed, a USB removal will trigger the screen to lock (by default).

BusKill runs in Linux, Windows, and MacOS.

<p align="center" float="left">
  <img src="docs/images/buskill_app_lin_arm2.gif?raw=true" alt="Click the button to arm BusKill" width="200px" />
  <img src="docs/images/buskill_app_win_disarmed1.jpg" alt="Screenshot of BusKill in Windows" width="200px" />
  <img src="docs/images/buskill_app_mac_disarmed1.jpg" alt="Screenshot of BusKill in MacOS" width="200px" />
</p>

For more information on how to use the GUI, see [BusKill App: Graphical User Interface](https://docs.buskill.in/buskill-app/en/stable/software_usr/gui.html)

## Misconceptions

> Q: Self-destruct?!? Will this brick my computer?

A: [No](https://docs.buskill.in/buskill-app/en/stable/faq.html#q-self-destruct-will-this-brick-my-computer). The BusKill app does not have the ability to harm your hardware and our app ships with non-destructive triggers only.

For more information, see our [Frequently Asked Questions](https://docs.buskill.in/buskill-app/en/stable/faq.html).

## Contributing

BusKill is an open-source project run by volunteers that create and maintain open-source hardware and software. Please see [Contributing to BusKill](https://docs.buskill.in/buskill-app/en/stable/contributing.html) to learn how you can help the BusKill project.

You can also [donate with bitcoin, monero, paypal, or credit card](https://buskill.in/donate).

Contributions of any amount and kind are greatly appreciated <3

## Attribution

Thank you to the countless [individuals and other open-source projects](https://docs.buskill.in/buskill-app/en/stable/attribution.html) that have contributed to to the BusKill project!

# Press

As seen on [PCMag](https://www.pcmag.com/news/372806/programmers-usb-cable-can-kill-laptop-if-machine-is-yanked), [Forbes](https://www.forbes.com/sites/daveywinder/2020/01/03/this-20-usb-cable-is-a-dead-mans-switch-for-your-linux-laptop/), [ZDNet](https://www.zdnet.com/article/new-usb-cable-kills-your-linux-laptop-if-stolen-in-a-public-place/), & [Tom's Hardware](https://www.tomshardware.com/news/the-buskill-usb-cable-secures-your-laptop-against-thieves).

# Contact

To contact us via email, please visit:

 * https://www.buskill.in/contact/

# License

The contents of this repo are dual-licensed. All code is GPLv3 and all other content is CC-BY-SA.

# For more Information

See https://tech.michaelaltfield.net/2020/01/02/buskill-laptop-kill-cord-dead-man-switch/