{"id":28238385,"url":"https://github.com/expertcoderz/broadcast","last_synced_at":"2025-06-11T01:31:42.589Z","repository":{"id":213038877,"uuid":"732857493","full_name":"Expertcoderz/broadcast","owner":"Expertcoderz","description":"Linux utility to run notify-send on all users","archived":true,"fork":false,"pushed_at":"2023-12-18T04:02:51.000Z","size":7,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-19T01:13:04.617Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Expertcoderz.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}},"created_at":"2023-12-18T02:37:29.000Z","updated_at":"2024-05-06T12:00:38.000Z","dependencies_parsed_at":"2023-12-18T04:44:27.009Z","dependency_job_id":null,"html_url":"https://github.com/Expertcoderz/broadcast","commit_stats":null,"previous_names":["expertcoderz/broadcast"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Expertcoderz%2Fbroadcast","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Expertcoderz%2Fbroadcast/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Expertcoderz%2Fbroadcast/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Expertcoderz%2Fbroadcast/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Expertcoderz","download_url":"https://codeload.github.com/Expertcoderz/broadcast/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Expertcoderz%2Fbroadcast/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259180916,"owners_count":22817831,"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":[],"created_at":"2025-05-19T01:12:50.977Z","updated_at":"2025-06-11T01:31:42.582Z","avatar_url":"https://github.com/Expertcoderz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# broadcast\n\nThis is a simple Linux utility, written in Bash, to run [`notify-send`](https://gitlab.gnome.org/GNOME/libnotify) on all users.\n\nIt includes the optional ability to queue notifications for offline individual users, that will be shown when they log in.\n\nNotifications can also be sent to administrators only, depending on the given configuration.\n\n\n## Usage\n\n```\n# broadcast [a[a]][q][v] ARGUMENTS...\n```\n\nWhere `ARGUMENTS...` are the usual arguments and options passed to `notify-send`. (See `notify-send(1)`).\n\nThe letters in the first (optional) argument to `broadcast` are flags that modify its behavior. They are as follows:\n\n- `a` — Send the notification to administrators only. Administrators are users belonging to any group listed in `ADMIN_GROUPS` in the config. If specified twice (`aa`), users belonging in `ADMIN_EXTRA_GROUPS` will receive the notification as well.\n\n- `q` — Queue notifications for offline users.\n\n- `v` — Enable verbose output.\n\n### Examples\n\n```\n# broadcast --urgency=normal 'This is a summary!' 'This is the notification body.'\n```\n\n```\n# broadcast q \"If you're reading this right upon logon that means you've probably missed something important.\"\n```\n\n### Configuration\n\nThe configuration file is located at `/etc/broadcast.conf` and is self-documenting.\n\n### Queueing Notifications\n\nThe `broadcast-dequeue` command is provided for users to receive missed notifications that were sent (with the `broadcast` `q` flag) when they were offline. A `broadcast-dequeue.service` systemd user unit is also included, that will run `broadcast-dequeue` upon logging into a graphical session.\n\nThe usage of `broadcast-dequeue` is described as follows:\n\n```\n$ broadcast-dequeue [v]\n```\n\nThe `v` flag enables verbose output if supplied.\n\nQueued notifications are stored in the file defined by `QUEUE_FILE_PATH` in the config. This defaults to `~/.broadcast`.\n\n\n## Dependencies\n\n- `notify-send` from libnotify, for sending the actual notifiations\n- `sudo`, for executing `notify-send` as each target user\n- `pgrep`, for getting currently running D-Bus session daemons\n\n\n## Contributing\n\nFeel free to submit bug fixes and feature( request)s.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpertcoderz%2Fbroadcast","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpertcoderz%2Fbroadcast","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpertcoderz%2Fbroadcast/lists"}