# Producers and Observers

Congratulations! You've gotten yourself an Organization Key and are now ready to use Spectra. Follow the steps below to complete setup so you can get to broadcasting your matches!

{% tabs %}
{% tab title="1. App setup" %}

## 1. Download the client

{% hint style="info" %}
You can safely skip this section if you already have the Spectra client installed.
{% endhint %}

The most recent version of the Spectra Client can be downloaded here: [**Download**](https://valospectra.com/download) 

The installer places two shortcuts to the software on your desktop. 

*Spectra Client* starts the observer version of the client. [*\[Player\] Spectra Client*](/players.md) leads to the player version.

## 2. Enter Connection Information

The first box contains fields that hold your connection information. Three fields require attention:

* #### **Key**
  * This is an access key that allows you to run your game on the chosen server. It is essentially a password that you get from us. If you haven't obtained a key yet, please check out [Obtaining an Organization Key](/obtaining-an-organization-key.md) and follow the steps.
* #### **Group Code**
  * The group code generally differentiates your game from all others that could be running at the same time. Choose a sequence of characters. The link to the overlay at the end will include this sequence. If you have multiple games running simultaneously, you should give them different group codes. Overlays for both games will be available on different links.
* #### **Server IP**
  * Input the IP address of the server you want to connect to here. For our Spectra Servers, simply enter `eu.valospectra.com` or `na.valospectra.com` depending on your region. Note that this server does not need to be the Valorant Server region that your game takes place on; simply choose the server closest to you.

{% hint style="warning" %}
Make sure to **never** share your access key with anyone outside of your organization. If you get a message stating that your message to the bot couldn't be delivered, please **check your privacy settings for the Spectra server**. Direct messages **must be enabled**.
{% endhint %}

## 3. Enter Team Information

In the bottom half of the client, you can enter information about the teams that are playing the game. Note that the logo URL needs to point directly to the image file on the web. The link should end with one of the following file types: 

* `.png`
* `.jpeg/jpg`
* `.webp` 

If the image is not one of these file types, the image might not work in the overlay.

{% hint style="info" %}
.webp is always the recommended file type due to its small size and ability to use alpha channels (transparency).
{% endhint %}

## 4. Open your game and connect

You should always try to **open** the client <mark style="color:yellow;">**before**</mark> VALORANT starts. When the client detects your game as running, it will display the account's Riot ID in the top-left.
\
Press the "Connect" button in the client to start the game on Spectra. When connected, you can start the match in VALORANT. If the client detects your game in Agent Select, it will try to connect automatically. *Still, you should try to connect yourself beforehand.*
\
Spectra is designed to work as an observer overlay. As such, you will need to join the game as an observer/spectator.

{% hint style="warning" %}
When in-game, you might notice that some players have a **??** in place of their gun. This is a [known bug](https://discord.com/channels/1272281371888320562/1300936200567263295/1300936333438746685) and stems from Overwolf, the platform that Spectra relies on to obtain data. If you receive this bug in a multi-game series, it's recommended that all observers disconnect while in the lobby for the second match and then reconnect.
{% endhint %}
{% endtab %}

{% tab title="2. Overlay setup" %}
Congratulations. Spectra is now connected and it will start showing information such at teams logos, names, score, showing timeouts, etc. Now, you'd like to show that to the people that are watching, right? Well, follow the below steps, to set it up in OBS.

## In-game overlay

In OBS, create a new browser source, change the dimensions to 1920x1080 and add the following link:

```
https://[eu/na].valospectra.com/overlay?groupCode=GROUPCODEHERE
```

Make sure to replace \[eu/na] with the region, you're from, as shown on the image below. If you're outside of those 2, choose the one that's closest to you. For example, if you're from EU, you'll type: *<https://eu.valospectra>...*<br>

<figure><img src="/files/CTit672TsfSVIwLLqwBe" alt=""><figcaption></figcaption></figure>

## Agent select

In OBS, create a new browser source, change the dimensions to 1920x1080 and add the following link:

```
https://[eu/na].valospectra.com/agent-select?groupCode=GROUPCODEHERE
```

Make sure to replace \[eu/na] with the region, you're from, as shown on the image below. If you're outside of those 2, choose the one that's closest to you. For example, if you're from EU, you'll type: *<https://eu.valospectra>...*

<figure><img src="/files/tvPJZmDYALYKAWAtThO6" alt=""><figcaption></figcaption></figure>

## Auto switch

This will switch between the two variants on its own once the agent selection is complete. If you don't want to manage such a scene transition by yourself **we recommend using this endpoint for your overlay**. Make sure that the dimensions are set to 1920x1080

```
https://[eu/na].valospectra.com/autoswitch?groupCode=GROUPCODEHERE
```

Make sure to replace \[eu/na] with the region, you're from, as shown on the image below. If you're outside of those 2, choose the one that's closest to you. For example, if you're from EU, you'll type: *<https://eu.valospectra>...*

<figure><img src="/files/LhfBp1az8e2fSAtBM9iE" alt=""><figcaption></figcaption></figure>

## Minimal

In case you encounter the known bug where some players get ?? shown as their weapon, we've made minimal versions of all endpoints that will display less information, but without the reliability issues from this bug.

You can check how that will look, [HERE](https://auto.valospectra.com/testing/minimal)

### Minimal overlay:

In OBS, create a new browser source, change the dimensions to 1920x1080 and add the following link:

```
https://[eu/na].valospectra.com/overlay/minimal?groupCode=GROUPCODEHERE
```

Make sure to replace \[eu/na] with the region, you're from, as shown on the image below. If you're outside of those 2, choose the one that's closest to you. For example, if you're from EU, you'll type: *<https://eu.valospectra>...*

<figure><img src="/files/jgijKTWatO7o03mi1DYY" alt=""><figcaption></figcaption></figure>

### Minimal autoswitch

This will switch between the two variants on its own once the agent selection is complete. If you don't want to manage such a scene transition by yourself **we recommend using this endpoint for your overlay**. Make sure that the dimensions are set to 1920x1080

```
https://[eu/na].valospectra.com/autoswitch/minimal?groupCode=GROUPCODEHERE
```

Make sure to replace \[eu/na] with the region, you're from, as shown on the image below. If you're outside of those 2, choose the one that's closest to you. For example, if you're from EU, you'll type: *<https://eu.valospectra>...*

<figure><img src="/files/Y3yKQqpGbakaPF8JbPo8" alt=""><figcaption></figcaption></figure>

You're all done, now head over to <a href="/pages/4fkg2oTOYv9S0Xidl7i8#id-3.-valorant-setup" class="button primary">3. Valorant setup</a>

<details>

<summary>nobii's Style</summary>

nobii's style is a different version of Spectra that is designed to emulate the current look used in professional VALORANT matches. <mark style="color:$warning;">Please do keep in mind, nobii's style doesn't have a working minimal version.</mark>

{% hint style="danger" %}
The 2025 version (`nobii25`) is no longer receiving updates, and will be archived soon. At that point, the project will be marked as deprecated, and the only currently developed version will be VAL26.
{% endhint %}

If you do decide to support Spectra by donating on a monthly basis, you can use a creator code at the check out. His code is `nobii`.

nobii's style can be used by appending `nobii` to the beginning of the link you'd use in your broadcast software of choice. For an example see the link below:

```
https://nobii.[eu/na].valospectra.com/overlay?groupCode=GROUPCODEHERE
```

<figure><img src="/files/BFQmApY6bRs03GCYrbiL" alt=""><figcaption></figcaption></figure>

If you'd like to use the older version '24-'25, than put nobii25. For example

```
https://nobii25.[eu/na].valospectra.com/overlay?groupCode=GROUPCODEHERE
```

<figure><img src="/files/fDNzJVuOU17qncVLVON0" alt=""><figcaption></figcaption></figure>

</details>
{% endtab %}

{% tab title="3. Valorant setup" %}
Well done. You're almost done with the setup. The final bit that you need to do, is setup your in game HUD (Heads Up Display). Now, while you're in game, you don't want to see the agents at the very top or the gun on the side and numbers (for easier observing) on the minimal. \
Here you'll find out how to hide it, so you get a nice and clean view.&#x20;

When you're in the custom lobby, you need to set it as Tournament mode (in the lobby configuration), switch to observer slot and click on the blue box (2nd box next to your name). See the image below as a reference.&#x20;

<div><figure><img src="/files/U85dKx35Y2Jqxfsx8TKL" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ZZRTk0zZUY3qv7uKxRWn" alt=""><figcaption></figcaption></figure></div>

Now, please keep in mind, when you disable the HUD, you won't be able to see what team starts a timeout, nor can you see the scoreboard (tab).&#x20;

For this, it's best if you use a computer, that you won't need and either use NDI/OMT protocols to stream to your OBS/vMix and make sure to follow your POV (point of view) observer.&#x20;
{% endtab %}
{% endtabs %}

‎


---

# 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.valospectra.com/producers-and-observer.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.