Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cropi/usbguard-notifier
A tool for detecting usbguard policy and device presence changes
https://github.com/cropi/usbguard-notifier
c-plus-plus linux usb usb-devices usbguard
Last synced: 4 days ago
JSON representation
A tool for detecting usbguard policy and device presence changes
- Host: GitHub
- URL: https://github.com/cropi/usbguard-notifier
- Owner: Cropi
- License: gpl-2.0
- Created: 2019-07-29T12:19:25.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-07-24T21:34:36.000Z (6 months ago)
- Last Synced: 2024-12-26T11:06:10.109Z (12 days ago)
- Topics: c-plus-plus, linux, usb, usb-devices, usbguard
- Language: C++
- Homepage:
- Size: 154 KB
- Stars: 46
- Watchers: 5
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# USBGuard Notifier
[](LICENSE)
### About
USBGuard Notifier is a software framework mainly for detecting usbguard policy modifications as well as device presence changes. In a nutshell, the purpose of this project is to create user-friendly notifications in form of quick pop-up messages.
### Dependencies
In order to compile the sources from a tarball/zip you will need the following development files:
* [usbguard](https://github.com/USBGuard/usbguard/)
* [libnotify](https://github.com/GNOME/libnotify)
* [librsvg](https://github.com/GNOME/librsvg)
* [asciidoc](https://github.com/asciidoc/asciidoc)
### Instalation
It is pretty easy to install the USBGuard Notifier. There are two possibilities how to install it:
* per user (locally)
```
$ ./autogen.sh
```
Now you can choose if you would like to store the notifications temporarily(until reboot):
```
$ ./configure --prefix /home/$(id -un)
```
or permanently:
```
$ ./configure --prefix /home/$(id -un) --with-permanent-notifications=path/to/dir
```
```
$ make
$ make install SYSTEMD_UNIT_DIR=/home/$(id -un)/.config/systemd/user/
$ systemctl enable --now --user usbguard-notifier.service
```
### Note
You might get an **IPC connection** error while trying to execute the binary program. It means the usbguard.service stopped working or you have not started it yet.
If you want to compile the sources in a cloned repository, you’ll have to run the ./autogen.sh script. It will fetch the sources (via git submodule) of [CATCH](https://github.com/catchorg/Catch2/). The script will then initialize the autotools based build system.
USBGuard Notifier has to use the same version of usbguard-devel package that USBGuard uses in your system.
### Contribution
You may want to extend the features of USBGuard Notifier. Contributions are welcome and will be fully credited. We accept contributions via Pull Requests on Github.
### License
GNU General Public License v2.0