{"id":31946763,"url":"https://github.com/digitallyrefined/ha-hwmon_temp","last_synced_at":"2026-04-19T17:11:32.654Z","repository":{"id":312446486,"uuid":"1047532578","full_name":"DigitallyRefined/ha-hwmon_temp","owner":"DigitallyRefined","description":"Monitor hardware temperatures from /sys/class/hwmon in Home Assistant","archived":false,"fork":false,"pushed_at":"2025-10-06T06:35:46.000Z","size":48,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T08:43:37.681Z","etag":null,"topics":["cpu-monitoring","custom-components","disk-monitoring","hacs-integration","home-assistant","hwmon","hwmonitor"],"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/DigitallyRefined.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE.txt","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},"funding":{"patreon":"DigitallyRefined"}},"created_at":"2025-08-30T16:23:04.000Z","updated_at":"2025-10-06T06:35:42.000Z","dependencies_parsed_at":"2025-08-30T18:25:36.046Z","dependency_job_id":"c9f96fa1-4140-4b0d-aeb9-220f568f1c19","html_url":"https://github.com/DigitallyRefined/ha-hwmon_temp","commit_stats":null,"previous_names":["digitallyrefined/ha-hwmon_temp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/DigitallyRefined/ha-hwmon_temp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-hwmon_temp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-hwmon_temp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-hwmon_temp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-hwmon_temp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DigitallyRefined","download_url":"https://codeload.github.com/DigitallyRefined/ha-hwmon_temp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-hwmon_temp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019102,"owners_count":26086513,"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-10-14T02:00:06.444Z","response_time":60,"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":["cpu-monitoring","custom-components","disk-monitoring","hacs-integration","home-assistant","hwmon","hwmonitor"],"created_at":"2025-10-14T11:23:03.395Z","updated_at":"2025-10-14T11:23:10.413Z","avatar_url":"https://github.com/DigitallyRefined.png","language":"Python","funding_links":["https://patreon.com/DigitallyRefined"],"categories":[],"sub_categories":[],"readme":"# HWMON Temperatures\n\n[![Validate with hassfest](https://github.com/DigitallyRefined/ha-hwmon_temp/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/DigitallyRefined/ha-hwmon_temp/actions/workflows/hassfest.yaml)\n[![HACS Validate](https://github.com/DigitallyRefined/ha-hwmon_temp/actions/workflows/hacs_action.yml/badge.svg)](https://github.com/DigitallyRefined/ha-hwmon_temp/actions/workflows/hacs_action.yml)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-blue.svg)](https://github.com/custom-components/hacs)\n\n![downloads](https://img.shields.io/github/downloads/DigitallyRefined/ha-hwmon_temp/total.svg)\n![downloads](https://img.shields.io/github/downloads/DigitallyRefined/ha-hwmon_temp/latest/total.svg)\n\nMonitor hardware temperatures from `/sys/class/hwmon` in Home Assistant. This integration provides real-time temperature monitoring for various hardware components including CPUs, storage devices, and other temperature sensors accessible through the Linux hardware monitoring subsystem.\n\n## Features\n\n- **Automatic Discovery**: Automatically detects and monitors all available temperature sensors\n- **Real-time Updates**: Configurable polling intervals for temperature readings\n- **Device Classification**: Intelligent naming and categorization of temperature sensors\n- **Multiple Device Support**: Monitors various hardware components simultaneously\n\n## Supported Devices\n\nThis integration can monitor temperatures from various hardware components including:\n\n- **CPU Temperature Sensors**\n  - Intel Core processors (via `coretemp` module)\n  - AMD processors (via `k10temp` module)\n  - ARM processors (via thermal zones)\n- **Storage Devices**\n  - NVMe SSDs (via `nvme` module)\n  - SATA SSDs and HDDs (via `drivetemp` module)\n  - SMART-enabled drives\n- **Motherboard Sensors**\n  - Various motherboard temperature sensors\n  - System temperature monitoring\n- **Other Hardware**\n  - GPU temperature sensors (when available via hwmon)\n  - Custom temperature sensors\n\n## Prerequisites\n\n### Linux Kernel Modules\n\nTo use this integration, you need to ensure the appropriate Linux kernel modules are loaded for your hardware. The required modules depend on your specific hardware: see [HWMON Setup](#hwmon-setup)\n\n## Installation\n\n### HACS (recommended)\n\nIf you dont' have [HACS](https://hacs.xyz) installed yet, I highly recommend it.  \n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=DigitallyRefined\u0026repository=ha-hwmon_temp\u0026category=integration)  \nOr search for `HWMON Temperatures` in HACS or copy this GitHub URL and add it as a custom integration repository.\n\n### Manual installation\n\n[Download the latest `hwmon_temp.zip` release](https://github.com/DigitallyRefined/ha-hwmon_temp/releases) and extract it into your `\u003cconfig\u003e/custom_component` folder.\n\n## Configuration\n\nAfter installation you need to **restart** Home Assistant before using this integration.\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=hwmon_temp)  \n\nOr\n\n1. Go to **Settings** → **Devices \u0026 Services**\n2. Click **Add Integration**\n3. Search for \"HWMON Temperatures\"\n4. Click on the integration\n5. Configure the update interval (default: 30 seconds)\n6. Click **Submit**\n\n### Configuration Options\n\n- **Update Interval**: How often to poll for temperature updates (in seconds)\n  - Minimum: 10 seconds\n  - Recommended: 30-60 seconds\n  - Default: 30 seconds\n\n## Usage\n\n### Available Sensors\n\nOnce configured, the integration will automatically create temperature sensors for each detected hardware component. Sensor names are automatically generated based on the hardware type:\n\n- **CPU sensors**: `Core 0`, `Core 1`, `Package`, etc.\n- **Storage devices**: Device model names (e.g., `Samsung SSD 970 EVO Plus`)\n- **Motherboard sensors**: Component names (e.g., `System`, `CPU`, `Motherboard`)\n\n### Dashboard Integration\n\nAdd temperature sensors to your Home Assistant dashboard:\n\n```yaml\ntype: history-graph\ntitle: CPU temperatures\nentities:\n  - entity: sensor.dev_cpu_package_id_...\n  - entity: sensor.dev_cpu_pch_...\n  - entity: sensor.dev_cpu_acpitz\nhours_to_show: 12\n```\n\n```yaml\ntype: history-graph\ntitle: Disk temperatures\nentities:\n  - entity: sensor.dev_nvme0_...\n  - entity: sensor.dev_nvme1_...\nhours_to_show: 12\n```\n\n![screenshot](screenshot.webp)\n\n### Automations\n\nYou can create automations based on temperature thresholds:\n\n```yaml\n# Example automation for high CPU temperature\nautomation:\n  - alias: \"High CPU Temperature Alert\"\n    trigger:\n      platform: numeric_state\n      entity_id: sensor.core_0_temperature\n      above: 80\n    action:\n      - service: notify.mobile_app\n        data:\n          message: \"CPU temperature is high: {{ states('sensor.core_0_temperature') }}°C\"\n```\n\n## Troubleshooting\n\n### No Temperature Sensors Found\n\n**Note** this may not work correctly if you're running Home Assistant inside of a virtual machine, unless `/sys/class/hwmon/` is specifically shared from host machine to the guest machine.\n\n1. **Check kernel modules**:\n\n   ```bash\n   lsmod | grep -E \"(coretemp|k10temp|nvme|drivetemp)\"\n   ```\n\n2. **Verify hwmon directory**:\n\n   ```bash\n   ls -la /sys/class/hwmon/\n   ```\n\n3. **Check permissions**:\n\n   ```bash\n   ls -la /sys/class/hwmon/hwmon*/temp*_input\n   ```\n\n### Permission Denied Errors\n\nIf you encounter permission issues, ensure the Home Assistant process has read access to `/sys/class/hwmon/`:\n\n```bash\n# Check Home Assistant user\nps aux | grep homeassistant\n\n# Verify file permissions\nls -la /sys/class/hwmon/\n```\n\n### Missing Specific Hardware\n\nIf specific hardware isn't detected:\n\n1. **Load required kernel modules** (see [HWMON Setup](#hwmon-setup))\n2. **Run sensors-detect**:\n\n   ```bash\n   sudo sensors-detect\n   ```\n\n3. **Check hardware compatibility** with your Linux distribution\n\n### HWMON Setup\n\n### CPU Temperature Monitoring\n\n```bash\n# For Intel processors\nsudo modprobe coretemp\n\n# For AMD processors\nsudo modprobe k10temp\n\n# For ARM processors (usually built-in)\n# No additional module needed\n```\n\n#### Storage Device Temperature Monitoring\n\n```bash\n# For NVMe drives\nsudo modprobe nvme\n\n# For SATA drives with temperature support\nsudo modprobe drivetemp\n\n# For SMART-enabled drives\nsudo modprobe smart\n```\n\n#### Motherboard Sensors\n\n```bash\n# Common motherboard sensor modules\nsudo modprobe lm_sensors\nsudo modprobe it87\nsudo modprobe k8temp\nsudo modprobe fam15h_power\n```\n\n#### Verifying Hardware Support\n\nCheck if your hardware is detected:\n\n```bash\n# List all hwmon devices\nls -la /sys/class/hwmon/\n\n# Check specific hwmon device details\ncat /sys/class/hwmon/hwmon*/name\n\n# List temperature sensors\nfind /sys/class/hwmon -name \"temp*_input\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitallyrefined%2Fha-hwmon_temp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitallyrefined%2Fha-hwmon_temp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitallyrefined%2Fha-hwmon_temp/lists"}