▖▖▄▖▄ ▄▖       ▌  ▄▖▖▖▄▖
▌▌▚ ▙▘▌ ▌▌▀▌▛▘▛▌  ▐ ▌▌▐
▙▌▄▌▙▘▙▌▙▌█▌▌ ▙▌  ▐ ▙▌▟▖

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.

---

github | gitlab (mirror) | gitea (mirror)