#email #cli #systray #notification

app buzz

A simple system tray application for notifying about unseen e-mail

17 stable releases

1.1.10 Jul 1, 2019
1.1.6 Feb 19, 2019
1.1.2 Dec 4, 2018
1.1.1 Nov 23, 2018
0.3.0 May 15, 2017

#9 in Email

Download history 22/week @ 2019-04-18 31/week @ 2019-04-25 21/week @ 2019-05-02 39/week @ 2019-05-09 34/week @ 2019-05-16 56/week @ 2019-05-23 18/week @ 2019-05-30 67/week @ 2019-06-06 56/week @ 2019-06-20 163/week @ 2019-06-27 155/week @ 2019-07-04 77/week @ 2019-07-11 22/week @ 2019-07-18 5/week @ 2019-07-25

174 downloads per month


327 lines


Using mutt (or pine), but annoyed that it doesn't give you any notifications when you've received new emails? buzz is a simple tray application that detects new emails on IMAP servers using IDLE (push rather than pull). When it detects unseen messages, it shows a OSD style notification and changes the tray icon to indicate that you have new mail.

This project is a Rust fork of hasmail, which provides basically the same features, and is written in Go.

What does it look like:

no new e-mail new e-mail

new e-mail notification


buzz looks for a TOML configuration file in ~/.config/buzz.toml on startup. The configuration file consists of a number of sections, each corresponding to one account:

server = "imap.gmail.com"
port = 993
username = "jon@gmail.com"
pwcmd = "gnome-keyring-query get gmail_pw"

Account fields

The value in [] can be anything (though avoid . as it will be parsed as a new TOML section), and is shown in the tooltip when new e-mails arrive for an account. The options for an account are as follows:

  • server: The address to connect to. MUST currently be SSL/TLS enabled.
  • port: The port to connect to.
  • username: Username for authentication.
  • pwcmd: Command to execute to get password for authentication.


  • click command
  • hover tooltip
  • customizeable folder


~296K SLoC