manage_wallpaper 0.0.2

A Flutter plugin to set wallpapers and live wallpapers across multiple platforms.

manage_wallpaper

English ∙ Deutsch

A Flutter plugin to set wallpapers and live wallpapers across multiple platforms.

Features

This plugin allows you to easily set wallpapers from local files or assets across different operating systems.

Method	Android	iOS	macOS	Windows	Linux
getPlatformVersion()	✅	⏳	⏳	✅	✅
setWallpaper(String path)	✅	⏳	⏳	✅	✅*
setLiveWallpaper({String? path})	✅	⏳	⏳	⏳	✅**

* Linux Support: Setting standard wallpapers is natively supported for GNOME (gsettings), KDE Plasma (qdbus), XFCE (xfconf-query), MATE/Cinnamon, as well as for Hyprland (via awww, hyprpaper, noctalia or swaybg) and generic X11 Window Managers (via feh). Setting live wallpapers (video) is supported on Wayland (via mpvpaper) and X11 (via xwinwrap and mpv). Live wallpapers automatically persist across reboots via XDG Autostart.

** Linux Live Wallpaper Prerequisites: Since Linux desktop environments are highly fragmented, this plugin relies on external tools to render video on the desktop background. You or your users must install the appropriate tools depending on the display server: Wayland requires mpvpaper, and X11 requires xwinwrap and mpv.

(Note: ⏳ indicates that the feature is planned or currently under development.)

Getting Started

Android

Requires the SET_WALLPAPER permission in your app's AndroidManifest.xml:

<uses-permission android:name="android.permission.SET_WALLPAPER" />

Usage

import 'package:manage_wallpaper/wallpaper.dart';

final wallpaper = Wallpaper();

// Set a wallpaper from a local file path
await wallpaper.setWallpaper('/path/to/your/image.jpg');

// Launch the live wallpaper chooser (Android only)
await wallpaper.setLiveWallpaper();

// Set a live wallpaper from a local video file (Linux)
await wallpaper.setLiveWallpaper(path: '/path/to/your/video.mp4');