package icon

Temperance Companion

Offline habit tracker and Health Connect bridge for Obsidian Temperans
New in version 0.1.15
- Added CSV export alongside JSON, with format-aware export filenames.
- Added an F-Droid build that disables Health Connect on Android 13 and earlier while keeping habit tracking and local exports available.
- Improved habit-session lock behavior, including updating the lock state when the device is unlocked.
- Simplified the welcome screen title, and made the F-Droid notice dismissible.
Temperance Companion is an offline-first companion app for the Obsidian Temperans plugin. It acts as a privacy-respecting bridge that queries Android Health Connect for health and fitness metrics, tracks custom habit sessions (counters and timers), and stages data directly into your local Obsidian vault.

Key Features:
- Habit Tracking: Track custom habits with elapsed-time timers and rep/quantity counters. Includes quick-increment presets and monotonic elapsed timing.
- Health Connect Integration: Reads permission-granted metrics (such as sleep, hydration, nutrition, steps, exercise, and heart rate) without third-party cloud sync.
- Vault Export: Exports verified JSON (habit-sync-staging.json) or CSV (habit-sync-staging.csv) directly into your chosen vault folder using Android Storage Access Framework.
- Customizable & Reorderable: Create habits with custom units, drag-and-drop ordering, and customizable quick increments.
- 100% Offline & Private: Requires NO Internet permission. Zero telemetry, zero analytics, zero developer backend. Your data never leaves your device unless synced by your chosen vault sync tool.

Note: Health Connect features are available on Android 14 and newer. For Android 9–13 devices, Health Connect is intentionally disabled by design to comply with F-Droid guidelines and avoid non-free dependencies (the nonfreedep anti-feature). All core habit-tracking and offline vault staging functions remain fully available.

Versions

Although APK downloads are available below to give you the choice, you should be aware that by installing that way you will not receive update notifications and it's a less secure way to download. We recommend that you install the F-Droid client and use that.

Download F-Droid
  • Version 0.1.15 (11) suggested Added on Oct 25, 2026

    arm64-v8a armeabi-v7a x86 x86_64

    This version requires Android 9.0 or newer.

    It is built and signed by the original developer, and guaranteed to correspond to this source tarball.

    Permissions
    • android.permission.health.READ_ACTIVE_CALORIES_BURNED
    • android.permission.health.READ_DISTANCE
    • android.permission.health.READ_EXERCISE
    • android.permission.health.READ_FLOORS_CLIMBED
    • android.permission.health.READ_HEART_RATE
    • android.permission.health.READ_HYDRATION
    • android.permission.health.READ_NUTRITION
    • android.permission.health.READ_RESTING_HEART_RATE
    • android.permission.health.READ_SLEEP
    • android.permission.health.READ_STEPS
    • android.permission.health.READ_TOTAL_CALORIES_BURNED
    • android.permission.health.READ_WEIGHT
    • com.temperance.companion.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

    Download APK 4.9 MiB PGP Signature | Build Log

  • New in version 0.1.10
    Initial F-Droid release.
    - Health Connect integration for 12 health metrics.
    - Habit tracking with counters and elapsed-time timers.
    - Verified local staging export for Obsidian Temperans plugin.
    - Dark and light theme support with dynamic Material 3 styling.
  • Version 0.1.10 (6) - Added on Oct 15, 2026

    arm64-v8a armeabi-v7a x86 x86_64

    This version requires Android 9.0 or newer.

    It is built and signed by the original developer, and guaranteed to correspond to this source tarball.

    Permissions
    • android.permission.health.READ_ACTIVE_CALORIES_BURNED
    • android.permission.health.READ_DISTANCE
    • android.permission.health.READ_EXERCISE
    • android.permission.health.READ_FLOORS_CLIMBED
    • android.permission.health.READ_HEART_RATE
    • android.permission.health.READ_HYDRATION
    • android.permission.health.READ_NUTRITION
    • android.permission.health.READ_RESTING_HEART_RATE
    • android.permission.health.READ_SLEEP
    • android.permission.health.READ_STEPS
    • android.permission.health.READ_TOTAL_CALORIES_BURNED
    • android.permission.health.READ_WEIGHT
    • com.temperance.companion.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

    Download APK 4.8 MiB PGP Signature | Build Log