> For the complete documentation index, see [llms.txt](https://helpdocs.conducttr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocs.conducttr.com/colibri/building-exercises/style/player-desktop.md).

# Player Desktop

How to style the player desktop

Within `Player desktop`, you can customise:

* **General desktop settings and style** (background/channel & player icons)
* **Content and questions** (change colour/font/size of persona and player messages)
* **Phone calls** (background/button customisation/logo)

### General desktop settings and style

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FWCTEIec9i7tpGWxEOD5g%2Fgeneral%20desktop%20settings%20and%20style.png?alt=media&amp;token=88a5f81c-49ec-4a04-8ad5-0649fe5734d0" alt="" width="416"><figcaption></figcaption></figure></div>

#### Background

Choose an eye-catching, but stylistically relevant background for your exercise:

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FyooDOUEXvOKl8X8GjtV7%2Fbackground1.png?alt=media&amp;token=4759c97b-e5a0-419d-a363-a075f05e8225" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If you're choosing a dark background, remember to change the channel text colour for visibility.
{% endhint %}

#### Channel icons

Here you can:

* Choose whether to have **channel icons visible from the start or only after the first message**&#x20;
* Modify channel icon **size**
* Edit channel icon **text** font, size, and colour

Customising channel icons can make exercises feel realistic as well as being potentially more visually-appealing. Click on channel icons directly to upload your own:

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FPBKGy0Hhe7qrqtGuzrQV%2Fchannel%20icon%20edit.png?alt=media&amp;token=a92eb7df-05c8-48d3-bc5d-14e107815e68" alt=""><figcaption></figcaption></figure></div>

This will open a new window:

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FjEQ17vnQQPhSEgyDvO8p%2Fslack.png?alt=media&amp;token=5579a456-bae7-4824-afff-08b25381e7f1" alt=""><figcaption></figcaption></figure></div>

<details>

<summary>Where to find channel icons</summary>

You can find free icons for popular apps on [www.flaticon.com](https://www.flaticon.com/).

</details>

{% hint style="info" %}
To find out more about styling channels, visit the page below:
{% endhint %}

{% content-ref url="/pages/jJn9eWOkcDOi7qD17RWp" %}
[Channels](/colibri/building-exercises/channels.md)
{% endcontent-ref %}

#### Player image

Click directly on the player details as you would the channel icons to edit:

* The icon that represents the player in the exercise&#x20;
* Which player details will be displayed (name, email address, role, position, and team)

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FBbL7oQ7PWJmNMEPbOvrj%2Fplayer%20image.png?alt=media&amp;token=d14576cc-87d7-452c-a21a-7b9c50cc9478" alt=""><figcaption></figcaption></figure></div>

### Content and questions

To edit persona and player messages specifically, click on them directly or navigate to `Content and questions` in the `Player Desktop`:

{% hint style="warning" %}
Ensure messages are, first and foremost, easy to read e.g. if you're setting the buttons to a dark colour ensure the text is light and vice versa.
{% endhint %}

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FubO7r3R1Zt07WKcZo2hG%2Fstyle.png?alt=media&amp;token=a456d5c8-ba82-4d2d-b04f-dc715c6134ba" alt=""><figcaption></figcaption></figure>

### Phone calls

For incoming phone calls, you can customise:&#x20;

* **Phone background**
* **Buttons**
* **Logo**

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2Frq3dQRyTN1j1Tne4lRL0%2Fphone%20call%20styling.png?alt=media&amp;token=f8f18136-53bf-4ead-9c0d-5613f8fe0cfd" alt=""><figcaption></figcaption></figure>


---

# 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://helpdocs.conducttr.com/colibri/building-exercises/style/player-desktop.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.
