> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/bluefletch-launcher/assets-manager.md).

# Assets Manager

Assets Manager is a Launcher feature that manages selected UI assets and files.

### Overview

Assets Manager is a Launcher feature that enables BlueFletch to download images and files to a device and use those assets for display purposes.

### User Guide

Assets Manager is used for importing, managing, and using resources on a device.

1. The Launcher configuration contains a collection of assets needed for the Launcher to work properly. These are files or images with designated names and values that represent their location on the internet.
2. When the Launcher starts up or detects a change in the configuration, it will read through the assets and download the files or images to a folder inside the device called the assets directory.
3. The Launcher uses the assets directory to obtain the appropriate icon or image that needs to be displayed on the home screen.
4. Assets allow the Launcher to reference files such as images and audio clips by URL, which is helpful in Android 11 and above because the operating system restricts access to external storage.

### Feature Configuration

To set up the Assets Manager feature for a particular device profile or device group, please follow the steps below:

#### Configuring the UI Assets and Files

Asset Manager defines a file location that the Launcher can then retrieve by a reference name. In the `"assets"` block of the Launcher configuration, give an asset a name (any string) and list a location to retrieve the asset, either the URL or file path on the device:

```json
"assets": {
    "imageName": "https://somewhere.com/image.png",
    "anotherImage": "https://somewhere.com/image2.png",
    "backgroundImage": "/sdcard/Download/ems/corporate_wallpaper.png",
    "logoImage": "/sdcard/Download/ems/corporate_logo.jpg"
}
```

#### Using the Assets for Theming

When configuring theming with parameters such as `"wallpaperImage"` or `"logo"`, an asset can be referenced by name in the `"theme"` object:

```json
"theme": {
    "logo": "assets:logoImage",
    ...
}
```

#### Using the Assets Within a Layout Item

The package name must be specified within a layout item while the specific asset must be set within the icon field. This will enable the Launcher to use icons or images in the assets directory.

<pre class="language-json"><code class="lang-json"><strong>"layouts": {
</strong><strong>       "Associates": [
</strong><strong>         {
</strong>                "package": "com.google.android.music",
                "icon": "assets:anotherImage"
         },
         ...
       ]
}
</code></pre>

{% hint style="info" %}
Assets Manager was introduced in Launcher 3.10.10.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/bluefletch-launcher/assets-manager.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.