react-native-nitro-wallpaper 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 rahulmandyal1
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# react-native-nitro-wallpaper
+
+Set wallpaper on React Native (Android only)
+
+## Installation
+
+```sh
+npm install react-native-nitro-wallpaper react-native-nitro-modules
+```
+
+> `react-native-nitro-modules` is required as this library relies on [Nitro Modules](https://nitro.margelo.com/).
+
+### Android Setup
+
+No additional setup required. The library will be automatically linked.
+
+> **Note:** This library is Android-only. iOS is not supported. If you try to use it on iOS, it will throw an error.
+
+## Usage
+
+```js
+import { WallpaperSet } from 'react-native-nitro-wallpaper';
+
+// Set wallpaper from URL
+await WallpaperSet.setWallpaper('https://example.com/image.jpg');
+
+// Set wallpaper from local file path
+await WallpaperSet.setWallpaper('/storage/emulated/0/Pictures/wallpaper.jpg');
+
+// Set wallpaper from file URI
+await WallpaperSet.setWallpaper('file:///storage/emulated/0/Pictures/wallpaper.jpg');
+
+// Set wallpaper from content URI
+await WallpaperSet.setWallpaper('content://media/external/images/media/123');
+```
+
+### Example
+
+```jsx
+import React from 'react';
+import { Button, Alert } from 'react-native';
+import { WallpaperSet } from 'react-native-nitro-wallpaper';
+
+function App() {
+  const handleSetWallpaper = async () => {
+    try {
+      await WallpaperSet.setWallpaper('https://images.unsplash.com/photo-1506744038136-46273834b3fb');
+      Alert.alert('Success', 'Wallpaper set successfully!');
+    } catch (error) {
+      Alert.alert('Error', error.message);
+    }
+  };
+
+  return <Button title="Set Wallpaper" onPress={handleSetWallpaper} />;
+}
+```
+
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(reactnativenitrowallpaper)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME reactnativenitrowallpaper)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/reactnativenitrowallpaper+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,129 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['WallpaperSet_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/reactnativenitrowallpaper+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["WallpaperSet_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.reactnativenitrowallpaper"
+
+  ndkVersion "26.1.10909125"
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+            "META-INF",
+            "META-INF/**",
+            "**/libc++_shared.so",
+            "**/libfbjni.so",
+            "**/libjsi.so",
+            "**/libfolly_json.so",
+            "**/libfolly_runtime.so",
+            "**/libglog.so",
+            "**/libhermes.so",
+            "**/libhermes-executor-debug.so",
+            "**/libhermes_executor.so",
+            "**/libreactnative.so",
+            "**/libreactnativejni.so",
+            "**/libturbomodulejsijni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation project(":react-native-nitro-modules")
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+WallpaperSet_kotlinVersion=2.0.21
+WallpaperSet_minSdkVersion=24
+WallpaperSet_targetSdkVersion=34
+WallpaperSet_compileSdkVersion=35
+WallpaperSet_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.SET_WALLPAPER"/>
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "reactnativenitrowallpaperOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::reactnativenitrowallpaper::initialize(vm);
+}

package/android/src/main/java/com/margelo/nitro/reactnativenitrowallpaper/WallpaperSet.kt

@@ -0,0 +1,53 @@
+package com.margelo.nitro.reactnativenitrowallpaper
+  
+import com.facebook.proguard.annotations.DoNotStrip
+
+import android.app.WallpaperManager
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.net.Uri
+import com.margelo.nitro.core.Promise
+import java.net.URL
+
+@DoNotStrip
+class WallpaperSet : HybridWallpaperSetSpec() {
+  override fun setWallpaper(image: String): Promise<Unit> {
+    val promise = Promise<Unit>()
+    val context = WallpaperSetPackage.context
+    if (context == null) {
+      promise.reject(Exception("Context not initialized"))
+      return promise
+    }
+
+    Thread {
+      try {
+        val wallpaperManager = WallpaperManager.getInstance(context)
+        val bitmap: Bitmap?
+
+        if (image.startsWith("http")) {
+          val url = URL(image)
+          bitmap = BitmapFactory.decodeStream(url.openStream())
+        } else if (image.startsWith("file://") || image.startsWith("content://")) {
+          val uri = Uri.parse(image)
+          val inputStream = context.contentResolver.openInputStream(uri)
+            ?: throw Exception("Could not open input stream for URI: $image")
+          bitmap = BitmapFactory.decodeStream(inputStream)
+          inputStream?.close()
+        } else {
+          bitmap = BitmapFactory.decodeFile(image)
+        }
+
+        if (bitmap == null) {
+          throw Exception("Failed to decode bitmap from: $image")
+        }
+
+        wallpaperManager.setBitmap(bitmap)
+        promise.resolve(Unit)
+      } catch (e: Throwable) {
+        promise.reject(e)
+      }
+    }.start()
+
+    return promise
+  }
+}

package/android/src/main/java/com/margelo/nitro/reactnativenitrowallpaper/WallpaperSetPackage.kt

@@ -0,0 +1,31 @@
+package com.margelo.nitro.reactnativenitrowallpaper
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+import android.util.Log
+
+class WallpaperSetPackage : BaseReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+        return null
+    }
+
+    override fun createNativeModules(reactContext: ReactApplicationContext): MutableList<NativeModule> {
+        Log.d("WallpaperSetPackage", "createNativeModules called!")
+        context = reactContext
+        return super.createNativeModules(reactContext) as MutableList<NativeModule>
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider { HashMap() }
+    }
+
+    companion object {
+        var context: android.content.Context? = null
+        init {
+            System.loadLibrary("reactnativenitrowallpaper")
+        }
+    }
+}

package/lib/module/WallpaperSet.nitro.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=WallpaperSet.nitro.js.map

