Webhook Configuration

• Multiple webhook URLs - Send to multiple endpoints simultaneously
• Custom headers - Add auth tokens, API keys, or any custom HTTP headers per category
• Separate configuration - Different URLs and headers for Health and Screen Time

Data Tools

• Data preview - View the exact JSON payload before syncing
• Export as CSV/JSON - Export sync logs via the Android share sheet
• Sync history dashboard - Overview of success rates, record counts, and recent failures

General

• Background sync - Uses WorkManager for reliable background execution
• Webhook logs - View recent sync attempts with payloads for debugging
• Health Connect install check - Clear guidance when Health Connect is missing or outdated
• Modern UI - Material 3 design with dark mode support

Requirements

• Android 14+ (API 34)
• Health Connect app installed
• Usage access permission (for Screen Time feature)

Installation

From Releases (Recommended)

1. Download the latest APK from Releases
2. Install on your Android device (enable "Install from unknown sources" if needed)

Build from Source

# Clone the repository
git clone https://github.com/owen282000/life-dashboard-companion-app.git
cd life-dashboard-companion-app

# Build debug APK
./gradlew assembleDebug

# The APK will be at: app/build/outputs/apk/debug/app-debug.apk

# Or install directly on connected device
./gradlew installDebug

Setup

1. Install the app on your Android device
2. Grant Health Connect permissions - Tap "Grant" and select the data types you want to sync
3. Grant Usage Access (for Screen Time) - Go to Settings when prompted
4. Configure webhook URLs - Enter your server endpoint(s)
5. Add webhook headers (optional) - Configure auth tokens or API keys
6. Set sync intervals - Minimum 15 minutes
7. Tap "Preview Data" to inspect the payload, then "Sync Now" to send

Webhook Payload Format

Health Connect

Every Health Connect payload has these top-level fields:

{
  "timestamp": "2025-02-05T12:00:00Z",
  "app_version": "1.2.0",
  "source": "health_connect",
  "steps": [],
  "sleep": [],
  "heart_rate": [],
  "distance": [],
  "active_calories": [],
  "total_calories": [],
  "weight": [],
  "height": [],
  "blood_pressure": [],
  "blood_glucose": [],
  "oxygen_saturation": [],
  "body_temperature": [],
  "respiratory_rate": [],
  "resting_heart_rate": [],
  "exercise": [],
  "hydration": [],
  "nutrition": [],
  "mindfulness": [],
  "body_fat": [],
  "lean_body_mass": [],
  "bone_mass": [],
  "body_water_mass": [],
  "heart_rate_variability": []
}

Only enabled data types are included. Each array contains records with the following fields:

Activity

Steps

{ "count": 1234, "start_time": "2025-02-05T08:00:00Z", "end_time": "2025-02-05T09:00:00Z" }

Distance

{ "meters": 1523.5, "start_time": "2025-02-05T08:00:00Z", "end_time": "2025-02-05T09:00:00Z" }

Active Calories

{ "calories": 245.3, "start_time": "2025-02-05T08:00:00Z", "end_time": "2025-02-05T09:00:00Z" }

Total Calories

{ "calories": 1850.0, "start_time": "2025-02-05T08:00:00Z", "end_time": "2025-02-05T09:00:00Z" }

Exercise Sessions

{ "type": "running", "start_time": "2025-02-05T07:00:00Z", "end_time": "2025-02-05T08:00:00Z", "duration_seconds": 3600 }

Body

Weight

{ "kilograms": 75.5, "time": "2025-02-05T07:00:00Z" }

Height

{ "meters": 1.82, "time": "2025-02-05T07:00:00Z" }

Body Temperature

{ "celsius": 36.6, "time": "2025-02-05T07:00:00Z" }

Body Composition

Body Fat %

{ "percentage": 18.5, "time": "2025-02-05T07:00:00Z" }

Lean Body Mass

{ "kilograms": 61.5, "time": "2025-02-05T07:00:00Z" }

Bone Mass

{ "kilograms": 3.2, "time": "2025-02-05T07:00:00Z" }

