Ambient-Launcher/README.md

Ambient Launcher

An Android tablet home-screen replacement written in Kotlin and Jetpack Compose.

Included

• Android Home-role declaration and setup prompt
• Full-screen ambient slideshow with crossfade, interval control, image darkening, and optional local folder
• Clock with subtle burn-in position shifting
• API-key-free current weather and forecast from Open-Meteo
• Floating searchable app tray with persistent pinned apps
• Keep-awake options, including charging-only
• Scheduled ultra-dim/night presentation while the launcher is visible
• Honest capability and permission status screen
• Manual Android media output panel shortcut

Setup

Open this folder in a compatible Android Studio installation, let Gradle sync, and run it on an Android 8.0+ device. Select Make default Home app during onboarding or later in Settings.

No API key is required. The initial location is San Francisco; change latitude, longitude, and location label under Weather settings.

Deliberately not claimed

Always-listening wake-word detection, system-wide audio routing, and overlays over unrelated apps are not included. Those features require a wake-word engine/model and/or sensitive Android services and permissions. The permissions screen explains these boundaries.