# 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.