Skip to content

Releases: andromedvn/HAT

v1.0 — Initial Release

04 Jun 11:22
@andromedvn andromedvn
v1.0
d94d031

Choose a tag to compare

View all tags
v1.0 — Initial Release Latest
Latest

HAT reconstructs your day from the ground up — app sessions, offline gaps, idle detection, the full picture. No account. No internet permission. No cloud. Everything stays on your device.

This is the first public release.

What's included

Timeline — See every app session for any day, week, or month. Sessions are clustered so you don't see 40 entries for Instagram; you see one block with the real total. Tap any bar in the chart to jump to that time slot.

Gap labeling — When you weren't on your phone, HAT shows you the gap and lets you name it. Sleeping, commuting, at the gym — whatever fits. Labels are stored locally and show up in the timeline alongside app usage.

Batch labeling — Long-press multiple gaps to select them, then label the whole batch at once.

Ghost session detection — If your screen stayed on for a long time without real interaction (music, navigation, left on a desk), HAT flags it and asks what was happening. Dismiss it as real usage or label it as offline time.

History archiving — Android deletes usage history after a few weeks. The optional background worker saves it before that happens, on a schedule you control.

Master Vault backup — Export your entire timeline, settings, and logs as a signed .zip file. Restore it on any device. The file is HMAC-SHA256 signed; a corrupt or tampered vault is rejected before any data is touched.

Material You theming — Dynamic colors from your wallpaper on Android 12+. Static deep orange on older devices.

Hidden apps — Hide any app from the dashboard entirely. It won't show up in the timeline and won't affect gap calculations.

Crash recovery — If the app crashes, it writes a local log and opens a recovery screen instead of the generic Android dialog. You can export and share the log if you want to file a bug report.

Installing

HAT is not on the Play Store. You'll install it as an APK directly.

1. Download HAT-v1.0.apk from the Assets section below.

2. Verify the file (strongly recommended — see the checksum section).

3. Allow installs from unknown sources. On most devices: Settings → Apps → Special app access → Install unknown apps Then select your browser or file manager and enable it.

4. Open the APK file and tap Install.

Granting Usage Access

After installing, HAT will ask you to grant Usage Access. This cannot be done through the normal Android permission dialog — Android requires you to do it manually.

When prompted, tap "Go to Settings", then find HAT in the list and enable it.

The exact path varies by manufacturer:

  • Stock Android / Pixel: Settings → Digital Wellbeing → Usage Access → HAT → Permit usage access
  • Samsung: Settings → Digital Wellbeing → Usage Access → HAT → Permit usage access
  • Xiaomi / MIUI: Settings → Apps → Manage apps → HAT → Other permissions → Usage Access
  • OnePlus / OxygenOS: Settings → Privacy → Usage Access → HAT

If you can't find it, search "Usage Access" in your device's Settings search bar.

HAT reads when apps open and close. It does not read what you do inside them, your messages, your location, or anything else.

Verify the APK (SHA-256)

Before installing, confirm the file hasn't been tampered with.

Expected hash:

c0da376be39a8dd21c7e63f9ee1dc94efd90345358866d563176cf7c7aee05dd

If the hash you compute doesn't match the one above, do not install the file.

Requirements

   
Android version 8.0 (Oreo, API 26) or higher
Architecture arm64-v8a (64-bit)
Storage ~15 MB install + database grows with usage
Permissions Usage Access only (granted manually after install)

Permissions

HAT requests exactly one permission:

PACKAGE_USAGE_STATS (Usage Access) — Required to read app foreground/background events from the Android OS. Without this, the timeline cannot be built.

HAT does not request: Internet, Location, Contacts, Camera, Microphone, Storage, Phone State, or any other Android permission.

No internet permission means the app literally cannot send your data anywhere. This is enforced by Android at the OS level, not just by policy.

Known limitations

  • History before installation is limited. Android retains usage event data for roughly 2–8 weeks depending on your device. HAT cannot recover anything the OS already deleted before you installed.
  • Background worker reliability varies by device. Aggressive battery management on Xiaomi, Huawei, Samsung, and OPPO devices can delay or skip the archive worker. If this affects you, disabling battery optimization for HAT usually helps: Settings → Battery → Battery optimization → All apps → HAT → Don't optimize
  • No tablet-optimized layout in this release.
  • English only in this release.

Source code and license

Source code: https://github.com/andromedvn/HAT

HAT is free software released under the GNU Affero General Public License v3.0 (AGPL-3.0). You are free to use, study, modify, and distribute it under those terms. If you distribute a modified version, the source must be made available under the same license.

Privacy Policy & Terms

  • Privacy Policy: https://andromedvn.github.io/HAT/PRIVACY.html
  • Terms of Service: https://andromedvn.github.io/HAT/TERMS.html

Bugs and feedback

Open an issue: https://github.com/andromedvn/HAT/issues

Include your Android version, device model, and a crash log from Settings → Diagnostics if applicable.

Assets 3
Loading