PhoneSense turns a spare Android phone or iPhone into a local-first Home Assistant sensor, camera, media, and control node.
Download the latest Android APK
- In HACS, open the three-dot menu and choose Custom repositories.
- Add
https://github.com/lrehmann/phonesensewith category Integration. - Open PhoneSense, choose Download, and restart Home Assistant.
- Go to Settings → Devices & services → Add integration → PhoneSense.
- Install and open the PhoneSense app on the phone. Let it discover Home Assistant, enter or scan a long-lived access token, then choose Next: Pair with Home Assistant.
You can also open the repository in HACS directly:
Download PhoneSense-HomeAssistant.zip from the latest GitHub release and extract it into the root of the Home Assistant configuration directory. Confirm that the resulting path is:
config/custom_components/phonesense/manifest.json
Restart Home Assistant, then add PhoneSense from Settings → Devices & services.
The GitHub release includes PhoneSense-Android.apk, the latest Android 0.1.18 build. It has a minimum API 23, targets API 36, and passes the complete isolated test suite on API 23, 28, a physical API 29 Pixel, API 31, and API 36. It is debug-signed for direct testing and sideloading, not Play Store d
67D9
istribution. Android may ask you to allow installation from the browser or file manager used to open it.
SHA-256 checksums are included in the release notes.
- Numeric motion, rotation, magnetometer, attitude, heading, barometer, pedometer, activity, location, battery, charging, thermal, light, proximity, sound-level, screen, storage, and network telemetry when supported by the phone.
- Per-camera stream switches, live Home Assistant camera entities, snapshots, brightness and motion analysis, local segmented recording, and hardware-discovered controls.
- Phone flashlight and iOS display as Home Assistant lights.
- Android speaker as a media player and optional continuous vibration control.
- Android Bluetooth advertisements as a Home Assistant remote Bluetooth scanner.
- Outbound authenticated communication, so the phone does not need an inbound port or port forwarding.
PhoneSense discovers capabilities from each phone. Unsupported sensors, cameras, resolutions, and controls are not created.
PhoneSense currently uses a Home Assistant long-lived access token; OAuth is disabled. The token is masked during entry, cleared from the form after pairing, and stored using Android Keystore-backed encrypted storage or iOS Keychain. The app can try HTTP and HTTPS endpoints and offers an Allow insecure HTTP option for installations that intentionally use cleartext connections.
Sensitive actions remain subject to the app's local permissions and arming policy. Unpairing from the app erases its locally stored credentials, queue, and encryption keys; it does not erase Home Assistant history.
Report integration or app problems in GitHub Issues.