{"id":30662622,"url":"https://github.com/justus0405/diskcord","last_synced_at":"2026-05-05T04:11:37.771Z","repository":{"id":312432300,"uuid":"1047478952","full_name":"Justus0405/Diskcord","owner":"Justus0405","description":"🔍 Drive health check daemon with discord integration","archived":false,"fork":false,"pushed_at":"2025-08-30T16:08:46.000Z","size":12,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T16:19:39.547Z","etag":null,"topics":["alert","background-service","bash","daemon","discord","discord-webhook","disk-health","drive","drive-health","homelab","homelabbing","homeserver","lightweight","linux","monitoring","nvme","smartmontools","ssd","ssd-health-monitor","webhook"],"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/Justus0405.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":"2025-08-30T14:11:38.000Z","updated_at":"2025-08-30T16:08:49.000Z","dependencies_parsed_at":"2025-08-30T16:19:40.984Z","dependency_job_id":"0fcfc964-153e-44f6-8b4b-e7d9769b9896","html_url":"https://github.com/Justus0405/Diskcord","commit_stats":null,"previous_names":["justus0405/diskcord"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Justus0405/Diskcord","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FDiskcord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FDiskcord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FDiskcord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FDiskcord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Justus0405","download_url":"https://codeload.github.com/Justus0405/Diskcord/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FDiskcord/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273010975,"owners_count":25030369,"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-08-31T02:00:09.071Z","response_time":79,"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":["alert","background-service","bash","daemon","discord","discord-webhook","disk-health","drive","drive-health","homelab","homelabbing","homeserver","lightweight","linux","monitoring","nvme","smartmontools","ssd","ssd-health-monitor","webhook"],"created_at":"2025-08-31T16:49:09.201Z","updated_at":"2026-05-05T04:11:37.757Z","avatar_url":"https://github.com/Justus0405.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"left\"\u003e\n    \u003c!-- Discord Badge --\u003e\n    \u003ca href=\"https://discord.justus0405.com/\"\u003e\u003cimg src=\"https://img.shields.io/discord/1370519315400495234?logo=Discord\u0026colorA=1e1e2e\u0026colorB=a6e3a1\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Version Badge --\u003e\n    \u003ca href=\"https://github.com/Justus0405/Diskcord/blob/main/diskcord\"\u003e\u003cimg src=\"https://img.shields.io/badge/Version-1.1-blue?colorA=1e1e2e\u0026colorB=cdd6f4\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n    \u003c!-- Stars Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/Diskcord/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/Justus0405/Diskcord?colorA=1e1e2e\u0026colorB=b7bdf8\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Issues Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/Diskcord/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/Justus0405/Diskcord?colorA=1e1e2e\u0026colorB=f5a97f\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Contributors Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/Diskcord/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/Justus0405/Diskcord?colorA=1e1e2e\u0026colorB=a6da95\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Diskcord\n\nDiskcord is a lightweight daemon written in bash that monitors the health of your drives and sends periodic updates to a Discord channel via webhook. It checks S.M.A.R.T. data to provide detailed insights about your storage devices, helping you stay ahead of potential failures.\n\n## Features\n\n- Lightweight: The script is written in just a few hundret lines of bash code.\n- Background Service: Runs continuously as a daemon to keep your drives under watch.\n- S.M.A.R.T Monitoring: Checks various drive statistics.\n- Discord Integration: Sends formatted notifications to your Discord webhook.\n- Customizable: Select which drives to monitor and how often to check them.\n\n## Notes\n\nThe check interval must be formatted as:\n\n- 60s for seconds\n- 60m for minutes\n- 12h for hours\n- 1d for days\n- empty, run only once at boot\n\nThis allows Diskcord to schedule health checks at the desired frequency.\n\n# Examples\n\nEither run yourself once:\n\n```shell\n./diskcord\n```\n\nOr run in the background every 1h:\n\n```shell\n./diskcord install 1h\n```\n\n## Preview\n\n| Passed                                                                                                                              | Failed                                                                                                                              |\n| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |\n| \u003cimg width=\"350\" height=\"475\" alt=\"passed\" src=\"https://github.com/user-attachments/assets/0bb37e32-b4e5-4732-93fe-0e24b57857e9\" /\u003e | \u003cimg width=\"350\" height=\"475\" alt=\"failed\" src=\"https://github.com/user-attachments/assets/d73fa750-39ea-4d6d-8e0c-c3841a37b32f\" /\u003e |\n\n## Dependencies\n\n```plaintext\njq\ncurl\nsmartmontools\nnvme-cli\n```\n\n## Installation\n\n1. Clone the repository:\n\n```shell\ngit clone --depth 1 https://github.com/Justus0405/Diskcord.git\n```\n\n2. Navigate to the directory:\n\n```shell\ncd Diskcord\n```\n\n3. Make the script executable:\n\n```shell\nchmod +x diskcord\n```\n\n4. Edit the script to configure for which drives to check, webhook url and optionally a user id for pings:\n\n```shell\nnano diskcord\n```\n\n5. Run the script with the install and either a period argument or without:\n\n```shell\n./diskcord install 1d\n```\n\n## Usage\n\n```plaintext\nusage: diskcord [...]\narguments:\n         install 60s, 60m, 12h, or 1d, for seconds, minutes, hours, days.\n         uninstall\n         60s, 60m, 12h, or 1d, for seconds, minutes, hours, days.\n         help\n         version\n```\n\n#\n\n\u003cp align=\"center\"\u003e\n\tCopyright \u0026copy; 2025-present \u003ca href=\"https://github.com/Justus0405\" target=\"_blank\"\u003eJustus0405\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/Justus0405/Diskcord/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/Justus0405/Diskcord?logo=Github\u0026colorA=1e1e2e\u0026colorB=cba6f7\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustus0405%2Fdiskcord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustus0405%2Fdiskcord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustus0405%2Fdiskcord/lists"}