{"id":25298689,"url":"https://github.com/fmotalleb/nu_plugin_desktop_notifications","last_synced_at":"2026-04-15T03:01:57.874Z","repository":{"id":206183072,"uuid":"716028871","full_name":"fmotalleb/nu_plugin_desktop_notifications","owner":"fmotalleb","description":"A nushell plugin to send notification to desktop using notify-rust","archived":false,"fork":false,"pushed_at":"2026-04-09T01:11:07.000Z","size":573,"stargazers_count":50,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-09T03:15:13.942Z","etag":null,"topics":["desktop-notifications","notifications","nushell-plugin"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/fmotalleb.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-08T10:28:58.000Z","updated_at":"2026-04-09T01:11:15.000Z","dependencies_parsed_at":"2025-12-01T19:06:23.238Z","dependency_job_id":null,"html_url":"https://github.com/fmotalleb/nu_plugin_desktop_notifications","commit_stats":null,"previous_names":["fmotalleb/nu_plugin_desktop_notifications"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/fmotalleb/nu_plugin_desktop_notifications","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmotalleb%2Fnu_plugin_desktop_notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmotalleb%2Fnu_plugin_desktop_notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmotalleb%2Fnu_plugin_desktop_notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmotalleb%2Fnu_plugin_desktop_notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fmotalleb","download_url":"https://codeload.github.com/fmotalleb/nu_plugin_desktop_notifications/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmotalleb%2Fnu_plugin_desktop_notifications/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31824118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"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":["desktop-notifications","notifications","nushell-plugin"],"created_at":"2025-02-13T04:42:34.044Z","updated_at":"2026-04-15T03:01:57.837Z","avatar_url":"https://github.com/fmotalleb.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔔 nu_plugin_desktop_notifications  \n\nA [Nushell](https://www.nushell.sh/) plugin for sending desktop notifications using [notify-rust](https://github.com/hoodie/notify-rust).  \n\n---\n\n## ✨ Features  \n\n- **Send notifications** with custom title, body, icon, and app name.  \n- **Supports macOS, Windows, and Linux (XDG Desktop)**.  \n- **Configurable timeout** (for macOS and XDG desktops).  \n- **Error handling** with optional crash reporting.  \n\n---\n\n## 📌 Usage  \n\n### **Sending a Notification**  \n\n```bash\nnotify -t \"Test notification body\" --summary \"Test title\"\n```  \n\n### **Flags**  \n\n- `-h, --help`                 → Show help message.  \n- `-s, --summary \u003cstring\u003e`     → Title of the notification.  \n- `-t, --body \u003cstring\u003e`        → Body message of the notification.  \n- `--subtitle \u003cstring\u003e`        → Subtitle (macOS \u0026 Windows only).  \n- `-a, --app-name \u003cstring\u003e`    → App name for the notification.  \n- `-i, --icon \u003cfilepath\u003e`      → Path to an icon for the notification.  \n- `--timeout \u003cduration\u003e`       → Duration before the notification disappears _(macOS \u0026 XDG Desktop only)_. Defaults to system settings.  \n- `--crash-on-error \u003cfilepath\u003e` → Return an error if the notification fails.  \n\n---\n\n## 🎯 Example: Notify on Task Completion  \n\nSend a notification after a task completes, displaying the elapsed time:  \n\n![image](https://github.com/FMotalleb/nu_plugin_desktop_notifications/assets/30149519/a4fbc2a9-6537-4d18-8d98-e55ebcd6b0bd)  \n\n```bash\ndef \"notify on done\" [\n    task: closure\n] {\n    let start = date now\n    let result = do $task\n    let end = date now\n    let total = $end - $start | format duration sec\n    let body = $\"Task completed in ($total)\"\n    notify -s \"Task Finished\" -t $body\n    return $result\n}\n\nnotify on done { port scan 8.8.8.8 53 }\n```  \n\n---\n\n## 🔧 Installation  \n\n### 🚀 Recommended: Using [nupm](https://github.com/nushell/nupm)  \n\n```bash\ngit clone https://github.com/FMotalleb/nu_plugin_desktop_notifications.git  \nnupm install --path nu_plugin_desktop_notifications -f  \n```  \n\n### 🛠️ Manual Compilation  \n\n```bash\ngit clone https://github.com/FMotalleb/nu_plugin_desktop_notifications.git  \ncd nu_plugin_desktop_notifications  \ncargo build -r  \nregister target/release/nu_plugin_desktop_notifications  \n```  \n\n### 📦 Install via Cargo (using git)  \n\n```bash\ncargo install --git https://github.com/FMotalleb/nu_plugin_desktop_notifications.git  \nregister ~/.cargo/bin/nu_plugin_desktop_notifications  \n```  \n\n### 📦 Install via Cargo (crates.io) _Not Recommended_  \n\u003e\n\u003e _Since I live in Iran and crates.io often restricts package updates, the version there might be outdated._  \n\n```bash\ncargo install nu_plugin_desktop_notifications  \nregister ~/.cargo/bin/nu_plugin_desktop_notifications  \n```  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffmotalleb%2Fnu_plugin_desktop_notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffmotalleb%2Fnu_plugin_desktop_notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffmotalleb%2Fnu_plugin_desktop_notifications/lists"}