📱 wallpaper_manager_plus #

A modern, lightweight Flutter plugin to set wallpapers on Android Home Screen, Lock Screen, or both. Supports static images and live video wallpapers. Built for performance, reliability, and large image support.

🔔 Why Choose wallpaper_manager_plus? #

✅ Built using Kotlin coroutines to handle wallpaper setting in a background thread — effectively preventing ANR (Application Not Responding) issues common in older implementations.

✅ Perfect for developers building wallpaper apps, personalization tools, or utilities requiring dynamic background changes.

📣 Have a feature request or bug to report? Open an issue or contribute via pull request!

🚀 Key Features #

• 🏠 Set wallpaper on Home Screen, Lock Screen, or Both
• 🎬 Set Live Wallpapers using video files (MP4)
• 🖼️ Seamless support for large images
• 💾 Works with cached network images and local files
• ⚡ Lightweight and easy to integrate
• 🔄 Compatible with Flutter null safety and latest Dart versions

📦 Installation #

Add to your pubspec.yaml:

dependencies:
  wallpaper_manager_plus: ^1.0.1

Import it in your Dart file:

import 'package:wallpaper_manager_plus/wallpaper_manager_plus.dart';

🛠️ How to Use #

🔹 Set Wallpaper from Cached Network Image #

To set a wallpaper from a remote image URL using caching, integrate the flutter_cache_manager:

Step 1: Add dependency

dependencies:
  flutter_cache_manager: ^3.4.0

Step 2: Import packages

import 'dart:io';
import 'package:flutter_cache_manager/flutter_cache_manager.dart';
import 'package:wallpaper_manager_plus/wallpaper_manager_plus.dart';

Step 3: Example code

String imageUrl = 'https://example.com/image.jpg';
File file = await DefaultCacheManager().getSingleFile(imageUrl);

int location = WallpaperManagerPlus.HOME_SCREEN;

await WallpaperManagerPlus().setWallpaper(file.path, location);

📌 Use a try-catch block for error handling.

🔹 Set Wallpaper from Local File #

Use a file from local storage:

String imagePath = '/storage/emulated/0/Download/image.png';
int location = WallpaperManagerPlus.HOME_SCREEN;

await WallpaperManagerPlus().setWallpaper(imagePath, location);

🔹 Set Live Wallpaper (Video) #

Set a video file as a live wallpaper:

String videoPath = '/storage/emulated/0/Download/video.mp4';

await WallpaperManagerPlus().setLiveWallpaper(videoPath);

Download and set from URL:

import 'package:flutter_cache_manager/flutter_cache_manager.dart';

String videoUrl = 'https://example.com/video.mp4';
var fileInfo = await DefaultCacheManager().downloadFile(videoUrl);
String videoPath = fileInfo.file.path;

await WallpaperManagerPlus().setLiveWallpaper(videoPath);

📌 The system wallpaper picker will open. Select your wallpaper service and confirm.

📷 Demo #

A small demo GIF included in this repository (see gifs/wallpaper.gif):

[Wallpaper demo]

💡 Full Example #

Check out the example/ directory for a complete working example.

🤝 Contribute to Development #

We welcome your contributions! If you want to:

• Add new features
• Fix bugs
• Improve documentation

Fork the repository and submit a pull request. Every contribution helps!