{"id":16936493,"url":"https://github.com/jonhoo/buzz","last_synced_at":"2025-04-05T04:12:25.018Z","repository":{"id":45033507,"uuid":"83642253","full_name":"jonhoo/buzz","owner":"jonhoo","description":"A simple system tray application for notifying about unseen e-mail","archived":false,"fork":false,"pushed_at":"2024-04-28T08:06:32.000Z","size":416,"stargazers_count":141,"open_issues_count":5,"forks_count":12,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-29T03:07:53.936Z","etag":null,"topics":["email","imap","notifications","systray"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonhoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-02T06:21:06.000Z","updated_at":"2025-02-19T00:49:12.000Z","dependencies_parsed_at":"2024-02-03T10:24:24.802Z","dependency_job_id":"7598aa2e-6941-44ef-b443-f15e79399850","html_url":"https://github.com/jonhoo/buzz","commit_stats":{"total_commits":94,"total_committers":5,"mean_commits":18.8,"dds":"0.19148936170212771","last_synced_commit":"07cf74e3863f01213e37488926e7dc07e9ac004f"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fbuzz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fbuzz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fbuzz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fbuzz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonhoo","download_url":"https://codeload.github.com/jonhoo/buzz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247284951,"owners_count":20913704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","imap","notifications","systray"],"created_at":"2024-10-13T20:57:08.385Z","updated_at":"2025-04-05T04:12:24.999Z","avatar_url":"https://github.com/jonhoo.png","language":"Rust","readme":"# Introduction\n\nUsing mutt (or pine), but annoyed that it doesn't give you any\nnotifications when you've received new emails? buzz is a simple tray\napplication that detects new emails on IMAP servers using IDLE (push\nrather than pull). When it detects unseen messages, it shows a OSD style\nnotification and changes the tray icon to indicate that you have new\nmail.\n\nThis project is a Rust fork of\n[hasmail](https://github.com/jonhoo/hasmail), which provides basically\nthe same features, and is written in Go.\n\n## What does it look like:\n\n![no new e-mail](assets/no-email.png?raw=true)\n![new e-mail](assets/new-email.png?raw=true)\n\n![new e-mail notification](assets/notification.png?raw=true)\n\n# Configuration\n\nbuzz looks for a\n[TOML](https://github.com/toml-lang/toml#user-content-example)\nconfiguration file in `~/.config/buzz.toml` on startup. The\nconfiguration file consists of a number of account tables, each corresponding\nto one account:\n\n```toml\n[[account]]\nname = \"gmail\"\nserver = \"imap.gmail.com\"\nport = 993\nusername = \"jon@gmail.com\"\npwcmd = \"gnome-keyring-query get gmail_pw\" # or use the `password` field to set it in plain text\nnotificationcmd = \"ssh -t somehost wall 'New gmail message!'\" #Optional\nfolders = [ \"INBOX\" ] # Optional\n```\n\nAdditionally, icons can be configured in an icon section:\n\n```toml\n[icons]\nconnected = \"/usr/share/icons/Faenza/stock/24/stock_connect.png\"\ndisconnected = \"/usr/share/icons/Faenza/stock/24/stock_disconnect.png\"\nunread = \"/usr/share/icons/oxygen/base/32x32/status/mail-unread.png\"\nnew_mail = \"/usr/share/icons/oxygen/base/32x32/status/mail-unread-new.png\"\n```\n\n## Account fields\n\nThe value in `[]` can be anything (though avoid `.` as it will be parsed\nas a new TOML section), and is shown in the tooltip when new e-mails\narrive for an account. The options for an account are as follows:\n\n - `server`: The address to connect to. MUST currently be SSL/TLS\n   enabled.\n - `port`: The port to connect to.\n - `username`: Username for authentication.\n - `pwcmd`: Command to execute to get password for authentication.\n - `notificationcmd`: Additional command to be executed on new messages for this account.\n - `folder`: Name of the folder to watch (optional; defaults to \"INBOX\").\n\n# TODOs\n\n - [ ] `click` command\n - [ ] hover tooltip\n - [x] customizeable folder\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonhoo%2Fbuzz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonhoo%2Fbuzz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonhoo%2Fbuzz/lists"}