package/lib/module/WallpaperSet.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["WallpaperSet.nitro.ts"],"mappings":"","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { NitroModules } from 'react-native-nitro-modules';
+import { Platform } from 'react-native';
+const WallpaperSetNative = NitroModules.createHybridObject('WallpaperSet');
+export const WallpaperSet = {
+  setWallpaper: async image => {
+    if (Platform.OS === 'ios') {
+      throw new Error('react-native-nitro-wallpaper is Android-only. iOS is not supported.');
+    }
+    return WallpaperSetNative.setWallpaper(image);
+  }
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NitroModules","Platform","WallpaperSetNative","createHybridObject","WallpaperSet","setWallpaper","image","OS","Error"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AACzD,SAASC,QAAQ,QAAQ,cAAc;AAGvC,MAAMC,kBAAkB,GACtBF,YAAY,CAACG,kBAAkB,CAAmB,cAAc,CAAC;AAEnE,OAAO,MAAMC,YAAY,GAAG;EAC1BC,YAAY,EAAE,MAAOC,KAAa,IAAoB;IACpD,IAAIL,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;MACzB,MAAM,IAAIC,KAAK,CACb,qEACF,CAAC;IACH;IACA,OAAON,kBAAkB,CAACG,YAAY,CAACC,KAAK,CAAC;EAC/C;AACF,CAAC","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/WallpaperSet.nitro.d.ts

@@ -0,0 +1,7 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+export interface WallpaperSet extends HybridObject<{
+    android: 'kotlin';
+}> {
+    setWallpaper(image: string): Promise<void>;
+}
+//# sourceMappingURL=WallpaperSet.nitro.d.ts.map

package/lib/typescript/src/WallpaperSet.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WallpaperSet.nitro.d.ts","sourceRoot":"","sources":["../../../src/WallpaperSet.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,WAAW,YAAa,SAAQ,YAAY,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IACvE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,4 @@
+export declare const WallpaperSet: {
+    setWallpaper: (image: string) => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;0BACK,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;CAQnD,CAAC"}

package/nitro.json

@@ -0,0 +1,16 @@
+{
+  "cxxNamespace": ["reactnativenitrowallpaper"],
+  "android": {
+    "androidNamespace": ["reactnativenitrowallpaper"],
+    "androidCxxLibName": "reactnativenitrowallpaper"
+  },
+  "ios": {
+    "iosModuleName": "ReactNativeNitroWallpaper"
+  },
+  "autolinking": {
+    "WallpaperSet": {
+      "kotlin": "WallpaperSet"
+    }
+  },
+  "ignorePaths": ["node_modules"]
+}

package/nitrogen/generated/android/c++/JHybridWallpaperSetSpec.cpp

@@ -0,0 +1,64 @@
+///
+/// JHybridWallpaperSetSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "JHybridWallpaperSetSpec.hpp"
+
+
+
+#include <NitroModules/Promise.hpp>
+#include <NitroModules/JPromise.hpp>
+#include <string>
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+  jni::local_ref<JHybridWallpaperSetSpec::jhybriddata> JHybridWallpaperSetSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
+    return makeCxxInstance(jThis);
+  }
+
+  void JHybridWallpaperSetSpec::registerNatives() {
+    registerHybrid({
+      makeNativeMethod("initHybrid", JHybridWallpaperSetSpec::initHybrid),
+    });
+  }
+
+  size_t JHybridWallpaperSetSpec::getExternalMemorySize() noexcept {
+    static const auto method = javaClassStatic()->getMethod<jlong()>("getMemorySize");
+    return method(_javaPart);
+  }
+
+  void JHybridWallpaperSetSpec::dispose() noexcept {
+    static const auto method = javaClassStatic()->getMethod<void()>("dispose");
+    method(_javaPart);
+  }
+
+  std::string JHybridWallpaperSetSpec::toString() {
+    static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
+    auto javaString = method(_javaPart);
+    return javaString->toStdString();
+  }
+
+  // Properties
+  
+
+  // Methods
+  std::shared_ptr<Promise<void>> JHybridWallpaperSetSpec::setWallpaper(const std::string& image) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* image */)>("setWallpaper");
+    auto __result = method(_javaPart, jni::make_jstring(image));
+    return [&]() {
+      auto __promise = Promise<void>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& /* unit */) {
+        __promise->resolve();
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/nitrogen/generated/android/c++/JHybridWallpaperSetSpec.hpp

@@ -0,0 +1,65 @@
+///
+/// HybridWallpaperSetSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <NitroModules/JHybridObject.hpp>
+#include <fbjni/fbjni.h>
+#include "HybridWallpaperSetSpec.hpp"
+
+
+
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+  using namespace facebook;
+
+  class JHybridWallpaperSetSpec: public jni::HybridClass<JHybridWallpaperSetSpec, JHybridObject>,
+                                 public virtual HybridWallpaperSetSpec {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/reactnativenitrowallpaper/HybridWallpaperSetSpec;";
+    static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
+    static void registerNatives();
+
+  protected:
+    // C++ constructor (called from Java via `initHybrid()`)
+    explicit JHybridWallpaperSetSpec(jni::alias_ref<jhybridobject> jThis) :
+      HybridObject(HybridWallpaperSetSpec::TAG),
+      HybridBase(jThis),
+      _javaPart(jni::make_global(jThis)) {}
+
+  public:
+    ~JHybridWallpaperSetSpec() override {
+      // Hermes GC can destroy JS objects on a non-JNI Thread.
+      jni::ThreadScope::WithClassLoader([&] { _javaPart.reset(); });
+    }
+
+  public:
+    size_t getExternalMemorySize() noexcept override;
+    void dispose() noexcept override;
+    std::string toString() override;
+
+  public:
+    inline const jni::global_ref<JHybridWallpaperSetSpec::javaobject>& getJavaPart() const noexcept {
+      return _javaPart;
+    }
+
+  public:
+    // Properties
+    
+
+  public:
+    // Methods
+    std::shared_ptr<Promise<void>> setWallpaper(const std::string& image) override;
+
+  private:
+    friend HybridBase;
+    using HybridBase::HybridBase;
+    jni::global_ref<JHybridWallpaperSetSpec::javaobject> _javaPart;
+  };
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/nitrogen/generated/android/kotlin/com/margelo/nitro/reactnativenitrowallpaper/HybridWallpaperSetSpec.kt

@@ -0,0 +1,58 @@
+///
+/// HybridWallpaperSetSpec.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.reactnativenitrowallpaper
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.Promise
+import com.margelo.nitro.core.HybridObject
+
+/**
+ * A Kotlin class representing the WallpaperSet HybridObject.
+ * Implement this abstract class to create Kotlin-based instances of WallpaperSet.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "SimpleRedundantLet",
+  "LocalVariableName", "PropertyName", "PrivatePropertyName", "FunctionName"
+)
+abstract class HybridWallpaperSetSpec: HybridObject() {
+  @DoNotStrip
+  private var mHybridData: HybridData = initHybrid()
+
+  init {
+    super.updateNative(mHybridData)
+  }
+
+  override fun updateNative(hybridData: HybridData) {
+    mHybridData = hybridData
+    super.updateNative(hybridData)
+  }
+
+  // Default implementation of `HybridObject.toString()`
+  override fun toString(): String {
+    return "[HybridObject WallpaperSet]"
+  }
+
+  // Properties
+  
+
+  // Methods
+  @DoNotStrip
+  @Keep
+  abstract fun setWallpaper(image: String): Promise<Unit>
+
+  private external fun initHybrid(): HybridData
+
+  companion object {
+    protected const val TAG = "HybridWallpaperSetSpec"
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/reactnativenitrowallpaper/reactnativenitrowallpaperOnLoad.kt

@@ -0,0 +1,35 @@
+///
+/// reactnativenitrowallpaperOnLoad.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.reactnativenitrowallpaper
+
+import android.util.Log
+
+internal class reactnativenitrowallpaperOnLoad {
+  companion object {
+    private const val TAG = "reactnativenitrowallpaperOnLoad"
+    private var didLoad = false
+    /**
+     * Initializes the native part of "reactnativenitrowallpaper".
+     * This method is idempotent and can be called more than once.
+     */
+    @JvmStatic
+    fun initializeNative() {
+      if (didLoad) return
+      try {
+        Log.i(TAG, "Loading reactnativenitrowallpaper C++ library...")
+        System.loadLibrary("reactnativenitrowallpaper")
+        Log.i(TAG, "Successfully loaded reactnativenitrowallpaper C++ library!")
+        didLoad = true
+      } catch (e: Error) {
+        Log.e(TAG, "Failed to load reactnativenitrowallpaper C++ library! Is it properly installed and linked? " +
+                    "Is the name correct? (see `CMakeLists.txt`, at `add_library(...)`)", e)
+        throw e
+      }
+    }
+  }
+}

