usbguard-notifier - provides user-friendly notifications for USBGuard
Contents
Bugs
If you find a bug in this software or if you’d like to request a feature to be implemented, please file a
ticket at https://github.com/Cropi/usbguard-notifier/issues/new.
Copying
License GPLv2+: GNU GPL version 2 or later http://gnu.org/licenses/gpl.html. This is free software: you
are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
04/01/2024 USBGUARD-NOTIFIER(1)
Description
USBGuard Notifier is a software framework mainly for detecting usbguard policy modifications as well as
device presence changes. The purpose of this project is to create user-friendly notifications in form of
quick pop-up messages.
How To Start
In order to make usbguard-notifier work properly, you will need to perform certain actions:
1. Each user who wants to run usbguard-notifier service needs to have sufficient IPC privileges to
connect to the usbguard IPC interface. To allow a specific user to listen to the device signals you
can use the following command:
$sudousbguardadd-userUSER-dlisten
Or you can allow a group of users:
$sudousbguardadd-user-gGROUP-dlisten
2. Now, you need a running usbguard-daemon instance to connect to. Start the usbguard service or restart
it if it is already running.
3. After configuring IPC privileges and starting up the usbguard-daemon, the user can now start the
usbguard-notifier service:
$systemctlstart--userusbguard-notifier.service
Optionally, the user can enable the usbguard-notifier service to start automatically after the login:
$systemctlenable--userusbguard-notifier.service
The usbguard-notifier should now be running. Anytime a USB device gets inserted/ejected or
allowed/blocked a message will pop up in the user’s graphical interface.
Name
usbguard-notifier - provides user-friendly notifications for USBGuard
Options
-w,--wait
Wait until an active IPC connection is estabilished.
-d,--debug
Enable debug mode.
-h,--help
Show help.
Resources
Main web site: https://usbguard.github.io/
See Also
usbguard-notifier-cli(1), usbguard(1)
Synopsis
usbguard-notifier [OPTIONS]
