Glimsy (Android Widget Media App)

Glimsy is a Kotlin + Compose + Glance Android app that powers a modern home-screen widget with curated image/video feeds, per-widget refresh, and live preview management from the app.

Current app version: v1.1.0

Features

• Polished Compose app UI with source search, filters, and presets
• 50+ curated image sources (Picsum, Reddit communities, Wallhaven, Pinterest, Wikimedia, etc.)
• Dynamic internet-fed video sources (resolved at refresh time from online feeds)
• Optional video-source toggle in Settings
• Multi-widget support with unique media per widget instance
• Widget Instances dashboard in-app:
  • See what each widget is currently showing (preview)
  • Refresh a single widget or all widgets quickly
  • Open current media directly
  • Apply video as Live Wallpaper
• Automatic periodic refresh (default 5 min, user configurable)
• Self-healing widget behavior when content fails to render
• User-added custom direct image sources

Build APK

1. Open this folder in Android Studio (latest stable).
2. Let Gradle sync and install missing Android SDK components.
3. Build debug APK: Build > Build Bundle(s) / APK(s) > Build APK(s)
4. Build signed release APK: Build > Generate Signed Bundle / APK

Terminal builds (wrapper included in repo):

• Windows debug: gradlew.bat assembleDebug
• Windows release (signed): gradlew.bat clean assembleRelease
• macOS/Linux debug: ./gradlew assembleDebug

Signed release setup

1. Create keystore.properties in the project root:
   • storeFile=keystore/glimsy-release.jks
   • storePassword=YOUR_STORE_PASSWORD
   • keyAlias=glimsyrelease
   • keyPassword=YOUR_KEY_PASSWORD
2. Ensure the keystore file exists at keystore/glimsy-release.jks.
3. Run gradlew.bat clean assembleRelease.

Output APK:

• Signed release APK: app/build/outputs/apk/release/app-release.apk
• Unsigned fallback (if signing not configured): app/build/outputs/apk/release/app-release-unsigned.apk

Add and use widget

1. Long-press home screen.
2. Tap Widgets.
3. Add Glimsy widget.
4. Open Glimsy app and configure sources.
5. Use Refresh All or per-widget Refresh from the Widget Instances panel.

Live Wallpaper (video)

1. Enable video sources in Settings.
2. In Widget Instances, find a video-backed instance.
3. Tap Apply Now to launch live wallpaper setup using that video URL.

Notes

• Android widgets cannot play inline video directly inside the widget surface.
• Glimsy supports video via external opening and Live Wallpaper integration.