# ImageOverlay Twitch integration tutorial

## Step 1:

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

#### Select "Custom Scope Token":

<figure><img src="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FxMCs5FO74s2KhJzfFDNZ%2Fimage.png?alt=media&#x26;token=43c2fc4f-9a2c-4562-adad-f9ede87c3942" 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="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FNPk5W1xKmqaFI9mjvG2n%2Fimage.png?alt=media&#x26;token=5456293f-2d69-4204-b143-fe90e393b6e9" alt=""><figcaption></figcaption></figure>

And then:

<figure><img src="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FdxndeY9gMitZVD1B2hJx%2Fimage.png?alt=media&#x26;token=34853370-eb47-472b-a8fe-c814ea392c21" 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="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FjykE0YDCA2Bf0U1Eo1ky%2Fimage.png?alt=media&#x26;token=0732df2e-198b-4c91-982b-f83ea18c13bf" 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**"

![](https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FcuDS7Ebte7Qi1eR5mzbh%2Fimage.png?alt=media\&token=dc629977-0cea-4309-b595-24b4b642d9e1)<br>

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

<div align="left"><figure><img src="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FLHkMnbXCmk5PwjeoOni4%2Fimage.png?alt=media&#x26;token=e55cb5a4-6fe6-4c6a-a01c-4429bab1b162" 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="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FtruzmyMGtRT4J7JGMqNU%2Fimage.png?alt=media&#x26;token=fddc46d3-6927-4587-aa55-e8d9b5d02fbf" 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="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FBsuGOm94EA1YlrFKoEVM%2Fimage.png?alt=media&#x26;token=7bb24a7f-437c-4868-ab82-458905b44a5d" 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="https://1987508529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F32LWNV8WBJbvFXTR3RBp%2Fuploads%2FYS7SvnYju64QXjcswKzb%2Fimage.png?alt=media&#x26;token=d284e491-c49a-4d18-8f58-c25805946d3c" 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>