Body Water Mass

{ "kilograms": 42.0, "time": "2025-02-05T07:00:00Z" }

Vitals

Heart Rate

{ "bpm": 72, "time": "2025-02-05T10:30:00Z" }

Resting Heart Rate

{ "bpm": 58, "time": "2025-02-05T07:00:00Z" }

Heart Rate Variability (HRV)

{ "heart_rate_variability_millis": 42.5, "time": "2025-02-05T07:00:00Z" }

Blood Pressure

{ "systolic": 120.0, "diastolic": 80.0, "time": "2025-02-05T07:00:00Z" }

Blood Glucose

{ "mmol_per_liter": 5.5, "time": "2025-02-05T07:00:00Z" }

Oxygen Saturation

{ "percentage": 98.0, "time": "2025-02-05T07:00:00Z" }

Respiratory Rate

{ "rate": 16.0, "time": "2025-02-05T07:00:00Z" }

Sleep

Sleep Sessions

{
  "session_end_time": "2025-02-05T07:30:00Z",
  "duration_seconds": 28800,
  "stages": [
    {
      "stage": "deep",
      "start_time": "2025-02-04T23:00:00Z",
      "end_time": "2025-02-05T01:00:00Z",
      "duration_seconds": 7200
    }
  ]
}

Possible stage values: unknown, awake, sleeping, out_of_bed, light, deep, rem, awake_in_bed.

Nutrition

Hydration

{ "liters": 0.5, "start_time": "2025-02-05T08:00:00Z", "end_time": "2025-02-05T08:00:00Z" }

Nutrition

{ "calories": 450.0, "protein_grams": 25.0, "carbs_grams": 60.0, "fat_grams": 12.0, "start_time": "2025-02-05T12:00:00Z", "end_time": "2025-02-05T12:30:00Z" }

All nutrition fields (calories, protein_grams, carbs_grams, fat_grams) are optional and omitted when not available.

Mindfulness

Mindfulness Sessions

{ "title": "Morning Meditation", "start_time": "2025-02-05T06:00:00Z", "end_time": "2025-02-05T06:15:00Z", "duration_seconds": 900 }

The title field is optional and may be null.

Screen Time

{
  "timestamp": "2025-02-05T12:00:00Z",
  "app_version": "1.2.0",
  "device": "Google Pixel 8",
  "source": "screen_time",
  "screen_time": [
    {
      "date": "2025-02-05",
      "total_screen_time_minutes": 180,
      "apps": [
        {
          "package": "com.instagram.android",
          "name": "Instagram",
          "minutes": 45,
          "last_used": "2025-02-05T11:30:00Z"
        }
      ]
    }
  ]
}

Example Backend Integrations

Simple Express.js Server

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/health-connect', (req, res) => {
  console.log('Health data received:', req.body);
  // Store in database, forward to InfluxDB, etc.
  res.status(200).send('OK');
});

app.post('/api/screen-time', (req, res) => {
  console.log('Screen time data received:', req.body);
  res.status(200).send('OK');
});

app.listen(3000);

Home Assistant Webhook

Use Home Assistant's webhook trigger to receive data and store it or trigger automations.

Tech Stack

• Kotlin - Modern Android development
• Jetpack Compose - Declarative UI with Material 3
• Health Connect SDK - Official Google Health Connect API
• WorkManager - Reliable background task scheduling
• OkHttp - HTTP client with retry logic
• Kotlinx Serialization - JSON serialization

Privacy

This app:

• Does not collect any data itself
• Does not send data anywhere except your configured webhook URLs
• Does not include any analytics or tracking
• Stores settings locally on your device only

You are in full control of where your data goes.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Google Health Connect for the excellent SDK
• HC Webhook by mcnaveen for inspiration on Health Connect integration patterns
• The Quantified Self community for inspiration
• Claude Code for assistance with development

Support

If you find this project useful, please consider:

• Starring the repository
• Sharing it with others who might benefit
• Contributing improvements

Made by Owen Vogelaar for the self-hosted and quantified self community.

Privacy focused recorder app built with MD3