# How to grant permanent wallpaper access in Smart Launcher

Some of Smart Launcher’s best features, like **blurred backgrounds**, **home screen screenshots**, and **backups that include your wallpaper**, need access to your wallpaper.

Starting with newer versions of Android, Google made it so that apps need special permission to access the wallpaper. However, due to Play Store rules, **we’re not allowed to request that permission directly inside the app**.

To solve this, you can grant the permission manually using a safe and official tool called **ADB (Android Debug Bridge)**. It takes just a few minutes, and once done, you’ll never have to repeat it, even after updates. You’ll only need to do it again if you uninstall and reinstall the app.

### Prerequisites (for all systems)

1. You must have a **USB cable** to connect your phone to your computer.
2. On your **Android phone**:
   * Go to **Settings > About phone**
   * Tap **Build number** 7 times to enable Developer options.
   * Then go to **Settings > System > Developer options**
   * Enable **USB debugging**
3. When prompted on your phone, tap **"Allow"** to authorize USB debugging.

***

### Windows

1. **Download ADB**:
   * Go to the official Android SDK Platform Tools page:\
     <https://developer.android.com/studio/releases/platform-tools>
   * Download the ZIP for Windows and extract it somewhere (e.g. `C:\adb`)
2. **Open Command Prompt**:
   * Press `Win + R`, type `cmd`, press Enter.
   * Navigate to the folder where you extracted ADB:

     ```sh
     cd C:\adb
     ```
3. **Run the command**:

   ```sh
   adb devices
   ```

   * This checks if your phone is connected properly.
   * It should show your device ID. If it says “unauthorized,” check your phone and authorize USB debugging.
4. **Grant the permission**:

   ```sh
   adb shell pm grant ginlemon.flowerfree android.permission.READ_EXTERNAL_STORAGE
   ```

***

### MacOS

1. **Install ADB** (choose one):
   * **With Homebrew** (recommended):

     ```sh
     brew install android-platform-tools
     ```
   * Or download manually from:\
     <https://developer.android.com/studio/releases/platform-tools>
2. **Open Terminal** (⌘ + Space, type “Terminal”)
3. **Connect the device and check connection**:

   ```sh
   adb devices
   ```

   * Authorize your Mac on your phone if prompted.
4. **Grant the permission**:

   ```sh
   adb shell pm grant ginlemon.flowerfree android.permission.READ_EXTERNAL_STORAGE
   ```

***

### Linux (Ubuntu/Debian/Fedora/Arch)

1. **Install ADB**:
   * Debian/Ubuntu:

     ```sh
     sudo apt install android-tools-adb
     ```
   * Fedora:

     ```sh
     sudo dnf install android-tools
     ```
   * Arch:

     ```sh
     sudo pacman -S android-tools
     ```
2. **Open a terminal**
3. **Connect the device and check connection**:

   ```sh
   adb devices
   ```
4. **Grant the permission**:

   ```sh
   adb shell pm grant ginlemon.flowerfree android.permission.READ_EXTERNAL_STORAGE
   ```

***

### How to verify it worked

1. Open Smart Launcher.
2. Try again any feature that previously failed due to the missing permission.

If something still doesn’t work, try restarting the phone.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smartlauncher.net/faq/personalization/limited-access-to-wallpaper/how-to-grant-permanent-wallpaper-access-in-smart-launcher.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.