https://github.com/ckath/snotif

simple notification provider for basic battery and network events on linux
https://github.com/ckath/snotif

battery-status c linux network-info notifications

Last synced: 10 days ago
JSON representation

simple notification provider for basic battery and network events on linux

• Host: GitHub
• URL: https://github.com/ckath/snotif
• Owner: Ckath
• License: mit
• Created: 2017-05-28T19:03:36.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-08-07T23:50:13.000Z (over 4 years ago)
• Last Synced: 2024-11-07T00:33:18.728Z (about 2 months ago)
• Topics: battery-status, c, linux, network-info, notifications
• Language: C
• Homepage:
• Size: 13.7 KB
• Stars: 2
• Watchers: 4
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# snotif

a simple notification service for battery and network notifications. this was created as replacement for notifications *applets* often offer, without the need for *applets*. snotif was made with minimal memory footprint in mind (although using libnotify somewhat ruins this goal), and all configuration is done at compile time, a lot of configuration is optional and not needed for core functionality

snotif currently boasts the following features:

- Run daemonized

- Battery notifications (charging, discharging, full)

- Critical battery percentage warning, if configured/supported

- Optional extra information about percentage and time left, if configured/supported 

- WLAN notifications (disconnected from network, connected to network)

- Compile time configuration, no parsing config files at runtime

## setup

1. clone repo

2. `make clean install`

3. edit config.h to your liking

4. go back to step 2

## configuration

as mentioned before all configuration is done by editing `config.h` and recompiling, features left unconfigured(meaning not defined in `config.h`) will not be in your binary.

a few example configs are included, `config.def.h`, the default config. and `config_smapi.def.h`, which is meant for devices with smapi, using the extra features it offers. by default your `config.h` will be generated using `config.def.h`, manually copy `config_smapi.def.h` to `config.h`if you wish to use this as your base instead.

this should be sufficient for most systems allthough I cant promise the format will be compatible with each, if this is the case you'd have to manually correct how the file is parsed in snotif.c, or leave a pr to better implement support for your particular system.

## usage

it's suggested you start snotif with `snotif -d` from your startup script or other means

    usage: snotif [option]

    

    options:

        -d start daemonized

        -v print version info and exit

        -h print this info and exit

## bugs and contribution

you can report bugs or make feature requests on the issues page

for contribution, just help fix bugs and send a pr, or do whatever really, if it's useful I'll probably merge it.

## license

see the LICENSE file

## mentions

- [slstatus](https://github.com/drkhsh/slstatus) : inspiration for easily reading system information

- [suckless](http://suckless.org/coding_style) : some of the coding style (all these define checks arent allowed afaik, I'm also unsure if this actually *sucks less*, but there was an attempt)