package/nitrogen/generated/android/reactnativenitrowallpaper+autolinking.cmake

@@ -0,0 +1,81 @@
+#
+# reactnativenitrowallpaper+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/reactnativenitrowallpaper+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_REACTNATIVENITROWALLPAPER_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  reactnativenitrowallpaper PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/reactnativenitrowallpaperOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridWallpaperSetSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridWallpaperSetSpec.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  reactnativenitrowallpaper PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        reactnativenitrowallpaper
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        reactnativenitrowallpaper
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        reactnativenitrowallpaper
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/reactnativenitrowallpaper+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// reactnativenitrowallpaper+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/reactnativenitrowallpaper+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 reactnativenitrowallpaper is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/reactnativenitrowallpaperOnLoad.cpp

@@ -0,0 +1,44 @@
+///
+/// reactnativenitrowallpaperOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_REACTNATIVENITROWALLPAPER_WITH_GENERATED_CMAKE_PROJECT
+#error reactnativenitrowallpaperOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "reactnativenitrowallpaperOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "JHybridWallpaperSetSpec.hpp"
+#include <NitroModules/DefaultConstructableObject.hpp>
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::reactnativenitrowallpaper;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    margelo::nitro::reactnativenitrowallpaper::JHybridWallpaperSetSpec::registerNatives();
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "WallpaperSet",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridWallpaperSetSpec::javaobject> object("com/margelo/nitro/reactnativenitrowallpaper/WallpaperSet");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/nitrogen/generated/android/reactnativenitrowallpaperOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// reactnativenitrowallpaperOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+  /**
+   * Initializes the native (C++) part of reactnativenitrowallpaper, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::reactnativenitrowallpaper::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/nitrogen/generated/shared/c++/HybridWallpaperSetSpec.cpp

