Source code Nuntius
IMAP email checker and GTK notifier
This project is no more under active development.
This may affect its usage in unpredictable and unguaranteed ways.
Nuntius (originally Paberboy) is a simple CLI application which sends a GTK notification when an email is received, allowing the user to just click on the callback button to open the webmail associated to the account.
In order to do what's been described:
- it registers a
GApplicationthrough which to make GTK notifications flow
- for each account defined, it connects to the corresponding IMAP server, querying for
- if any, it fires a notification mapping a callback button to the opening of the webmail URL corresponding to the account
How to use
Usage is very straightforward, as all the options are passed via a configuration file:
nuntius -c ~/.config/nuntius
The configuration is YAML-formatted and should respect the following sample structure:
accounts: - alias: "Name" address: "email@example.com" password: "pa$word" hostname: "imap.host.name" proto: "imaps" port: "993" url: "https://url.to/webmail"
The application runs checks at a certain interval, configurable in seconds, using a dedicated flag:
nuntius -c ~/.config/nuntius -i 60
Configuring a service unit
- Service unit at
[Unit] Description=Nuntius service After=network-online.target Wants=network-online.target [Service] Type=simple ExecStart=nuntius -c %h/.config/nuntius Restart=always RestartSec=10 [Install] WantedBy=multi-user.target
systemctl --user daemon-reload systemctl --user enable nuntius.service systemctl --user start nuntius.service
Installation from repositories is only available for Solus-Project users which have enabled Theca repository:
eopkg it -y nuntius
Run latest source code
git clone https://github.com/streambinder/nuntius.git make -C nuntius make -C nuntius install
Dependencies on which the code base is relying to be provenly working follow: