FloatDeck

Android live wallpaper with gyroscope parallax effect and floating character portraits.

Project Structure

app/src/main/
├── kotlin/app/floatdeck/
│   ├── gl/
│   │   ├── FloatDeckRenderer.kt     # Main GL renderer (render loop, animation, touch)
│   │   ├── Shaders.kt               # GLSL source (portrait + background)
│   │   └── TextureLoader.kt         # Texture creation from assets/bitmaps
│   ├── sensor/
│   │   └── SensorHandler.kt         # Gyroscope/accelerometer listener
│   ├── service/
│   │   └── FloatDeckWallpaperService.kt  # Wallpaper service + EGL thread
│   ├── settings/
│   │   └── SettingsActivity.kt      # Compose settings UI
│   └── data/
│       ├── Models.kt                # Data classes (PortraitConfig, TemplateConfig)
│       ├── SettingsRepository.kt    # DataStore-backed user preferences
│       ├── Templates.kt             # Template JSON loader & layout calculator
│       └── RemoteTemplateLoader.kt  # Remote/local ZIP & directory import
└── assets/
    └── templates/                   # Built-in template assets (JSON + images)

Template System

Each template lives in a folder with a template.json and image files:

{
  "id": "my_template",
  "name": "My Template",
  "wallpaper": "wallpaper.webp",
  "portraits": {
    "left": [{"file": "a.webp", "label": "A"}, ...],
    "right": [{"file": "b.webp", "label": "B"}, ...]
  }
}

Importing Templates

Templates can be imported from:

1. Remote URL — Enter a ZIP download URL in settings
2. Local ZIP — Select a ZIP file from device storage
3. Local directory — Select a folder containing template files

ZIP format: Must be structured as folder_name/template.json + folder_name/*.png|jpg|webp:

template_name/
├── template.json
├── wallpaper.webp
├── portrait_1.webp
└── portrait_2.webp

Validation rules:

• template.json is required with valid id, wallpaper, and portraits fields
• Only .png, .jpg, .jpeg, .webp images allowed
• Max ZIP size: 50MB, max single file: 10MB
• Path traversal (..) is blocked
• Template ID: alphanumeric, underscores, hyphens only

Build

./gradlew assembleDebug

Install & Set

adb install -r app/build/outputs/apk/debug/app-debug.apk
adb shell am start app.floatdeck/.settings.SettingsActivity

Or: Settings → Wallpaper → Live Wallpapers → FloatDeck

CI/CD

• CI: push/PR to main/dev → ktlint + test + debug build
• Release: GitHub Release published → signed APK → attached to release

License

MIT