_   _ ____  ____   ____                     _   _____ _   _ ___
| | | / ___|| __ ) / ___|_   _  __ _ _ __ __| | |_   _| | | |_ _|
| | | \___ \|  _ \| |  _| | | |/ _` | '__/ _` |   | | | | | || |
| |_| |___) | |_) | |_| | |_| | (_| | | | (_| |   | | | |_| || |
 \___/|____/|____/ \____|\__,_|\__,_|_|  \__,_|   |_|  \___/|___|

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.

This project is NOT affiliated with, endorsed by, or connected to "Red Hat, Inc" in any way. It is an unofficial, community-driven tool.

Features

• List all connected USB devices with their current status
• Allow, block, or reject devices: temporarily or permanently
• Action popup for quick device management
• Filter devices by name with /
• Auto-refresh
• Keyboard shortcuts for all actions (a/A, b/B, e/E, ...) & Mouse support

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 ./cmd/usbguard-tui

NUR (Nix/NixOS)

Available via NUR, under the anotherhadi repo:

environment.systemPackages = [ nur.repos.anotherhadi.default-creds-tui ];

Usage

usbguard-tui

The device list refreshes automatically every 2 seconds.

---

github | gitlab (mirror) | gitea (mirror)