{"id":15163142,"url":"https://github.com/codegoalie/golibnotify","last_synced_at":"2025-10-25T00:31:59.601Z","repository":{"id":57514919,"uuid":"243613050","full_name":"codegoalie/golibnotify","owner":"codegoalie","description":"Go bindings for libnotify -- Create and update OS notifications in linux","archived":false,"fork":false,"pushed_at":"2024-07-22T10:16:27.000Z","size":25,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T04:51:20.672Z","etag":null,"topics":["debian","libnotify","notifications","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"C","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/codegoalie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-27T20:44:07.000Z","updated_at":"2024-09-15T03:02:37.000Z","dependencies_parsed_at":"2022-09-16T23:41:23.308Z","dependency_job_id":null,"html_url":"https://github.com/codegoalie/golibnotify","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgolibnotify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgolibnotify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgolibnotify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgolibnotify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codegoalie","download_url":"https://codeload.github.com/codegoalie/golibnotify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238053514,"owners_count":19408699,"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":["debian","libnotify","notifications","ubuntu"],"created_at":"2024-09-27T02:04:14.626Z","updated_at":"2025-10-25T00:31:54.306Z","avatar_url":"https://github.com/codegoalie.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# golibnotify\n\n`golibnotify` implements go bindings for\n[`libnotify`](https://developer.gnome.org/libnotify/unstable/) to create, send,\nand update OS level notifications. It does not shell out to `notify-send` so it\ncan update existing notifications as well as create new ones.\n\n[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go\u0026logoColor=white\u0026style=flat-square)](https://pkg.go.dev/github.com/codegoalie/golibnotify?tab=doc)\n[![Go Report Card](https://goreportcard.com/badge/github.com/codegoalie/golibnotify)](https://goreportcard.com/report/github.com/codegoalie/golibnotify)\n![GitHub](https://img.shields.io/github/license/codegoalie/golibnotify?style=flat-square)\n[![Sourcegraph Badge](https://sourcegraph.com/github.com/codegoalie/golibnotify/-/badge.svg)](https://sourcegraph.com/github.com/codegoalie/golibnotify?badge)\n\n## Installation\n\nThis package requires CGO and the libnotify (`libnotify-dev`) shared library to be installed.\n\nOn Ubuntu or Debian using `apt`, you can install with `sudo apt-get install libnotify-dev`\n\n## Usage\n\n```go\n// Get an instance of a SimpleNotifier\nnotifier := golibnotify.NewSimpleNotifier(\"my-cool-app-name\")\n\n// Show a new notification\nerr = notifier.Show(\"A summary\", \"Some body text\", \"a/path/to/an/icon.png\")\n\n// Update an existing notification (or send a new one if one hasn't been sent)\nerr = notifier.Update(\"A new summary\", \"Some different body text\", \"another/path/to/icon.png\")\n\n// Remove an existing notification\nerr = notifier.Close()\n```\n\nSee also [examples](https://github.com/codegoalie/golibnotify/examples) for a complete example\n\n## Roadmap\n\n- [ ] Add API that returns a Notification instance to manage multiple notifications at once\n- [ ] Better support for notification icons (PixBuf?)\n- [ ] Support notification timeouts\n- [ ] Support notification urgencies\n\n## Contributions\n\nThanks for wanting to contribute!\n\n1. Open an issue describing your problem, solution, issue, suggestion, feature,\netc. to ensure it's likely to get merged.\n1. Fork the project.\n1. Make your changes.\n1. Open a PR against `master` here.\n1. Celebrate being awesome!\n\n## Author\n\n[@codegoalie](https://codegoalie.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodegoalie%2Fgolibnotify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodegoalie%2Fgolibnotify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodegoalie%2Fgolibnotify/lists"}