Repository navigation
🎉 Wallpaper Picker v1.0.0 — Initial Release
⚠️ 关于稳定性的友情提示 (Important Notice on Stability)
虽然这是首个标记为 Release 的正式构建版本，但它依旧是一个初出茅庐的早期项目。由于 Android 各家厂商定制系统（MIUI/HyperOS、ColorOS、OriginOS、OneUI 等）在后台保活、锁屏壁纸权限与系统相册接口上的行为千奇百怪，我们完全无法保证其在所有设备上的绝对稳定性 🌚。
如果遇到切壁纸翻车、后台定时不灵或莫名其妙的玄学 Bug，欢迎提交 Issue 反馈，感谢您的包容与当小白鼠的勇气！
✨ 核心特性亮点
🖼️ 多元图源支持
- 本地与相册：支持自定义设备本地文件夹、系统相册相册集，以及基于 Photo Picker 的沙盒隔离照片挑选。
- 自建服务 (Immich)：原生对接 Immich API，支持相册指定、质量选择（原图/缩略图）与自签名证书支持。
- 网络与每日一图：内置必应每日壁纸（Bing Daily）预设，支持自定义 HTTP JSON API 订阅解析。
- 复合图源模式：可自由组合开启多种图源，按均等或权重统一洗牌轮换。
⏰ 智能轮换与触发机制
- 灵活调度：支持精确闹钟（Exact Alarm）定时轮换、每日固定时间（Daily Anchor）更新，以及常规后台间隔轮转。
- 熄屏自动切换：支持“灭屏自动换壁纸”，并配有防频闪防误触的冷却抑制机制。
- 真·公平随机 (Fair Shuffle)：基于牌堆（Deck）不放回随机算法，杜绝短时间内反复抽到同一张壁纸的尴尬。
📐 极致构图与锁屏独立裁剪
- 多端构图适配：支持针对手机高宽比的智能聚焦点微调、水平镜像翻转。
- 分屏策略：桌面可设置视差滚动（Parallax），锁屏可保持独立居中裁剪，互不干扰。
- 全屏沉浸预览 (Lightbox)：双击放大、手势拖拽、原图快速打开与应用。
💾 历史记录与永久离线收藏
- 历史归档：每次应用的壁纸均自动记录构图偏好与来源信息。
- 离线收藏隔离：加星收藏的壁纸会自动固化到专属持久目录，绝不受系统清理或临时缓存淘汰影响。
- 失效恢复与清理：缓存丢失时支持一键批量从网络重新下载补全，亦支持一键清理失效死链。
🧩 深度系统集成
- 桌面微件 (AppWidget)：实时展示当前壁纸与来源微调。
- 控制中心功能块 (QS Tile)：下拉通知栏即可一键更换下一张或快速启闭轮换。
- 应用快捷方式 (Shortcuts)：桌面图标长按快捷操作，并支持隔离多版本调试。
- 安全备份：支持全量配置、图源及收藏壁纸的离线导出备份（支持 OpenPGP 加密）。
🌐 English Description
⚠️ A Gentle Note on Stability
While this tag marks our very first official Release build, it is still an early-stage project out in the wild. Given the wonderfully unpredictable quirks across various OEM Android flavors (HyperOS, ColorOS, OneUI, OriginOS, etc.) regarding background execution limits, lock screen wallpaper APIs, and storage permissions, we absolutely do NOT guarantee rock-solid stability just yet 🌚.
If wallpapers fail to update, timers take an unexpected nap, or things break mysteriously, please feel free to file an issue. Thank you for your patience and for daring to be our early explorer!
✨ Highlighted Features
🖼️ Versatile Wallpaper Sources
- Local & Photo Picker: Supports custom device directories, MediaStore system albums, and safe sandbox selection.
- Self-Hosted Immich: Native Immich integration with album selection, quality options (Original/Preview), and self-signed SSL support.
- Web & Daily Feeds: Built-in Bing Wallpaper Daily preset and customizable HTTP JSON API parser.
- Composite Pool: Simultaneously enable multiple sources into a unified rotation deck.
⏰ Intelligent Scheduling & Triggers
- Flexible Timing: Choose between Exact Alarms, periodic background intervals, or Daily Anchor times (e.g. 08:00 every morning).
- Screen-Off Trigger: Automatically updates wallpaper when the screen turns off, with configurable delay and cooldown suppression.
- Fair Shuffle: Bag-based random distribution preventing duplicate wallpaper repeats within short intervals.
📐 Advanced Framing & Independent Lock Screen Strategy
- Composition Controls: Interactive crop focal points, aspect-ratio adjustments, and horizontal flip.
- Dual Display Modes: Home screen dynamic parallax scrolling paired with independent centered lock screen framing.
- Immersive Lightbox: Full-bleed zoomable viewer with quick adjustments and gallery dispatch.
💾 History & Permanent Offline Favorites
- History Archive: Automatically logs applied wallpapers, source metadata, and framing configurations.
- Isolated Favorites: Favorited wallpapers are stored in an offline protected vault, immune to automatic cache cleanup.
- Broken Image Recovery: Batch redownload missing cached images from remote endpoints, or cleanly prune dead records.
🧩 Deep System Integration
- Desktop Widget: Live preview of current wallpaper with quick-action triggers.
- Quick Settings Tile: Pull down the notification panel to rotate to the next wallpaper instantly.
- App Shortcuts: Static and dynamic launcher shortcuts for rapid control.
- Encrypted Backup & Restore: Full metadata, source configs, and favorites export with optional OpenPGP encryption.