https://github.com/heyjuvi/avizo
A neat notification daemon
https://github.com/heyjuvi/avizo
gtk3 notification sway vala
Last synced: about 1 month ago
JSON representation
A neat notification daemon
- Host: GitHub
- URL: https://github.com/heyjuvi/avizo
- Owner: heyjuvi
- License: gpl-3.0
- Created: 2019-03-17T14:51:32.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-03T23:35:39.000Z (8 months ago)
- Last Synced: 2025-05-10T13:02:46.980Z (about 1 month ago)
- Topics: gtk3, notification, sway, vala
- Language: Vala
- Size: 625 KB
- Stars: 546
- Watchers: 9
- Forks: 27
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Avizo
Avizo is a simple notification daemon, mainly intended to be used for multimedia keys for example with Sway.
## Configuration
Avizo can be configured using the configuration file and CLI options.
`avizo-client` looks for configuration file `avizo/config.ini` in the standard [XDG directories](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) `XDG_CONFIG_HOME` (defaults to `~/.config`) and `XDG_CONFIG_DIRS` (defaults to `/etc/xdg`), in that order.
The first found file is used.
Missing configuration file is not an error.
The configuration file must be in INI format and should define keys in section named `default`.
Names of the configuration keys correspond to the CLI options (e.g. `block-height`).
Any configuration key can be overridden by corresponding CLI option (i.e. CLI options take precedence).
## Helper scripts
### volumectl
Adjust the sound or mic volume and show Avizo notification.
**Requirements:**
* POSIX-sh compatible shell (e.g. Busybox ash, dash, ZSH, bash, …)
* common \*nix userland (BSD, Busybox or GNU)
* [pamixer](https://github.com/cdemoulins/pamixer)
* [pactl](https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/CLI/#pactl) for the `-p` option (currently playing sink/source) if pamixer is older than 1.6
### lightctl
Adjust (display) brightness and show Avizo notification.
**Requirements:**
* POSIX-sh compatible shell (e.g. Busybox ash, dash, ZSH, bash, …)
* common \*nix userland (BSD, Busybox or GNU)
* [brightnessctl](https://github.com/Hummer12007/brightnessctl) or [light](https://github.com/haikarainen/light)
## Sway config
```
bindsym XF86AudioRaiseVolume exec volumectl -u up
bindsym XF86AudioLowerVolume exec volumectl -u down
bindsym XF86AudioMute exec volumectl toggle-mute
bindsym XF86AudioMicMute exec volumectl -m toggle-mute
bindsym XF86MonBrightnessUp exec lightctl up
bindsym XF86MonBrightnessDown exec lightctl down
exec "avizo-service"
```
## Install
### From package repository
Avizo is available in the following repositories:
[](https://repology.org/project/avizo-notification-daemon/versions)
### Manually
```
meson build
ninja -C build install
```
You may want to specify the installation directory (the above default to
`/usr/local/bin`). In such case you may use
```
meson -Dprefix= build
ninja -C build install
```
In some cases (like if you want to install the results to `/usr/bin`), the last
command needs to be run with root privileges.
### Arch User Repository
A package called avizo is also available in the Arch Linux User Repository.