Skip to content
pubscout

async_wallpaper

3.7.0, released 2 weeks ago by hashstudios.dev

Set static, live video, OpenGL wallpapers and schedule rotations asynchronously on Android and iOS.

WASM-ready
$ flutter pub add async_wallpaper
Source repository

What it does

Allows Flutter apps to set static wallpapers from URLs, files, content URIs, or bytes, as well as handle video and OpenGL live wallpapers. It also provides capabilities for daily wallpaper schedules and rotations on Android, and downloading images to photos on iOS.

AI-written summary of version 3.7.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to set home screen or lock screen wallpapers programmatically from an Android app.
  • You want to implement live video or OpenGL shader wallpapers with rotation and daily schedules.
  • You need to check device capabilities before showing wallpaper actions.

Skip it when

  • You are building for Web or desktop platforms where wallpaper setting is unsupported.
  • You need complex UI components or built-in wallpaper selection screens.

Strengths

  • Supports static images, video live wallpapers, and custom OpenGL fragment shaders.
  • Built-in support for daily wallpaper scheduling and automatic wallpaper rotation.
  • Detailed capability checks and operation status tracking.

Weaknesses

  • Live wallpapers, rotation, and daily schedules are Android-only; iOS is limited to downloading wallpapers.
  • Requires specific platform minimums like Android minSdk 24 and iOS 13.0+.

Setup

Kind
Plugin (native code)
Effort
Low
Code generation
No
Direct dependencies
0

Add async_wallpaper to pubspec.yaml. For iOS downloads, add NSPhotoLibraryAddUsageDescription to Info.plist. For older Android versions, declare WRITE_EXTERNAL_STORAGE permission.

final result = await AsyncWallpaper.applyWallpaper(
  const StaticWallpaperRequest(
    source: WallpaperSource.url('https://example.com/wallpaper.jpg'),
    target: WallpaperTarget.both,
    scaleMode: WallpaperScaleMode.centerCrop,
    strategy: WallpaperApplyStrategy.direct,
  ),
);

Alternatives

Packages that do the same job and could replace async_wallpaper.