homebridge-rpi-temperature
v1.0.5
Published
A Homebridge plugin that displays Raspberry Pi CPU temperature in Apple Home.
Maintainers
Readme
Homebridge Rpi Temperature
A Homebridge plugin that displays the Raspberry Pi CPU temperature in Apple Home.
Features
- Raspberry Pi CPU temperature sensor
- Automatic thermal zone detection
- Automatic Raspberry Pi model detection
- Automatic Raspberry Pi serial number detection
- Raspberry Pi information shown in Apple Home
- Plugin version shown as the HomeKit firmware revision
- Configurable update interval
- Update interval from 1 to 3600 seconds
- Default update interval of 10 seconds
- Celsius and Fahrenheit support
- Homebridge UI configuration
- Compatible with Homebridge 2.x
Requirements
- Raspberry Pi
- Homebridge 2.x
- Node.js 22 or newer
Installation
Install the plugin through the Homebridge UI.
- Open Homebridge.
- Go to Plugins.
- Search for
homebridge-rpi-temperature. - Install the plugin.
- Restart Homebridge.
Configuration
The plugin can be configured through the Homebridge UI.
Name
The name of the temperature sensor.
Default:
Raspberry Pi Temperature
Update Interval
Defines how often the temperature is updated.
The value is specified in seconds.
- Minimum: 1 second
- Default: 10 seconds
- Maximum: 3600 seconds
Temperature Unit
The plugin supports Celsius and Fahrenheit.
The temperature unit can be selected through the Homebridge UI configuration.
When Fahrenheit is selected, the temperature value provided to HomeKit is converted from Celsius to Fahrenheit.
When Celsius is selected, the original Celsius value is provided to HomeKit.
Raspberry Pi Information
The plugin automatically detects information from the Raspberry Pi.
Manufacturer
The manufacturer is shown as:
Raspberry Pi
Model
The Raspberry Pi model is detected automatically.
Example:
Raspberry Pi 5 Model B Rev 1.1
Serial Number
The Raspberry Pi serial number is detected automatically from the system.
Example:
2369f20e32742b77
Firmware Revision
The firmware revision shown in Apple Home corresponds to the installed plugin version.
For version 1.0.1:
1.0.1
When the plugin is updated, the firmware revision automatically changes to the new plugin version.
Temperature Detection
The plugin automatically detects the Raspberry Pi thermal zone.
The temperature is read from the Linux thermal zone available under:
/sys/class/thermal/
The plugin uses the appropriate CPU thermal zone available on the Raspberry Pi.
Logging
During startup, the plugin reports the detected thermal zone.
Example:
[Raspberry Pi Temperature] Initializing RaspberryPiTemperature accessory...
[Raspberry Pi Temperature] Initializing Raspberry Pi Temperature plugin.
[Raspberry Pi Temperature] Using thermal zone: /sys/class/thermal/thermal_zone0
[Raspberry Pi Temperature] Raspberry Pi Temperature plugin initialized.The plugin does not log every temperature update.
Troubleshooting
Check the thermal zone
Run:
ls -la /sys/class/thermal/You can also check the current temperature with:
cat /sys/class/thermal/thermal_zone0/tempA result such as:
45000means:
45.0 °C
Check the Raspberry Pi model
Run:
grep "^Model" /proc/cpuinfoExample:
Model : Raspberry Pi 5 Model B Rev 1.1Check the Raspberry Pi serial number
Run:
grep "^Serial" /proc/cpuinfoExample:
Serial : 2369f20e32742b77Check the plugin version
Run:
cd /var/lib/homebridge/node_modules/homebridge-rpi-temperatureThen:
grep '"version"' package.jsonFor version 1.0.1:
"version": "1.0.1"Check JavaScript syntax
Run:
node --check index.jsNo output means the JavaScript syntax is valid.
Development
Project files:
homebridge-rpi-temperature/
├── index.js
├── package.json
├── package-lock.json
├── config.schema.json
├── README.md
├── LICENSE
└── .gitignoreAuthor
Created and maintained by chris188.
Support
If you find this plugin useful and would like to support its development, you can buy me a coffee. ☕️
Thank you for supporting open-source development!
License
MIT License
Copyright (c) 2026 chris188
