glintbox

✦ Glintbox

A beautiful, private, offline status keeper for Android — built with Kotlin + Jetpack Compose (Material 3).

Features

Performance testing

./gradlew installBenchmark installs a release-speed build (com.glintbox.app.bench, signed with the debug key) next to the Play version. Use it for adb shell dumpsys gfxinfo and cold-start timing; debug builds are much slower.

How storage works (and why — Play policy)

Android Reading statuses Saving to Internal storage/WhatsApp Statuses
8 – 10 READ_EXTERNAL_STORAGE (capped at API 29) Direct write, WRITE_EXTERNAL_STORAGE (capped at API 29)
11 + User grants the .Statuses folder once via the system picker (opens right inside it) Android forbids apps from creating top-level folders without All files access, which Play doesn’t allow for this category. So the app walks the user through creating/approving the folder once in the system picker. Until then it saves to Download/WhatsApp Statuses via MediaStore, so saving always works.

Custom folders on any version use the Storage Access Framework with persisted permissions.

Project layout

app/src/main/java/com/glintbox/app/
├── GlintboxApp.kt            Application, Coil image loader (video frames + GIF), DI container
├── MainActivity.kt           Splash, edge-to-edge, theme, nav host
├── data/
│   ├── model/Models.kt       StatusMedia, WaSource, AppSettings, SaveTarget …
│   ├── SettingsRepository.kt DataStore preferences
│   ├── StatusRepository.kt   Reads statuses (File API ≤ 10, SAF ≥ 11)
│   ├── SaveRepository.kt     Save / list / delete (SAF tree, legacy folder, MediaStore fallback)
│   └── storage/              SAF + MIME helpers
├── work/AutoSaveWorker.kt    Optional periodic auto-save
├── util/                     Share/rate intents, formatters
└── ui/
    ├── MainViewModel.kt
    ├── theme/                Palettes, color schemes, typography
    ├── components/           Aurora background, glass cards, gradient buttons, status tile
    ├── common/FolderAccess   Guided folder-picker flows
    ├── navigation/           Type-safe routes + NavHost
    ├── onboarding/ home/ viewer/ about/

Release signing

  1. Android Studio → Build → Generate Signed App Bundle → create a new keystore (keep it safe and backed up!).
  2. Create keystore.properties in the project root (already git-ignored via *.jks — also add this file to .gitignore if you commit):
storeFile=C:/keys/glintbox-release.jks
storePassword=********
keyAlias=glintbox
keyPassword=********
  1. Build → Generate Signed App Bundle (or gradlew bundleRelease) and upload the .aab. Enrol in Play App Signing.

Roadmap

Done in v1.1 — Save by person

Status files carry no sender info (WhatsApp keeps that in its private DB), so the user names the person themselves:

Before publishing