USBGUARD-NOTIFIER(1)

📦
version 1.1.4 · 7 versions
, in centos-stream 10, centos-stream 9, fedora 43, fedora 44

✨ usbguard-notifier ✨

okay bestie, welcome to the usbguard-notifier(1) manual page 💖 this is the little cutie that slides into your notifications and tells you what your USB ports are up to. she's giving security but make it cute.

🌸 NAME 🌸

usbguard-notifier — the icon that serves user-friendly notifications for USBGuard 💅

🎀 SYNOPSIS 🎀

usbguard-notifier [OPTIONS]

🦋 DESCRIPTION 🦋

So. USBGuard Notifier is a whole software framework, and its main character job is detecting usbguard policy modifications plus device presence changes. That's it, that's the vibe check.

The point of the whole project? Making user-friendly notifications in the form of quick pop-up messages. Like, a little "hey girlie, something happened with your USB" moment. Not me being obsessed with a notification daemon 😭✨

💅 OPTIONS 💅

  • -w, --wait — hang out and wait until an active IPC connection is established. patient queen behaviour 🫶
  • -d, --debug — turn on debug mode. now she's telling you everything 🔥
  • -h, --help — show help. the classic. the icon. the moment 💖

🌈 HOW TO START 🌈

okay so for usbguard-notifier to actually work properly, you've gotta do a few things first. no skipping, bestie, it's giving prerequisites:

  1. Every user who wants to run the usbguard-notifier service needs sufficient IPC privileges to connect to the usbguard IPC interface. To let one specific user listen to the device signals, use this:
$ sudo usbguard add-user USER -d listen

Or, if you're feeling generous, allow a whole group of users:

$ sudo usbguard add-user -g GROUP -d listen
  1. Now you need a running usbguard-daemon instance to connect to. Start the usbguard service, or restart it if it's already running. (restart is such a mood tbh)
  2. After you've configured the IPC privileges and started up the usbguard-daemon, the user can finally start the usbguard-notifier service:
$ systemctl start --user usbguard-notifier.service

And optionally, if you want the usbguard-notifier service to start automatically after login (so you never have to think about it again, main character energy):

$ systemctl enable --user usbguard-notifier.service

After all that, usbguard-notifier should be running 🎉 Anytime a USB device gets inserted or ejected, or gets allowed or blocked, a message will pop up in the user's graphical interface. literally a text from your USB port. periodt.

👑 SEE ALSO 👑

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

💀 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. don't be shy, they wanna hear it fr fr 🙈

🧚 AUTHOR 🧚

USBGuard Notifier was written by Zoltán Fridrich and Attila Lakatos. kings, honestly 💜

🍓 RESOURCES 🍓

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

⭐ 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. read that again bestie, NO WARRANTY, she said what she said 😤

and that's the whole page, bestie!! this was the usbguard-notifier(1) manual, dated 03/19/2024 💖 go forth and get notified, you've got this 🫶✨

📦 where this page comes from