{"id":16615184,"url":"https://github.com/nojhan/clibard","last_synced_at":"2025-09-04T09:47:19.169Z","repository":{"id":222880314,"uuid":"758627750","full_name":"nojhan/clibard","owner":"nojhan","description":"Watch your last D-Bus notifications in the terminal","archived":false,"fork":false,"pushed_at":"2025-02-19T09:54:58.000Z","size":79,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T01:49:37.979Z","etag":null,"topics":["cli","d-bus","dbus","notifications","python","shell","terminal"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nojhan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-02-16T18:13:56.000Z","updated_at":"2025-02-19T09:55:02.000Z","dependencies_parsed_at":"2024-02-16T19:30:57.145Z","dependency_job_id":"ee5617d8-cabe-4c89-b35a-bc672611f37a","html_url":"https://github.com/nojhan/clibard","commit_stats":null,"previous_names":["nojhan/clibard"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nojhan/clibard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Fclibard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Fclibard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Fclibard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Fclibard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nojhan","download_url":"https://codeload.github.com/nojhan/clibard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Fclibard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273587669,"owners_count":25132849,"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","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","d-bus","dbus","notifications","python","shell","terminal"],"created_at":"2024-10-12T02:08:50.669Z","updated_at":"2025-09-04T09:47:19.138Z","avatar_url":"https://github.com/nojhan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"CLI bard — See all your last notifications in the terminal\n==========================================================\n\nThe *CLI bard* is a very simple command line application that displays the last\nnotifications received on the D-Bus (the common notification system under Linux).\n\nIt is not an interactive application, it just displays incoming notifications.\nAt any time, as much as possible of the last notifications are displayed.\nThe display refreshes when a notification is received.\n\n![Screenshot of the vertical layout](https://github.com/nojhan/clibard/blob/main/doc/screenshot_vertical.png?raw=true)\n\nThe CLI bard is written in Python and is available under the AGPLv3 license.\n\n\nInstall\n=======\n\nThe CLI bard relies on your terminal using a font patched with the \"Powerline\"\ncharacters. The recommended fonts are the ones from the\n[Nerd font project](https://www.nerdfonts.com/).\n\n\nUsage\n=====\n\nCommand arguments\n-----------------\n\n\u003e usage: clibard.py [-h] [-l {h,v,horizontal,vertical}] [--test NB_ITEMS]\n\u003e                   [--send NB_ITEMS]\n\u003e\n\u003e options:\n\u003e   -h, --help            show this help message and exit\n\u003e   -l {h,v,horizontal,vertical}, --layout {h,v,horizontal,vertical}\n\u003e                         How to display notifications. `horizontal` = as many of\n\u003e                         the last notifications that fit on a single line, clear\n\u003e                         out the old ones. `vertical` = keep printing new\n\u003e                         notifications on new lines.\n\u003e   --test NB_ITEMS       Print NB_ITEMS fake notifications and quit.\n\u003e   --send NB_ITEMS       Send NB_ITEMS fake notifications on the D-Bus and quit.\n\n\nDisplay\n-------\n\nEach notification is displayed as a colored block made of up to four segments,\nshowing in order:\n1. the *date*,\n2. the *application* having issued the notification,\n3. the *summary* of the notification (e.g. chat systems usually display the user, here),\n4. the *body* of the message.\n\nThe color of the notification block's application and summary depends\non the *urgency* of the notification:\n- *low* in green,\n- *normal* in blue,\n- *critical* in orange,\n- *unknown* in light purple.\n\n\nSignaling\n---------\n\nThe CLI bard does respond to POSIX \"user signals\".\nSignals can be issued with the `kill` command, using the `--signal` flag along\nwith 10 (SIGUSR1) or 12 (SIGUSR2) as an argument.\nSIGUSR1 will refresh the display, SIGUSR2 will erase any notification in the\ncache and clear the display (if it can).\n\nNote that with the horizontal layout, refreshing the display actually changes\nthe display. Erasing the cache will remove any on-screen notification\nif you use the horizontal layout.\nWith the vertical layout, this does nothing on the display.\n\n\nLayouts\n=======\n\nThe default layout is the horizontal one.\n\nHorizontal\n----------\n\n![Screenshot of the horizontal layout](https://github.com/nojhan/clibard/blob/main/doc/screenshot_horizontal.png?raw=true)\n\nThis will display on a single line, and overwrite it as soon as an update is\nreceived.\nDates are given in a \"natural\" human-readable way.\nWhen refreshing its display in the horizontal layout, the displayed dates will\nbe refreshed as well.\nHowever, it does not show all the cached notifications, but only the few last\nones that can fit the current width of the terminal.\n\n\nVertical\n--------\n\nThe vertical layout simply prints a new line as soon as the CLI bard receive\na notification. The display cannot be cleared nor refreshed.\nMost notably, date is displayed in the ISO-8601 format, down to the minute.\nHowever, your terminal should retain all the received notifications,\nif you can scroll back enough.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnojhan%2Fclibard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnojhan%2Fclibard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnojhan%2Fclibard/lists"}