# ImageOverlay Twitch integration tutorial

## Step 1:

#### Go to: <https://twitchtokengenerator.com/>

#### Select "Custom Scope Token":

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

After that select the following tokens:

* user:read:subscriptions
* user:read:follows
* moderator:read:followers

Scroll down and click "Generate Token!\
You will need to authorize your Twitch account to the website and after than, two tokens will be generated

* ACCESS TOKEN
* REFRESH TOKEN

**Those are the only two tokens you need**

## **Step 2:**&#x20;

#### **Go to:** [**https://dev.twitch.tv/console**](https://dev.twitch.tv/console)

* Log in with you Twitch account

Head to "Control Panel"

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

And then:

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

**Click "Register your application"**

* Name it for example "imageoverlaymod"
* **OAuth redirect UR**L: <https://twitchtokengenerator.com>
* **Category**: Application Integration

Save it.

## Step 3:

To connect from Minecraft. Open the ImageOverlay GUI -> Default key is O

Click the "Twitch" button:<br>

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

And add the following information

* Channel name
* Access token -> Head to the Twitch Token Generator token from **Step 1** and copy "**Access Token**"

![](/files/YIVCNAISRXeNpoXuXWx7)<br>

* Client ID -> Head to the Twitch Developer Console from **Step 2** and copy the "**Client ID**" information

<div align="left"><figure><img src="/files/1XmZGS0DncgwG80xcHiD" alt=""><figcaption></figcaption></figure></div>

* Refresh token -> Again, head to the Twitch Token Generator from **Step 1** and copy "**Refresh Token**"

<div align="left"><figure><img src="/files/TzxQKZiGoM0PqNyQZ0Sx" alt=""><figcaption></figcaption></figure></div>

* Client secret -> Again, head to the Twitch Developer Console from **Step 2** and click on "**New secret**"

<div align="left"><figure><img src="/files/RkTh23OnQqyhpq3S919k" alt=""><figcaption></figcaption></figure></div>

A new secret will be generated and copy that into Minecraft

After all, write a password and click "**CONNECT**"

If everything is correct, a message bellow the password text field will appear indicating that the account has been linked correctly.

## Step 4:

Click the "**Settings**" button

<div align="left"><figure><img src="/files/pp6kzVGTmIdAjsHrLidx" alt=""><figcaption></figcaption></figure></div>

To select which images do you want to be rendered, click any "**Configure TIER X or follow images**"

And to configure the size, placement, etc click "**Configure image position**"

## If you have any questions, improvements or find a bug, please join my Discord: <https://discord.com/invite/c8aagxeNty>


---

# 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://imageoverlay.gitbook.io/imageoverlay-docs/imageoverlay-twitch-integration-tutorial.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.