foyer/com.foyerlauncher.foyer.data/UsageTracker

UsageTracker

Reads real per-app foreground time via UsageStatsManager. Requires the special "usage access" grant (not a normal runtime permission) — the whole point of a minimalist phone: see where the time goes and add friction to the time-sinks.

Functions

dailyTotals

fun dailyTotals(context: Context, days: Int): List<Pair<Long, Long>>

Total screen time per day for the last days days, oldest first; each entry is (day-start millis, total ms). Powers the week-trend rows.

hasAccess

fun hasAccess(context: Context): Boolean

openAccessSettings

fun openAccessSettings(context: Context)

screenTimeTodayMs

fun screenTimeTodayMs(context: Context): Long

Total foreground time across all apps since midnight (≈ screen time).

topAppsToday

fun topAppsToday(context: Context): List<Pair<String, Long>>

Today's per-app foreground time, biggest first, noise (<1 min) dropped.

unlocksToday

fun unlocksToday(context: Context): Int

How many times the phone was unlocked since midnight (API 28+, else 0).

usageTodayMs

fun usageTodayMs(context: Context, packageName: String): Long

Foreground time for one package since midnight.