FloatDeck

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

User Guide: English | 中文 | 日本語 | 한국어

Screenshot

Project Structure

app/src/main/kotlin/app/floatdeck/
├── gl/        # OpenGL renderer, shaders, textures
├── sensor/    # Gyroscope / accelerometer input
├── service/   # Wallpaper service + EGL render thread
├── settings/  # Compose settings + license screens
└── data/      # Templates, preferences, remote import, update check

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"}, ...]
  }
}

Optional fields

• "background": {"zoom": 1.5} — user background zoom (default 1, i.e. 100%). Adjusted in settings; the value is written straight back into the imported template's template.json, so it travels with the template on export. Missing values fall back to the defaults.

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

Example Theme Packs

Download from Releases and import via Remote URL or Local ZIP:

Theme Pack	Link
Honkai 3rd: Flame Chasers	flame_chasers.zip
Honkai: Star Rail - Amphoreus Titans	hsr_titans.zip

Note: Honkai 3rd and Honkai: Star Rail assets are copyrighted by miHoYo Co., Ltd.

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