app/com.instagram.doomscrolling.scrolling/ScrollTimeStore

ScrollTimeStore

object ScrollTimeStore(source)

Persistent storage for scrolling time, breaks, streaks, and session statistics.

This object manages all time-related data storage:

Scrolling time: Tracks time spent scrolling per app and total per day
Break events: Counts when user takes breaks or gets locked
Avoided time: Tracks time "saved" by interventions
Streak tracking: Maintains consecutive days of taking breaks
Session statistics: Tracks warnings shown, actions taken, cooldowns, etc.

Data is stored in SharedPreferences with keys like:

`scroll_2025-10-30_total` - Total scroll time for a day
`scroll_2025-10-30_com.instagram.android` - Time for specific app
`scroll_2025-10-30_breaks` - Number of breaks taken
`scroll_2025-10-30_avoided_ms` - Time avoided in milliseconds

Functions

addAvoidedMs

fun addAvoidedMs(ctx: Context, savedMillis: Long)

clearLastBreakTs

fun clearLastBreakTs(ctx: Context)

endSession

@Synchronized

fun endSession(ctx: Context, endAt: Long = System.currentTimeMillis())

Ends the current scrolling session and saves the duration.

getAllToday

fun getAllToday(ctx: Context): Map<String, Long>

Optionally: list all apps for today (to show top apps)

getLastBreakTs

fun getLastBreakTs(ctx: Context): Long

getStreak

fun getStreak(ctx: Context): Int

For header: "🔥 4-day streak"

getTodayAvoidedCount

fun getTodayAvoidedCount(ctx: Context): Int

getTodayBreaks

fun getTodayBreaks(ctx: Context): Int

How many breaks user took TODAY (for "You avoided doomscroll 3 times today")

getTodayCooldownCompleted

fun getTodayCooldownCompleted(ctx: Context): Int

getTodayCooldownStarted

fun getTodayCooldownStarted(ctx: Context): Int

getTodayForApp

fun getTodayForApp(ctx: Context, packageName: String): Long

Get per-app scroll time for today (ms)

getTodayGraceUsed

fun getTodayGraceUsed(ctx: Context): Int

getTodayInterventions

fun getTodayInterventions(ctx: Context): Int

getTodayNoReentry

fun getTodayNoReentry(ctx: Context): Int

getTodayPopupsShown

fun getTodayPopupsShown(ctx: Context): Int

getTodayReopenWithin2m

fun getTodayReopenWithin2m(ctx: Context): Int

getTodayTakeRestClicked

fun getTodayTakeRestClicked(ctx: Context): Int

getTodayTotal

fun getTodayTotal(ctx: Context): Long

Get total scroll time for today (ms)

getTodayTotalSessions

fun getTodayTotalSessions(ctx: Context): Int

getTodayTrueDoomSessions

fun getTodayTrueDoomSessions(ctx: Context): Int

getTodayWarn1KeepClicked

fun getTodayWarn1KeepClicked(ctx: Context): Int

getTodayWarn1PTakeRestClicked

fun getTodayWarn1PTakeRestClicked(ctx: Context): Int

getTodayWarn1Shown

fun getTodayWarn1Shown(ctx: Context): Int

getTodayWarn2KeepScrollingClicked

fun getTodayWarn2KeepScrollingClicked(ctx: Context): Int

getTodayWarn2Shown

fun getTodayWarn2Shown(ctx: Context): Int

getTodayWarn2TakeRestClicked

fun getTodayWarn2TakeRestClicked(ctx: Context): Int

getWeeklyAvoidedCount

fun getWeeklyAvoidedCount(ctx: Context): Int

getWeeklyAvoidedMs

fun getWeeklyAvoidedMs(ctx: Context): Long

Avoided doomscroll last week: sum of avoided_ms for last 7 days

getWeeklyBreaks

fun getWeeklyBreaks(ctx: Context): Int

Weekly summary (last 7 days): how many times user avoided doomscroll (for "Weekly summary 30 times")

getWeeklyDoomscrolledMs

fun getWeeklyDoomscrolledMs(ctx: Context): Long

Doomscrolled last week: sum of TOTAL scroll time for last 7 days (for "1h 02 min")

getWeeklyWarn1Shown

fun getWeeklyWarn1Shown(ctx: Context): Int

incCooldownCompleted

fun incCooldownCompleted(ctx: Context)

incCooldownStarted

fun incCooldownStarted(ctx: Context)

incGraceUsed

fun incGraceUsed(ctx: Context)

incPopupShown

fun incPopupShown(ctx: Context)

incTotalSessions

fun incTotalSessions(ctx: Context)

incTrueDoomSessions

fun incTrueDoomSessions(ctx: Context)

incWarn1KeepClicked

fun incWarn1KeepClicked(ctx: Context)

incWarn1Shown

fun incWarn1Shown(ctx: Context)

incWarn1TakeRestClicked

fun incWarn1TakeRestClicked(ctx: Context)

incWarn2KeepScrollingClicked

fun incWarn2KeepScrollingClicked(ctx: Context)

incWarn2Shown

fun incWarn2Shown(ctx: Context)

incWarn2TakeRestClicked

fun incWarn2TakeRestClicked(ctx: Context)

markReentry

fun markReentry(ctx: Context)

onBreakTaken

fun onBreakTaken(ctx: Context, savedMillis: Long = 15 * 60_000L)

Records when a user takes a break from scrolling.

onReopenWithin2m

fun onReopenWithin2m(ctx: Context)

recordIntervention

fun recordIntervention(ctx: Context)

startSession

@Synchronized

fun startSession(ctx: Context, packageName: String)

Starts tracking a new scrolling session for the specified app.

tryFinalizeNoReentry

fun tryFinalizeNoReentry(ctx: Context)

ScrollTimeStore

See also

Functions