wallpaper_handler

Description:

wallpaper handler

wallpaper_handler #
A Flutter package for easy wallpaper customization on Android devices – get wallpaper, change Home Screen, Lock Screen, or both with simplicity.
Usage #
Installation #
Add the following dependency to your Flutter project's pubspec.yaml file:
dependencies:
wallpaper_handler: ^0.0.2
copied to clipboard
Include the following import statement in your Dart library:
import 'package:wallpaper_handler/wallpaper_handler.dart';
copied to clipboard
The wallpaper_handler plugin provides an enum named WallpaperLocation to specify different wallpaper locations.
enum WallpaperLocation {
/// Wallpaper for the home screen.
homeScreen,

/// Wallpaper for the lock screen.
lockScreen,

/// Wallpaper for both the home and lock screens.
bothScreens,
}
copied to clipboard
Examples #
Setting Wallpaper from File
const filePath = "/path/to/file/on/disk";
const wallpaperLocation = WallpaperLocation.homeScreen;

// Without crop bounds
bool result = await WallpaperHandler.instance.setWallpaperFromFile(path, location);

// With crop bounds
const cropBounds = Rect.fromLTRB(100, 100, 200, 100);
bool result = await WallpaperHandler.instance.setWallpaperFromFile(path, location, cropBounds: cropBounds);
copied to clipboard
Setting Wallpaper from Asset
const assetPath = 'assets/images/test.jpg';
const wallpaperLocation = WallpaperLocation.homeScreen;

// Without crop bounds
bool result = await WallpaperHandler.instance.setWallpaperFromAsset(path, location);

// With crop bounds
const cropBounds = Rect.fromLTRB(100, 100, 200, 100);
bool result = await WallpaperHandler.instance.setWallpaperFromAsset(path, location, cropBounds: cropBounds);
copied to clipboard
Loading from a URL (with CacheManager, the image is saved to app files as well)
If you're loading a Wallpaper from a URL, you should save it to the disk first, then use the path of the saved image file.
Add flutter_cache_manager or any other dependency you'd like:
dependencies:
flutter_cache_manager: "^1.1.3"
copied to clipboard
And in dart code
String url = "";
var file = await DefaultCacheManager().getSingleFile(url);
bool result = await WallpaperHandler.instance.setWallpaperFromFile(file.path, location);
copied to clipboard
Retrieving Current Wallpaper
To get the device wallpaper, you need to add the following permission to your app's AndroidManifest.xml file:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
copied to clipboard
You also need to request the permission at runtime before using the plugin.
The getWallpaper method retrieves the device wallpaper but it only allows specifying homeScreen or lockScreen as the wallpaper location. This method returns a Uint8List? representing the phone's wallpaper.
Uint8List? result = await WallpaperHandler.instance.getWallpaper(WallpaperLocation.homeScreen);
copied to clipboard
Make sure to handle the result appropriately, as it may be null if no wallpaper is set or if there are errors during retrieval.
Contributor's Guidelines: #
Welcome contributions! Please create pull requests on the 'develop' branch. Thanks!
Reporting Issues/Requests: #
Please share the following to help us identify the issue's root cause.

Library version
Code snippet
Logs (if applicable)
Device details (Manufacturer, OS version, etc.)
Screenshot/video with issue reproduction steps.

License Information: #
The wallpaper_handler is licensed under MIT-licensed.
Share Your Projects: #
We'd love to see your projects using our component. Email us at [email protected]. Feel free to reach out with questions or suggestions.