Documentation
The ProjectX42 App
Connect the Android app to your server, and understand what each sensor does.
Connecting
Open the app, choose to enter your server address manually, and type the full URL of your
ProjectX42 server — for example http://192.168.1.50:8123 on your home network, or
your remote address if you have set up remote access. Then sign in
with your ProjectX42 account.
Sensors
The app can report device state back to your server so your automations can react to it. Every sensor is off by default and you enable them individually under Settings → Companion app → Manage sensors.
- Location — presence detection, so your home knows when you arrive or leave. Enabling background location shows a disclosure first and requires you to grant "Allow all the time" in Android's own permission screens.
- Battery, connectivity, activity — useful automation triggers.
- App usage — reports which apps are in use, if you enable it.
- Health Connect — with your explicit consent, syncs fitness and health metrics to your own server.
All of this data is sent only to the server you configured. It never reaches ProjectX42. See our Privacy Policy.
Notifications
Your server can push notifications to the app. On builds distributed through Google Play, delivery uses Firebase Cloud Messaging, which requires a push token to route messages to your device. The notification content originates from your own server.
Widgets, Wear OS and Android Auto
Add home-screen widgets to trigger scenes and show live state, control your home from a Wear OS watch, or use the Android Auto interface while driving.
Back to all documentation · Questions? Contact us.