@@ -0,0 +1,21 @@
+///
+/// HybridWallpaperSetSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridWallpaperSetSpec.hpp"
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+  void HybridWallpaperSetSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("setWallpaper", &HybridWallpaperSetSpec::setWallpaper);
+    });
+  }
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/nitrogen/generated/shared/c++/HybridWallpaperSetSpec.hpp

@@ -0,0 +1,63 @@
+///
+/// HybridWallpaperSetSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <NitroModules/Promise.hpp>
+#include <string>
+
+namespace margelo::nitro::reactnativenitrowallpaper {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `WallpaperSet`
+   * Inherit this class to create instances of `HybridWallpaperSetSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridWallpaperSet: public HybridWallpaperSetSpec {
+   * public:
+   *   HybridWallpaperSet(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridWallpaperSetSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridWallpaperSetSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridWallpaperSetSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> setWallpaper(const std::string& image) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "WallpaperSet";
+  };
+
+} // namespace margelo::nitro::reactnativenitrowallpaper

package/package.json

@@ -0,0 +1,186 @@
+{
+  "name": "react-native-nitro-wallpaper",
+  "version": "1.0.0",
+  "description": "Set wallpaper on React Native (Android only)",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "react-native.config.js",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-wallpaper-set-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest --passWithNoTests",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "android",
+    "wallpaper",
+    "react-native-wallpaper",
+    "wallpaper-manager",
+    "react-native-wallpaper-manager",
+    "set-wallpaper",
+    "set-wallpaper-react-native",
+    "wallpaper-manager-app",
+    "react-native-wallpaper-manager-app",
+    "android-wallpaper",
+    "change-wallpaper",
+    "wallpaper-setter",
+    "nitro-modules"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RahulMandyal1/react-native-nitro-wallpaper.git"
+  },
+  "author": "rahulmandyal1 <rahulmandyal079@gmail.com> (https://github.com/RahulMandyal1)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/RahulMandyal1/react-native-nitro-wallpaper/issues"
+  },
+  "homepage": "https://github.com/RahulMandyal1/react-native-nitro-wallpaper#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "nitrogen": "^0.31.10",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.17",
+    "react-native-nitro-modules": "^0.31.10",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.31.10"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  },
+  "directories": {
+    "example": "example",
+    "lib": "lib"
+  }
+}

package/react-native.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      // Android-only package, iOS not supported
+      android: {
+        sourceDir: '../android',
+        packageImportPath:
+          'import com.margelo.nitro.reactnativenitrowallpaper.WallpaperSetPackage;',
+      },
+    },
+  },
+};

package/src/WallpaperSet.nitro.ts

@@ -0,0 +1,5 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface WallpaperSet extends HybridObject<{ android: 'kotlin' }> {
+  setWallpaper(image: string): Promise<void>;
+}

package/src/index.tsx

@@ -0,0 +1,17 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import { Platform } from 'react-native';
+import type { WallpaperSet as WallpaperSetSpec } from './WallpaperSet.nitro';
+
+const WallpaperSetNative =
+  NitroModules.createHybridObject<WallpaperSetSpec>('WallpaperSet');
+
+export const WallpaperSet = {
+  setWallpaper: async (image: string): Promise<void> => {
+    if (Platform.OS === 'ios') {
+      throw new Error(
+        'react-native-nitro-wallpaper is Android-only. iOS is not supported.'
+      );
+    }
+    return WallpaperSetNative.setWallpaper(image);
+  },
+};