> For the complete documentation index, see [llms.txt](https://docs.xibosignage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xibosignage.com/player-app-installation-and-upgrades/player-app-installation-and-version-upgrades.md).

# Player App Installation and Version Upgrades

1. **Configure** your device (steps dependent on your choice of media player hardware)
2. **Download and Install** the Xibo Media Player app (some hardware types have the Player app pre installed)
3. **Connect** the device to the CMS
4. **Authorise** as a Display in the CMS
5. **Activate** a Player licence (additional step for non-plan customers only)

| **Media Player Hardware** | **Quick Set up Guide**                                                                                                                                           |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Amazon Signage Stick      | [Download](https://xibosignage.com/api/downloads/913)                                                                                                            |
| Amino H Series            | [Download](https://xibosignage.com/api/downloads/916)                                                                                                            |
| DSDevices 9X/95           | [Download](https://xibosignage.com/api/downloads/915)                                                                                                            |
| Google ChromeOS           | [Download](https://xibosignage.com/api/downloads/922)                                                                                                            |
| HiSense SoC               | [Download](https://xibosignage.com/api/downloads/914)                                                                                                            |
| LG webOS SoC              | [Download](https://xibosignage.com/api/downloads/919)                                                                                                            |
| Philips SoC               | [Download](https://xibosignage.com/api/downloads/917)                                                                                                            |
| Sony Bravia               | [Download](https://www.google.com/url?q=https://xibosignage.com/api/downloads/920\&sa=D\&source=editors\&ust=1776678564418593\&usg=AOvVaw0IJiMKbq9rS04FA7mi1_Yo) |
| Samsung Tizen SoC         | [Download](https://xibosignage.com/api/downloads/918)                                                                                                            |

#### **Display Setting Profile (recommended)**

Once connected to the CMS, each Display will be assigned a default **Display Profile** which will apply all settings to all Displays assigned with that profile. Using Display Profiles to control versions and licensing is our recommended way in order to minimise potential errors across multiple Displays.

### **Upgrading a Player app version**

As new Player app releases are made available we recommend upgrading your Player app to the latest version in order to take advantage of all security and bug fixes which may have been included.

Our recommended Media Players can be upgraded from the CMS. Take a look at our device [comparison chart](https://docs.google.com/spreadsheets/d/e/2PACX-1vRMlLA1A40YBipC4Vx8bEjoQflGNy0AKtXa2Uc7e2UlZGnTvN5Mut7aTfbU9-6uAPvoZI3cbAc3Xdsm/pubhtml) to see which Media Players can be upgraded in this way:

1. **Download** the latest Player release
2. From the CMS, navigate to **Player Versions** under the **Displays** section of the main CMS menu
3. Click **Add Version**
4. **Upload** the downloaded Player release file
5. Go to **Display Settings**, use the row menu to select the **Display Profile** for the Player
6. Click **Edit** and open the **General** tab
7. Use the **Player Version** drop-down menu and select the new version
8. Click to **Save**

Displays which have the Display Profile assigned will now download the chosen version and install during their set download/upgrade window.

{% hint style="danger" %}
If you are not on a plan you will need to purchase a Player Licence in order to upgrade to a new major version!
{% 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 dynamically by asking a question.

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

```
GET https://docs.xibosignage.com/player-app-installation-and-upgrades/player-app-installation-and-version-upgrades.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
