Source code Nuntius

IMAP email checker and GTK notifier

• About
• Installation

About

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 GApplication through which to make GTK notifications flow
• for each account defined, it connects to the corresponding IMAP server, querying for UNSEEN emails
• 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@addre.ss"
    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 ~/.config/systemd/user/nuntius.service

[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

• Enablement:

systemctl --user daemon-reload
systemctl --user enable nuntius.service
systemctl --user start nuntius.service

Installation

Package manager

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

Dependencies on which the code base is relying to be provenly working follow: