mirror of
https://github.com/anotherhadi/usbguard-tui.git
synced 2026-07-06 12:12:33 +02:00
dependabot[bot]
58373964d6
Bumps [golang.org/x/net](https://github.com/golang/net) from 0.39.0 to 0.55.0. - [Commits](https://github.com/golang/net/compare/v0.39.0...v0.55.0) --- updated-dependencies: - dependency-name: golang.org/x/net dependency-version: 0.55.0 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>
▖▖▄▖▄ ▄▖ ▌ ▄▖▖▖▄▖
▌▌▚ ▙▘▌ ▌▌▀▌▛▘▛▌ ▐ ▌▌▐
▙▌▄▌▙▘▙▌▙▌█▌▌ ▙▌ ▐ ▙▌▟▖
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 & Golang!
Colors and styles can be customized using ilovetui, which applies theme changes across all compatible TUI applications at once.
Features
- List all connected USB devices with their current status (allowed, blocked, rejected)
- Allow, block, or reject devices: temporarily or permanently
- Action popup with mouse support for quick device management
- Filter devices by name with
/ - Auto-refresh
- Keyboard shortcuts for all actions (
a/A,b/B,e/E)
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.