mirror of
https://github.com/anotherhadi/usbguard-tui.git
synced 2026-05-11 22:02:34 +02:00
Hadi
2.2 KiB
2.2 KiB
▖▖▄▖▄ ▄▖ ▌ ▄▖▖▖▄▖
▌▌▚ ▙▘▌ ▌▌▀▌▛▘▛▌ ▐ ▌▌▐
▙▌▄▌▙▘▙▌▙▌█▌▌ ▙▌ ▐ ▙▌▟▖
USBGuard TUI
A terminal UI for managing USB devices via usbguard.
USBGuard is a software framework for implementing a USB device authorization policy (allowlisting/blocklisting). It protects your system against rogue USB devices by scanning them and checking their parameters against a set of rules.
Built with bubbletea & Goland!
Requirements
- usbguard installed and the daemon running
- Sufficient privileges to communicate with the usbguard daemon socket
Installation
Go install
go install github.com/anotherhadi/usbguard-tui@latest
Build from source
git clone https://github.com/anotherhadi/usbguard-tui
cd usbguard-tui
go build -o usbguard-tui .
Nix run
nix run github:anotherhadi/usbguard-tui
NixOS: system installation
Add the flake input and include the package in your configuration:
# flake.nix
inputs.usbguard-tui.url = "github:anotherhadi/usbguard-tui";
# configuration.nix / home.nix
environment.systemPackages = [ inputs.usbguard-tui.packages.${system}.default ];
Usage
usbguard-tui
The device list refreshes automatically every 2 seconds.