NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
Set wallpapers on Android asynchronously. Also supports video live wallpapers.
Latest stable
3.7.0
Last release 17 days ago
05 Nov 2026
Release timing varies
gaps range from 8 days to 1.5 years
Nearly every release is documented
notes for 16 of 16 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
16 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Android release with per-screen OpenGL live wallpapers and a daily wallpaper schedule. The Dart API gains fields and methods. Existing callers are una
Android release with per-screen OpenGL live wallpapers and a daily wallpaper schedule. The Dart API gains fields and methods. Existing callers are unaffected.
getWallpaperFlags) and that screen's wallpaper id. A new id means the user just set that screen, so the engine takes the staged content. A known id means a restart, so the engine keeps that screen's content. This works with the stock AOSP live picker, which never calls onApplyWallpaper. A picker that calls onApplyWallpaper gets a WallpaperDescription that carries the content.OpenGlLiveWallpaperRequest.contentTag (opaque, at most 256 characters) and WallpaperOperationResult.effectiveTarget. Applying new content to one screen does not change the other screen.WallpaperCapabilities.supportsPerScreenLiveWallpaper and AsyncWallpaper.getLiveWallpaperScreens(), which returns LiveWallpaperScreens with the Home and Lock LiveScreenState. Call it after the preview closes.effectiveTarget is both. Video live wallpapers are unchanged. On iOS, supportsPerScreenLiveWallpaper is false, and getLiveWallpaperScreens() returns an empty snapshot.A daily schedule applies one wallpaper for each time of day.
startDailySchedule, stopDailySchedule, applyCurrentScheduleEntry, and getDailyScheduleStatus. A schedule has 2 to 100 entries, each at a different minute of the day. Each entry owns the local time up to the next entry, and the last entry wraps past midnight.MY_PACKAGE_REPLACED.startDailySchedule stops rotation, and a successful startWallpaperRotation stops the daily schedule.applyCurrentScheduleEntry re-arms an alarm that a force stop removed. getDailyScheduleStatus reports the mode, entry indexes, next switch time, and last error.nextSwitchEpochMs is 0 while the cache is incomplete.unsupported.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Android OpenGL tilt release. The Dart API gains WallpaperCapabilities.supportsTilt. Existing shaders are unaffected.
Android OpenGL tilt release. The Dart API gains WallpaperCapabilities.supportsTilt. Existing shaders are unaffected.
u_tilt (vec2, -1 to 1 per axis). x grows as the right edge dips, and y grows as the top edge leans away from you. (0, 0) at rest and on devices without a sensor. It comes from the game rotation vector, or from the accelerometer when that is missing, at about 15 Hz, smoothed per frame. It is measured from a rest pose that follows how you hold the phone over about 7 seconds. The sensor is registered only while the wallpaper is visible and its shader reads u_tilt. It is unregistered when the wallpaper goes invisible, loses its surface, fails, or is destroyed.WallpaperCapabilities.supportsTilt: true on Android when OpenGL live wallpapers are supported and the device has one of those sensors; false on iOS.u_tilt and must also run on 3.5.0 keep working. 3.5.0 accepts the declaration and leaves u_tilt at (0, 0). Check supportsTilt to decide whether to use it.OpenGL and URL-handling release. The Dart API is unchanged, but OpenGL textures are now upright and some HTTPS URLs are now rejected. See doc/migratio
OpenGL and URL-handling release. The Dart API is unchanged, but OpenGL textures are now upright and some HTTPS URLs are now rejected. See doc/migration.md.
#fragment. Since 3.3.0 the Dart layer rejected them with invalid-input, because Uri.isAbsolute is false for any URI with a fragment. Android and iOS accept them and do not send the fragment. Fragment characters that Android rejects stay rejected.downloadWallpaper logs why a download failed under the AsyncWallpaper logcat tag: an unsupported image type such as ICO, an image that does not decode, a MediaStore error, or a source error code. Dart still receives a generic failure, because the method returns a Boolean. The log names MIME types, error codes, or the exception class, and never the URL. Exception logs no longer print exception messages, which could include the URL.invalid-input: "<>^`{|}, U+0080–U+009F, or a Unicode space separator anywhere in the URL, [ or ] in the path, and any @ in the authority, such as https://@example.com/a.jpg. Some Android entry points previously returned invalid-url. Behavior change: on iOS 17+, downloadWallpaper accepted some of them, because URL(string:) percent-encodes them. Percent-encode prohibited characters in path, query, or fragment data. Remove user information from the authority instead of percent-encoding its @.failed with shader-compilation-failed or shader-link-failed and the driver log in errorDetails, and the active wallpaper does not change. Before, the preview opened, the wallpaper rendered black, and the result was previewOpened. The check is skipped and logged when it cannot run, for example without a pbuffer EGL config or without a result within 2 seconds.onSurfaceDestroyed returns, as SurfaceHolder.Callback requires.texture2D(u_texture0, v_uv) showed them upside down. Remove any 1.0 - v_uv.y flip that compensated; see doc/migration.md.Reliability release. The public API is unchanged. Shader validation is stricter: static loops now need integer counters with values and steps in -255.
Reliability release. The public API is unchanged. Shader validation is stricter: static loops now need integer counters with values and steps in -255..255, so some shaders that were accepted before are now rejected.
fitCenter video live wallpapers instead of stretching them to the screen. Android's MediaPlayer has no aspect-preserving fit mode, so the plugin now draws the video between black bars with OpenGL ES 2. centerCrop is unchanged.-255..255; the existing 128-iteration limit remains.PHPhotosErrorDomain 3302.FlutterEngine when the Activity finishes, so the next launch after Back starts cold. The Android compatibility guide shows the same override.Android reliability release. The public API is unchanged, but rotation now needs HTTPS URLs and no longer uses a foreground service. See doc/migration
Android reliability release. The public API is unchanged, but rotation now needs HTTPS URLs and no longer uses a foreground service. See doc/migration.md.
<queries> for the live-wallpaper, chooser, set-wallpaper, and crop-and-set intents. Without them package visibility hid the system wallpaper apps, so getCapabilities() reported live, OpenGL, and picker support as unavailable, and the video, OpenGL, picker, cropper, and chooser flows failed with unsupported or system-ui-unavailable on devices that had them.WorkManager and the time-of-day trigger uses one inexact alarm re-armed after each delivery, which removes the FOREGROUND_SERVICE, POST_NOTIFICATIONS, and SCHEDULE_EXACT_ALARM permissions and keeps charging/time-of-day rotation working on Android 14+ and Android 15+.downloadWallpaper on Android 9 and older: saving to the gallery there needs WRITE_EXTERNAL_STORAGE, which the plugin does not declare, so the call always failed with a SecurityException after downloading the image. It now fails before downloading, logs the reason, and the README and Android guide explain what the host app must declare and request.systemCropper now reports an unreadable content URI as source-unavailable and a non-image one as invalid-content-type, the same codes the direct path uses. Before, Android's crop-intent lookup failed on the missing image type and the result was a generic system-ui-failed.fitCenter survives process death and cannot be applied to a different video.fitCenter and center produced an all-black screen and the other modes showed only a zoomed-in left strip of the image.22 to 6) are supported, equal start/end hours mean a full-day window, and alarm scheduling no longer drifts by the window length.WallpaperRotationStatus.totalCount now counts the requested sources and cachedCount the ones that loaded, so a source that failed to load is visible instead of both numbers matching.startWallpaperRotation, stopWallpaperRotation, rotateWallpaperNow, and getWallpaperRotationStatus now return an unsupported result / a not-running status off Android instead of falling through to a platform call.getWallpaperRotationStatus() no longer throws when the platform call fails; it returns a not-running status with lastError set instead.home/lock for each requested target, the same way Android does, instead of leaving them null.center, fill, stretch) now returns unsupported with video-scale-unsupported, as documented and as Android reports it. The Dart pre-check returned failed with invalid-input.texture-source-unavailable instead of configuration-store-failed, matching what the renderer reports for the same failure.FlutterEngine for the process. A new wallpaper changes the dynamic colors, Android relaunches the Activity, and the default FlutterActivity destroyed its engine, so the example restarted and never showed the applyWallpaper result. The Android compatibility guide now explains this relaunch and how a host app can keep its result.Full migration notes: doc/migration.md
…now) and mark the legacy live-wallpaper shortcut deprecated in favor of structured results.
WallpaperOperationResult and per-target home/lock outcomes instead of treating a UI launch as an applied wallpaper.getCapabilities() for static, live, OpenGL, target, picker, foreground, OEM, and GLES availability checks.goToHome request fields for source compatibility while removing package-side automatic navigation.Preserves 3.1.0 rotation feature (interval, charging, time-of-day triggers) and merges structured 3.2.0 APIs. See CHANGELOG.md and doc/android-compatibility.md for migration.
Pub.dev: Run flutter pub publish from main at c411160 (dry-run 0 warnings, 188 KB).
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/3.0.0...3.1.0
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/3.0.0...3.1.0
downloadWallpaper(...) API (iOS + Android).unsupported on iOS.Fixed example not building by @guyluz11 in https://github.com/codenameakshay/async_wallpaper/pull/44
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.1.0...3.0.0
fluttertoast dependency.Crash on android 14 while setting live wallpaper fixed. by @naeem-shah in https://github.com/codenameakshay/async_wallpaper/pull/36
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.0.3...2.1.0
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.0.2...2.0.3
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.0.2...2.0.3
2.0.2 | Fix: add timeout in goToHome + add toasts by @codenameakshay in https://github.com/codenameakshay/async_wallpaper/pull/18
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.0.1...2.0.2
2.0.1 | Fix: Update to Flutter 3.3.3 + Android 13 by @codenameakshay in https://github.com/codenameakshay/async_wallpaper/pull/13
Full Changelog: https://github.com/codenameakshay/async_wallpaper/compare/2.0.0...2.0.1
Breaking change - All methods now return a bool instead of String, to make error handling easier
- Add support for Android 12 - Fixed documentation
Add example gif, and screenshot
Supports setting wallpaper from file/url
One column per quarter.