1USBGUARD-NOTIFIER(1)                                      USBGUARD-NOTIFIER(1)
2
3
4

NAME

6       usbguard-notifier - provides user-friendly notifications for USBGuard
7

SYNOPSIS

9       usbguard-notifier [OPTIONS]
10

DESCRIPTION

12       USBGuard Notifier is a software framework mainly for detecting usbguard
13       policy modifications as well as device presence changes. The purpose of
14       this project is to create user-friendly notifications in form of quick
15       pop-up messages.
16

OPTIONS

18       -w, --wait
19           Wait until an active IPC connection is estabilished.
20
21       -d, --debug
22           Enable debug mode.
23
24       -h, --help
25           Show help.
26

HOW TO START

28       In order to make usbguard-notifier work properly, you will need to
29       perform certain actions:
30
31        1. Each user who wants to run usbguard-notifier service needs to have
32           sufficient IPC privileges to connect to the usbguard IPC interface.
33           To allow a specific user to listen to the device signals you can
34           use the following command:
35
36
37           $ sudo usbguard add-user USER -d listen
38
39           Or you can allow a group of users:
40
41
42           $ sudo usbguard add-user -g GROUP -d listen
43
44        2. Now, you need a running usbguard-daemon instance to connect to.
45           Start the usbguard service or restart it if it is already running.
46
47        3. After configuring IPC privileges and starting up the
48           usbguard-daemon, the user can now start the usbguard-notifier
49           service:
50
51
52           $ systemctl start --user usbguard-notifier.service
53
54           Optionally, the user can enable the usbguard-notifier service to
55           start automatically after the login:
56
57
58           $ systemctl enable --user usbguard-notifier.service
59
60       The usbguard-notifier should now be running. Anytime a USB device gets
61       inserted/ejected or allowed/blocked a message will pop up in the user’s
62       graphical interface.
63

SEE ALSO

65       usbguard-notifier-cli(1), usbguard(1)
66

BUGS

68       If you find a bug in this software or if you’d like to request a
69       feature to be implemented, please file a ticket at
70       https://github.com/Cropi/usbguard-notifier/issues/new.
71

AUTHOR

73       USBGuard Notifier was written by Zoltán Fridrich and Attila Lakatos.
74

RESOURCES

76       Main web site: https://usbguard.github.io/
77

COPYING

79       License GPLv2+: GNU GPL version 2 or later
80       http://gnu.org/licenses/gpl.html. This is free software: you are free
81       to change and redistribute it. There is NO WARRANTY, to the extent
82       permitted by law.
83
84
85
86                                  12/19/2022              USBGUARD-NOTIFIER(1)
Impressum