Wallcraft Manager #

A Flutter plugin for setting wallpapers and saving images to gallery on Android and iOS.

Features #

• ✅ Set wallpapers on Android (home screen, lock screen, or both)
• ✅ Save images to device gallery on both platforms
• ✅ Support for both file paths and image bytes
• ✅ Proper error handling and permission management
• ✅ Modern Android API support (MediaStore for Android 10+)
• ✅ iOS Photos framework integration

Platform Support #

*iOS doesn't support programmatic wallpaper setting due to platform limitations. The plugin will save the image to Photos and show instructions to the user.

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  wallcraft_manager: ^1.0.0

Setup #

Android #

Add the following permissions to your android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.SET_WALLPAPER" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

iOS #

Add the following to your ios/Runner/Info.plist:

<key>NSPhotoLibraryAddUsageDescription</key>
<string>This app needs access to save images to your photo library.</string>

Usage #

import 'package:wallcraft_manager/wallcraft_manager.dart';
import 'package:wallcraft_manager/enum/wallpaper_setter_type.dart';

final wallcraftManager = WallcraftManager();

// Check if wallpaper setting is supported
bool isSupported = await wallcraftManager.isSupported();

// Set wallpaper from file
bool success = await wallcraftManager.setWallpaperFromFile(
  filePath: '/path/to/image.jpg',
  type: WallpaperSetterType.home,
);

// Set wallpaper from bytes
bool success = await wallcraftManager.setWallpaperFromBytes(
  bytes: imageBytes,
  type: WallpaperSetterType.both,
);

// Save image to gallery
bool saved = await wallcraftManager.saveImageToGalleryFromFile(
  filePath: '/path/to/image.jpg',
);

Error Handling #

The plugin throws PlatformException with the following error codes:

• INVALID_ARGUMENT: Missing or invalid parameters
• FILE_NOT_FOUND: Image file doesn't exist
• PERMISSION_DENIED: Missing required permissions
• INVALID_IMAGE: Invalid image format or corrupted data
• SAVE_ERROR: Failed to save image to gallery
• SET_WALLPAPER_ERROR: Failed to set wallpaper

try {
  bool success = await wallcraftManager.setWallpaperFromFile(
    filePath: imagePath,
    type: WallpaperSetterType.home,
  );
} on PlatformException catch (e) {
  print('Error: ${e.code} - ${e.message}');
}

Contributing #

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

License #

MIT License - see LICENSE file for details.