📱 react-native-wallpaper-setter

A lightweight React Native module to set wallpapers on Android, either automatically or via the system picker.

Features

• ✅ Supports remote URLs or local file paths
• ✅ Auto-set wallpaper (programmatically)
• ✅ Open wallpaper picker (user confirmation)
• ✅ Minimal setup, written in Kotlin
• ✅ Works on Android 8–14

🚀 Installation

npm install react-native-wallpaper-setter
# or
yarn add react-native-wallpaper-setter

Android

inside AndroidManifest.xml

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

Usage

import { setWallpaperAuto, setWallpaperWithPicker } from 'react-native-wallpaper-setter';

async function main() {
  // 1️⃣ Set automatically from a URL
  await setWallpaperAuto('https://picsum.photos/1080/1920');

  // 2️⃣ Or let the user confirm
  const path = 'file:///storage/emulated/0/Download/image.jpg';
  await setWallpaperWithPicker(path);
}

| Method | Description | Params | | ----------------------------------- | ----------------------------- | ---------------------- | | setWallpaperAuto(pathOrUrl) | Sets wallpaper automatically | URL or local file path | | setWallpaperWithPicker(localPath) | Opens system wallpaper picker | Local path only |