Skip to content
Projects

kxxoling/FloatDeck has 63 GitHub stars and 6 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-18 09:47 UTC. Last push 2026-10-23.

How these counts are measured

63 stars6 Forks +1 in 24h

Measured star growth

in 24h
+1
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Android live wallpaper with gyroscope 3D parallax effect and floating character portraits

Creative & Media

README.md

Original

FloatDeck

F-Droid GitHub Releases

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

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

Screenshot FloatDeck home screen

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