Gmail unread status

A personal command-line utility that prints the number of unread messages in its owner's own Gmail inbox tabs on a terminal welcome screen.

What it does

The tool runs locally on its owner's computer. When a terminal session starts, it asks the Gmail API how many unread messages match two searches and prints one line:

Gmail      3 nepřečtené · Primary 1 · Aktualizace 2

That is the whole feature set. There is no web interface, no account to create and no other user: it reads exactly one mailbox, the one whose owner installed it.

What it accesses

A single read-only Gmail scope, https://www.googleapis.com/auth/gmail.readonly, used only to count messages matching in:inbox is:unread category:primary and in:inbox is:unread category:updates. Message bodies, subjects, attachments and contacts are never requested, stored or displayed, and the tool never sends mail.

Privacy

Nothing leaves the computer it runs on. The full detail is in the privacy policy.