https://github.com/dkarter/ukey
🔐 Automatically lock macOS when a USB device is removed
https://github.com/dkarter/ukey
bitbar-plugin macos rubber-ducky security-tools usb
Last synced: 4 months ago
JSON representation
🔐 Automatically lock macOS when a USB device is removed
- Host: GitHub
- URL: https://github.com/dkarter/ukey
- Owner: dkarter
- License: mit
- Created: 2017-08-24T18:23:44.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-09T04:13:12.000Z (over 1 year ago)
- Last Synced: 2024-04-10T16:03:32.904Z (about 1 year ago)
- Topics: bitbar-plugin, macos, rubber-ducky, security-tools, usb
- Language: Ruby
- Homepage: https://doriankarter.com
- Size: 19.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
## UKey
Automatically lock mac when a USB device is removed
## Installation
Install the gem globally:
```bash
gem install ukey
```
## Usage
Select the device by plugging it in and running:
```bash
ukey select-device
```
I use a YubiKey, which I prefer because you do not have to eject it,
but this script will work with almost any USB device.
Then to run the program
```bash
ukey watch
```
## Menubar App
ukey works with BitBar - it will show you the status of the ukey watcher and allow you to start and stop the watcher right from your macOS menubar.
### Installation
1. Install the ukey gem globally (instructions above)
2. Install BitBar from [this fork by @oleander](https://github.com/oleander/bitbar/releases)
3. Copy the bitbar/ukey.rb file from the ukey repo into your BitBar "enabled plugins" folder.
4. Run BitBar