About
Senso4s Gas Cylinder Sensor is an integration for the Senso4s propane gas cylinder level sensor. It reads gas level, remaining gas, battery and signal strength locally over Bluetooth advertisements, and adds binary sensors for low gas, errors and calibration needs. On Plus models it also exposes temperature, incline and motion anomaly flags. An Estimated Empty prediction comes from consumption history, which can be read over brief active connections or, in passive-only mode, from percentage changes in advertisements. Actions cover calibrating the scale, refreshing history, writing the cylinder configuration and setting the measurement start date, and the options include a refill step and a recalibration step. Setup is done in the UI, and the device can be discovered automatically.
Automatic summary of the README and code of ksanislo/senso4s_ble. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Select Senso4s Device
- Device
New Device Setup
- Weight unitUnit for entering weight values
- Empty cylinder weightWeight of the empty gas cylinder without gas
- Gas capacityMaximum gas capacity of the cylinder
- Usage modePreset usage mode for the device
After setup
- Weight unitUnit for entering and displaying weight values
- Low level warning threshold (%)Gas level percentage that triggers low gas warning
- Enable automatic history pollingConnect to the device to read consumption history for the 'Estimated Empty' calculation. Disable if using passive-only Bluetooth hardware.
- History refresh interval (minutes)Maximum time between history refreshes — gas level changes also trigger an immediate refresh
- Gas volume per kg (m³/kg)Vapour volume one kilogram of liquid gas expands to, used by the Energy dashboard. The default 0.536 is propane at 15 °C; butane is about 0.407. Check the reference temperature your supplier bills at.
- Weight unitUnit for entering and displaying weight values
- Low level warning threshold (%)Gas level percentage that triggers low gas warning
- Enable automatic history pollingConnect to the device to read consumption history for the 'Estimated Empty' calculation. Disable if using passive-only Bluetooth hardware.
- History refresh interval (minutes)Maximum time between history refreshes — gas level changes also trigger an immediate refresh
- Gas volume per kg (m³/kg)Vapour volume one kilogram of liquid gas expands to, used by the Energy dashboard. The default 0.536 is propane at 15 °C; butane is about 0.407. Check the reference temperature your supplier bills at.
- Weight unitUnit for entering and displaying weight values
- Empty cylinder weightWeight of the empty gas cylinder without gas
- Gas capacityMaximum gas capacity of the cylinder
- Usage modePreset usage mode for the device
- Low level warning threshold (%)Gas level percentage that triggers low gas warning
- Enable automatic history pollingConnect to the device to read consumption history for the 'Estimated Empty' calculation. Disable if using passive-only Bluetooth hardware.
- History refresh interval (minutes)Maximum time between history refreshes — gas level changes also trigger an immediate refresh
- Gas volume per kg (m³/kg)Vapour volume one kilogram of liquid gas expands to, used by the Energy dashboard. The default 0.536 is propane at 15 °C; butane is about 0.407. Check the reference temperature your supplier bills at.
Texts from the code of ksanislo/senso4s_ble.
Entities
- Binary sensorsNeeds Calibration, Error, Anomaly, Low Gas, Temperature Anomaly, Incline Anomaly, Motion Anomaly
- SensorsGas Level, Gas Remaining, Battery, Usage Mode, Estimated Empty, Last Setup, Signal Strength, Empty Cylinder Weight, Gas Capacity, Gas Consumed, Gas Flow Rate
Actions
- CalibrateWARNING: Remove gas cylinder first! Scale must be empty to calibrate.
- Refresh HistoryRefresh consumption history from the device
- Write ConfigurationWrite cylinder configuration to the device
- Set Setup DateSet the measurement start date on the device
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Senso4s is not receiving active Bluetooth scan data, Requires calibration
From the README
A Home Assistant integration for the Senso4s LP/Propane Gas Cylinder Level Sensor.
- Real-time gas level and remaining-weight tracking
- Battery monitoring
- Anomaly detection on Plus models (temperature, incline, motion)
- Calibration / zeroing from Home Assistant
- Consumption history with predicted empty date (active or passive mode)
- Compatible with the official Senso4s mobile app — either can configure or zero the device
Shows in Vulpo
Chart card, Apple Watch.Information
- Installs
- 71 sharing analytics
- GitHub stars
- 15
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v1.5.1,
- Category
- Energy, Meters and monitoring
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
senso4s- Issues
- Report an issue
