Releases

GIPHY

Description

GIPHY integration for Streamer.bot, designed to revolutionize your stream chat experience! With GIPHY, viewers can express themselves using a vast library of animated GIFs, adding a dynamic and entertaining dimension to your stream.

Tutorial (Coming Soon)

giphy product thumb.png

Installation

Resources

GIPHY

Alien Waifu DLL (Non-Member)

OBS

Create Scene

You will only need to create a scene that all your GIPHY’s will be displayed on. You can leave the sources blank in the scene as the extension will create and delete the sources for you.

Untitled

<aside> ⚠️ You will need to enter the name of the scene you created in Streamer.bot later in the setup. Also you may use this scene as a nested scene if you would like.

</aside>

Streamer.bot

DLL File

Copy the AlienWaifu.dll file to the dlls folder inside your Streamer.bot directory.

Untitled

API Key

Click create an API key in the GIPHY Developers Dashboard.

giphy-dashboard.png

Select API from the popup menu.

Untitled

Enter a name for your app and describe how you plan on using GIPHY (I.E. Displaying GIPHY’s on stream for fun interaction with viewers). Read and agree to the terms then click Create API Key.

Untitled

You will be brought back to the dashboard that displays your new API key. You will need this later. You can click the API Key box to copy the key to your clipboard.

giphy-dashboard.png

<aside> ⚠️ As you can tell from the image API Keys are rate limited to 100 API calls per hour. You can upgrade your key to Production to remove this limitation. This is suggested if you have a high traffic channel. You may have to display a powered by GIPHY logo somewhere on your channel according to this article. This has not been confirmed as necessary as of yet.

</aside>

Import File

Drag GIPHY1.0.1.sb into the Import Pane in Streamer.bot.

Untitled

When clicking Import, you will get a warning stating that commands will be disabled. You will need to enable them after importing.

Untitled

There will be another warning due to the GIPHY Setup action being configured to run on import. This is safe and will display popup dialogs to setup GIPHY for use in Streamer.bot.

Untitled

<aside> ⚠️ Be careful when importing actions that are configured to run on import. Make sure that you are getting the import from a trusted source and that the source is transparent about what those configured actions do.

</aside>

These will be the dialogs that popup:

Untitled

Untitled

Untitled

<aside> 🚨 You have the ability to filter the GIPHY’s shown by rating. By default g is put in as a place holder as these are 100% stream safe. If you would like to set the rating higher please understand the risk it may pose to your channel. For a breakdown of the ratings and what they mean please refer to this article.

</aside>

Untitled

Untitled

The setup action will be disabled after run and will only need to be run again if you want to change any options in GIPHY.

In the commands tab of Streamer.bot the commands will be disabled and shown as disabled by being highlighted in red.

Untitled

In Settings > Timed Actions you will need to click Enable to have the GIPHY Cleanup action run to clear out any possible stragglers.

Untitled

<aside> ⚠️ You may also have this Enabled with a Stream Start trigger and Disabled on a Stream Stopped trigger so it only runs the cleanup action while you are live.

</aside>

Enable the commands by right clicking the command and checking enabled.

Untitled

They are enabled if the are no longer displayed in red text.

Untitled

Twitch Channel Reward (Optional)

Instead of using the supplied commands you can create channel rewards instead. You will need to select Channel Reward Redemption as the trigger under both GIPHY (Search Term) and Sticker GIPHY (Search Term) to use Channel Rewards.

Untitled

Create the reward from the trigger window by clicking Create Reward

Untitled

Set your desired parameters and then make sure 1 reward is checked on User Input Required and one is not. This will allow a user to utilize either random GIPHY’s or Searched GIPHY’s via Channel Point Rewards.

Untitled

<aside> ⚠️ You should have 4 Channel Rewards in total. Two that point to GIPHY (Search Term) and two that point to Sticker GIPHY (Search Term).

</aside>

Contributors

Web_Mage - For the math.

TerrierDarts - For the random source creation and deletion.

Changelog

Version Changes
1.0.1 Added cleanup action to remove browser source stragglers.