{"id":13595652,"url":"https://github.com/ms7m/notify-py","last_synced_at":"2025-12-14T07:59:41.717Z","repository":{"id":45887975,"uuid":"264371009","full_name":"ms7m/notify-py","owner":"ms7m","description":":speech_balloon: | A simple Python Module for sending cross-platform desktop notifications on Windows, macOS and Linux","archived":false,"fork":false,"pushed_at":"2024-04-08T13:59:26.000Z","size":16954,"stargazers_count":237,"open_issues_count":21,"forks_count":26,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-25T06:19:24.454Z","etag":null,"topics":["desktop-notifications","hacktoberfest","linux-notifications","mac-notifications","notifications","python","windows-notifications"],"latest_commit_sha":null,"homepage":"","language":"Python","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/ms7m.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":"2020-05-16T06:04:30.000Z","updated_at":"2024-06-05T16:34:12.132Z","dependencies_parsed_at":"2024-01-16T22:19:56.281Z","dependency_job_id":"1f6dc236-cf21-4694-94e6-93e17b96f6ad","html_url":"https://github.com/ms7m/notify-py","commit_stats":{"total_commits":194,"total_committers":10,"mean_commits":19.4,"dds":0.3041237113402062,"last_synced_commit":"0c09c6b76cbe941c394798c4c4c838d5840b3bb5"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms7m%2Fnotify-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms7m%2Fnotify-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms7m%2Fnotify-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms7m%2Fnotify-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ms7m","download_url":"https://codeload.github.com/ms7m/notify-py/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248049594,"owners_count":21039244,"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":["desktop-notifications","hacktoberfest","linux-notifications","mac-notifications","notifications","python","windows-notifications"],"created_at":"2024-08-01T16:01:54.604Z","updated_at":"2025-12-14T07:59:36.644Z","avatar_url":"https://github.com/ms7m.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n\u003cbr\u003e\n  \u003ch1\u003e notify.py \u003c/h1\u003e\n  \u003ci\u003e Cross platform desktop notifications for Python scripts and applications.\u003c/i\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/ms7m/notify-py/workflows/Test%20Linux/badge.svg\"\u003e\n    \u003cimg src=\"https://github.com/ms7m/notify-py/workflows/Test%20macOS/badge.svg\"\u003e\n    \u003cimg src=\"https://github.com/ms7m/notify-py/workflows/Test%20Windows/badge.svg\"\u003e\n  \u003c/p\u003e\n  \u003cbr\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Available-on%20PyPi-blue?logoColor=white\u0026logo=Python\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Python-3.6%2B-blue?logo=python\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Formatting-Black-black.svg\"\u003e\n  \u003c/p\u003e\n    \u003cp align=\"center\"\u003e\n      \u003cimg src=\"./docs/site/img/demopics.png\"\u003e\n    \u003ch1\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## Docs\n\nYou can read the docs on this Git's Wiki, or [here](https://ms7m.github.io/notify-py/)\n\n## Supported Platforms.\n\n- Windows 10/11\n- macOS 10 \u003e=10.10\n- Linux (libnotify)\n\nNo dependencies are required other than loguru \u0026 jeepney (Only for linux/DBUS).\n\n---\n\n## Install\n\n```\npip install notify-py\n```\n\n---\n\n## Usage\n\n**Send Simple Notification**\n\n```python\n\nfrom notifypy import Notify\n\nnotification = Notify()\nnotification.title = \"Cool Title\"\nnotification.message = \"Even cooler message.\"\nnotification.send()\n```\n\n**Send Notification With Icon**\n\n```python\n\nfrom notifypy import Notify\n\nnotification = Notify()\nnotification.title = \"Cool Title\"\nnotification.message = \"Even cooler message.\"\nnotification.icon = \"path/to/icon.png\"\n\nnotification.send()\n```\n\n**Send Notification With Sound**\n\n```python\n\nfrom notifypy import Notify\n\nnotification = Notify()\nnotification.title = \"Cool Title\"\nnotification.message = \"Even cooler message.\"\nnotification.audio = \"path/to/audio/file.wav\"\n\nnotification.send()\n\n```\n\n**Sending Notifications without blocking**\n\n```python\n\nfrom notifypy import Notify\n\nnotification = Notify()\nnotification.send(block=False)\n\n```\n\n**Sending with Default Notification Titles/Messages/Icons**\n\n```python\n\nfrom notifypy import Notify\n\nnotification = Notify(\n  default_notification_title=\"Function Message\",\n  default_application_name=\"Great Application\",\n  default_notification_icon=\"path/to/icon.png\",\n  default_notification_audio=\"path/to/sound.wav\"\n)\n\ndef your_function():\n  # stuff happening here.\n  notification.message = \"Function Result\"\n  notification.send()\n```\n\n---\n\n# CLI\nA CLI is available when you install notify-py\n\n```bash\nnotifypy --title --message --applicationName --iconPath --soundPath\n```\nYou may need to add ``python3 -m`` to the beginning.\n\n---\n\n## Important Caveats\n\n- As it stands (May 18, 2020), this is simply a notification service. There is _no_ support for embedding custom actions (buttons, dialogs) regardless of platform. Other then telling you if the shell command was sent, there is also no confirmation on user action on the notification.\n\n- macOS does **not** support custom icons on the fly.. You will need to bundle a customized version of the notifier embedded with your custom icon.\n\n---\n\n### Windows Specific.\n\n- No support for balloon tips (pre Win10).. This will be changed in the future.\n\n---\n\n### Contributors\n\n- [Leterax](https://github.com/Leterax)\n- [jnoortheen](https://github.com/jnoortheen)\n- [dynobo](https://github.com/dynobo)\n- [Xou](https://github.com/GiorgosXou)\n\n\n---\n\n### Inspiration and Special Thanks\n\n- https://github.com/go-toast/toast - Ported their Windows 10 toast notification to Python.\n\n- [Vítor Galvão](https://github.com/vitorgalvao) for https://github.com/vitorgalvao/notificator\n\n- https://notificationsounds.com/notification-sounds/done-for-you-612 example_notification_sound.wav\n\n- https://github.com/mikaelbr/node-notifier\n\n---\n\n# Contributing\n\nContributions are welcome!\n\nPlease base your changes on the latest development branch and open a PR to that branch. PR will not be accepted to the master branch. Tests are ran against all platforms.\n\n### Setting Up Environment\n\n- Install [Poetry](https://python-poetry.org/)\n  - `poetry install`\n- Add patches/new features/bug fiexes\n- Run tests\n  - `poetry run pytest tests/*`\n- Run lints\n  - `poetry run pylint --errors-only notifypy/`\n- Run Black Formatting\n  - `poetry run black notifypy`\n- Open PR to `dev` branch.\n- Add your name to contributors list if you wish!\n","funding_links":[],"categories":["OTHERS","Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms7m%2Fnotify-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fms7m%2Fnotify-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms7m%2Fnotify-py/lists"}