{"id":31699175,"url":"https://github.com/damachine/coolerdash","last_synced_at":"2026-06-27T02:01:56.938Z","repository":{"id":303695878,"uuid":"1015699615","full_name":"damachine/coolerdash","owner":"damachine","description":"Monitor telemetry data on an AIO liquid cooler with an integrated LCD display","archived":false,"fork":false,"pushed_at":"2026-01-24T23:31:04.000Z","size":5696,"stargazers_count":24,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-25T16:19:58.788Z","etag":null,"topics":["cooler","cooling","cpu-monitoring","gpu-monitoring","hwmon","kraken","lcd","linux","liquid","liquidctl","nzxt","watercooling"],"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/damachine.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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},"funding":{"github":"damachine","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null}},"created_at":"2025-07-07T22:59:28.000Z","updated_at":"2026-01-21T22:08:17.000Z","dependencies_parsed_at":"2025-11-24T01:05:55.332Z","dependency_job_id":null,"html_url":"https://github.com/damachine/coolerdash","commit_stats":null,"previous_names":["damachine/aiolcdcam","damachine/coolerdash"],"tags_count":99,"template":false,"template_full_name":null,"purl":"pkg:github/damachine/coolerdash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damachine%2Fcoolerdash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damachine%2Fcoolerdash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damachine%2Fcoolerdash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damachine%2Fcoolerdash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/damachine","download_url":"https://codeload.github.com/damachine/coolerdash/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damachine%2Fcoolerdash/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28963593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T00:42:38.011Z","status":"ssl_error","status_checked_at":"2026-02-01T00:42:35.920Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cooler","cooling","cpu-monitoring","gpu-monitoring","hwmon","kraken","lcd","linux","liquid","liquidctl","nzxt","watercooling"],"created_at":"2025-10-08T19:15:25.506Z","updated_at":"2026-06-27T02:01:56.932Z","avatar_url":"https://github.com/damachine.png","language":"C","funding_links":["https://github.com/sponsors/damachine"],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://en.wikipedia.org/wiki/C99\"\u003e\u003cimg src=\"https://img.shields.io/badge/C-99-blue.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://kernel.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Platform-Linux-green.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/damachine/coolerdash/actions/workflows/github-code-scanning/codeql\"\u003e\u003cimg src=\"https://github.com/damachine/coolerdash/actions/workflows/github-code-scanning/codeql/badge.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n# CoolerDash 🐧\n\n#### This tool allows you to monitoring (display) real-time telemetry data from sensors on an AIO liquid cooler with an integrated LCD display.\n\n\u003e Use it successfully myself – maybe it will help you too! ❤️\n\n---\n## Features\n- **Plug-In that extends the LCD functionality of [CoolerControl](https://gitlab.com/coolercontrol/coolercontrol)**\n- **Support for additional sensor values (CPU/GPU/Liquid)**\n- **Integrated UI interface for customizing all settings**  \n- **Display modes - for now**\n  - **Dual Mode (default):** Shows CPU and GPU temperatures simultaneously\n  - **Circle Mode (beta):** Alternates between CPU and GPU switch every 5 sec\n\n\u003e ##### Special thanks to [@codifryed](https://github.com/codifryed), the founder of CoolerControl\n\n\u003ca href=\"https://discord.com/channels/908873022105079848/1461781766791499981\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-Join%20CoolerDash%20Discussion-blue?logo=discord\"\u003e\u003c/a\u003e\n\nhttps://github.com/user-attachments/assets/3fc71b81-8c6a-4e81-a600-4b2dcff2452a\n\n---\n\n## System Requirements\n\n\u003e [!WARNING]\n\u003e Version 2.0.4+ runs as a CoolerControl plugin.\n\u003e This requires CoolerControl \u003e=3.1.0 with plugin support.   \n\n- **OS**: Linux (systemd or OpenRC)\n- **CoolerControl**: Version \u003e=3.1.0 REQUIRED - must be installed and running [Installation Guide](https://gitlab.com/coolercontrol/coolercontrol/-/blob/main/README.md)\n- **CPU**: x86-64-v3 compatible (Intel Haswell+ / AMD Excavator+)\n- **LCD**: AIO liquid cooler LCD displays **(NZXT, etc.)**\n\n\u003e See the [Supported Devices](https://github.com/damachine/coolerdash/blob/master/docs/devices.md) for confirmed working hardware. In principle, all devices supported by CoolerControl/[liquidctl](https://github.com/liquidctl/liquidctl?tab=readme-ov-file#supported-devices) should work with CoolerDash. You can [submit a device confirmation](https://github.com/damachine/coolerdash/issues/new?template=device-confirmation.yml) to help expand the list.\n\n---\n\n## Installation\n\n#### Arch-based distributions\n\n[![AUR](https://img.shields.io/aur/version/coolerdash-git?color=blue\u0026label=AUR)](https://aur.archlinux.org/packages/coolerdash-git)\n\n```bash\n# STEP 1: Install\nyay -S coolerdash-git\n#OR any other AUR helper\n```\n\n**Distributions pre-builted packages:**\n\n[![Debian/Ubuntu](https://img.shields.io/badge/Debian%2FUbuntu-Download-orange?logo=debian)](https://github.com/damachine/coolerdash/releases/latest)\n[![Fedora](https://img.shields.io/badge/Fedora-Download-blue?logo=fedora)](https://github.com/damachine/coolerdash/releases/latest)\n[![CentOS/RHEL](https://img.shields.io/badge/CentOS%2FRHEL-Download-green?logo=centos)](https://github.com/damachine/coolerdash/releases/latest)\n[![openSUSE](https://img.shields.io/badge/openSUSE-Download-brightgreen?logo=opensuse)](https://github.com/damachine/coolerdash/releases/latest)\n\n#### Manual installation: All distributions\n\n[![Multi-Distribution Installation Test](https://github.com/damachine/coolerdash/actions/workflows/install.yml/badge.svg)](https://github.com/damachine/coolerdash/actions/workflows/install.yml)\n\n```bash\n# STEP 1: Clone repository\ngit clone https://github.com/damachine/coolerdash.git\ncd coolerdash\n\n# STEP 2: Build and install (auto-detects Linux distribution and installs dependencies)\nmake install\n```\n\n\u003e For manual installations, make sure all required dependencies are installed correctly. Manual installations need to be updated manually.\n\n---\n\n## Configuration\n\n**Start CoolerControl Service (if not already enabled):**\n```bash\n# systemd\nsystemctl enable --now coolercontrold.service\n\n# OpenRC\nrc-update add coolercontrold default\nrc-service coolercontrold start\n```\n\n**CoolerDash Configuration (optional):**\n\nIn the CoolerControl settings menu, under the plugin tab (beta), you can now use the CoolerDash UI to make your custome settings.\nRestart CoolerControl to apply changes: `systemctl restart coolercontrold.service` or `rc-service coolercontrold restart`.\n\n\u003cdetails\u003e\n  \u003csummary\u003eScreenshots\u003c/summary\u003e\n  \n  comming soon...\n\n\u003c/details\u003e\n\n---\n\n## Advanced Usage\n\n\u003cdetails\u003e\n  \u003csummary\u003eExpand\u003c/summary\u003e\n\n#### Build Commands\n\n```bash\nmake            # Standard C99 build\nmake clean      # Clean up\nmake install    # System installation with dependency auto-detection\nmake uninstall  # Remove installation (service, binary, files)\nmake debug      # Debug build with AddressSanitizer\nmake help       # Show all options\n```\n\n#### Debugging Steps\n\n```bash\n# 1. Check CoolerControl status\nsystemctl status coolercontrold\n# or on OpenRC:\nrc-service coolercontrold status\ncurl http://localhost:11987/devices\n\n# 2. Test CoolerDash manually (with clean output)\n/usr/libexec/coolerdash/coolerdash\n\n# 3. Test CoolerDash with detailed verbose logging\n/usr/libexec/coolerdash/coolerdash --verbose\n# or short form:\n/usr/libexec/coolerdash/coolerdash -v\n\n# 4. Debug build and installation (recommended)\n# Option A — Build and install with ASan in one command (safe):\nsudo make debug install\n\n# Option B — Build as your user and install the debug binary manually (recommended):\nmake clean \u0026\u0026 make debug\nsudo install -Dm755 bin/coolerdash /usr/libexec/coolerdash/coolerdash\n\n# Notes:\n#  • Avoid running `make debug` followed by `sudo make install` — the separate `sudo make install` may trigger a rebuild without debug flags and cause linker errors (missing ASan symbols).\n#  • If you previously built as root and own files are root-owned, fix ownership before rebuilding:\n#    sudo chown -R $USER:$USER build bin\n\n# 5. Check plugin logs (STATUS messages always visible)\njournalctl -xeu coolercontrold.service -f\n# On OpenRC, inspect your configured system logger for CoolerControl/coolerdash output.\n\n# 6. View recent logs with context\njournalctl -u coolercontrold.service -n 50\n```\n\u003c/details\u003e\n\n---\n\n## Troubleshooting\n\n\u003cdetails\u003e\n  \u003csummary\u003eExpand\u003c/summary\u003e\n\n#### Installation Issues\nIf you see errors like \"conflicting files\" or \"manual installation detected\" during Arch/AUR `makepkg -si`, CoolerDash was previously installed manually via `make install`.\n\n**Solution:**\n```bash\nsudo make uninstall\n```\n\n#### Check CoolerControl devices\n\n```bash\nliquidctl --version\n# Expected: liquidctl v1.15.0 (or newer)\n```\n\n  ```bash\n  curl http://localhost:11987/devices | jq\n  ```\n\n  ```json\n  {\n        \"name\": \"NZXT Kraken 2023\",\n        \"type\": \"Liquidctl\",\n        \"type_index\": 1,\n        \"uid\": \"8d4becb03bca2a8e8d4213ac376a1094f39d2786f688549ad3b6a591c3affdf9\",\n        \"lc_info\": {\n          \"driver_type\": \"KrakenZ3\",\n          \"firmware_version\": \"2.0.0\",\n          \"unknown_asetek\": false\n        }\n  }\n  ```\n\u003c/details\u003e\n\n---\n## Documentation\n\n\u003cdetails\u003e\n  \u003csummary\u003eExpand\u003c/summary\u003e\n\n- **[Configuration Guide](https://github.com/damachine/coolerdash/blob/master/docs/config-guide.md)** - All configuration options\n- **[Supported Devices](https://github.com/damachine/coolerdash/blob/master/docs/devices.md)** - Confirmed working hardware\n- **[Display Modes Guide](https://github.com/damachine/coolerdash/blob/master/docs/display-modes.md)** - Dual and Circle mode reference\n- **[Developer Guide](https://github.com/damachine/coolerdash/blob/master/docs/developer-guide.md)** - Architecture and API integration\n- **[Display Detection](https://github.com/damachine/coolerdash/blob/master/docs/display-detection.md)** - Display shape detection\n- **[CoolerControl API Guide](https://github.com/damachine/coolerdash/blob/master/docs/coolercontrol-api.md)** - API module documentation\n\u003c/details\u003e\n\n---\n\n## Community \u0026 Support\n\n**Questions or ideas?** Join our [Discussions](https://github.com/damachine/coolerdash/discussions) or open an [Issue](https://github.com/damachine/coolerdash/issues).\n\n\u003ca href=\"https://github.com/damachine/coolerdash/discussions\"\u003e\u003cimg src=\"https://img.shields.io/github/discussions/damachine/coolerdash?style=flat-square\u0026logo=github\u0026label=Discussions\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/damachine/coolerdash/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/damachine/coolerdash?style=flat-square\u0026logo=github\u0026label=Issues\"\u003e\u003c/a\u003e\n\n**Support the project:**\n• ⭐ Star this repo\n• 🐛 Report bugs\n• 🔄 Share with others\n• 📝 Contribute\n• [![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-blue?logo=github-sponsors)](https://github.com/sponsors/damachine)\n\n[![Stargazers over time](https://starchart.cc/damachine/coolerdash.svg?variant=adaptive)](https://starchart.cc/damachine/coolerdash)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamachine%2Fcoolerdash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdamachine%2Fcoolerdash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamachine%2Fcoolerdash/lists"}