fdgt

fdgt is a mock API for the Twitch Messaging Interface (tmi). Via fdgt, you can connect and test your Twitch bots and other tools with simulated events without having to connect to the real API!

How does it work?

Using fdgt is pretty simple. Instead of pointing to the irc-ws.chat.twitch.tv, you point to to tmi.fdgt.dev. DONE.

Wait seriously?

Yup.

It can't be that simple!

It is, tho. Check out this example with tmi.js.

Connecting to the real tmi

const tmi = require('tmi.js')
const client = new tmi.Client()
 
client.connect()

Connecting to the fdgt mock tmi

const tmi = require('tmi.js')
const client = new tmi.Client({
    connection: { server: 'tmi.fdgt.dev' },
})
 
client.connect()

Simulating events

One of the hardest parts of working with the Twitch chat API is that to test your tool with different payloads, you have to perform the real action that would trigger that event.

Need to trigger a message with bits? You're going to be cheering a lot.

Need to simulate a subscription? I hope you've got deep pockets.

Need to simulate a submysterygift with 10 Tier 3 subscriptions? God help you.

Instead of blowing the wads of cash that you probably don't have, use fdgt! With fdgt, you just have to send the right message to the chat service, and it'll trigger the appropriate event! Here's an example of triggering a message with bits in it, again using tmi.js:

client.say('#TrezyCodes', 'bits')

And just like that, fdgt will fire a simulated message with bits attached!

Getting a specific response

Sometimes, the randomized events that fdgt generates just aren't specific enough. Fortunately, fdgt's interface is controlled just like a CLI! If you want to change the username of the person that "triggered" the event, you can pass it with the --username flag!

client.say('#TrezyCodes', 'bits --username alca')

...or, say you want to simulate that 10x Tier 3 submysterygift we mentioned earlier:

client.say('#TrezyCodes', 'submysterygift.tier3 --username alca --giftcount 10')

For more information on what events are available and what parameters they support, check out the events section.

Help & Support

Need some help using fdgt? No problem! Hop on to the Trezy Studios Discord and we'll be happy to help! ❤️

API

Events

Globally supported parameters

The following table describes the parameters that are supported by almost every message. There are exceptions (namely the mode triggers, like emoteonly, slowmode, and subsonly), noted under the respective events.

bits

This event is normally triggered when a user does X.

Supported parameters

Examples

client.say('#csharpfritz', 'bits --bitscount 50')

emoteonly.off

This event is normally triggered when the room is set to emote-only mode, then emote-only mode is turned off.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#chaelcodes', 'emoteonly.off --channel timbeaudet')

emoteonly.on

This event is normally triggered when the room is set to emote-only mode.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#stuyksoft', 'emoteonly.on --channel tutorexilius')

extendsub.tier1

This event is normally triggered when a user extends their Tier 1 subscription.

Supported parameters

Examples

client.say('#howtocodewell', 'extendsub.tier1 --months 6')

fdgt will automatically calculate and name the correct month, so if you want the month in the message to be in the future (or the past!), make sure to set the timestamp. To represent an extension from January 2015 to June 2015, you could do the following:

client.say('#chefbrent', 'extendsub.tier1 --months 6 --timestamp 1420092000000')

extendsub.tier2

This event is normally triggered when a user extends their Tier 2 subscription.

Supported parameters

Examples

client.say('#jeffblankenburg', 'extendsub.tier2 --months 6')

fdgt will automatically calculate and name the correct month, so if you want the month in the message to be in the future (or the past!), make sure to set the timestamp. To represent an extension from January 2015 to June 2015, you could do the following:

client.say('#latteandmia', 'extendsub.tier2 --months 6 --timestamp 1420092000000')

extendsub.tier3

This event is normally triggered when a user extends their Tier 3 subscription.

Supported parameters

Examples

client.say('#mbcrump', 'extendsub.tier3 --months 6')

fdgt will automatically calculate and name the correct month, so if you want the month in the message to be in the future (or the past!), make sure to set the timestamp. To represent an extension from January 2015 to June 2015, you could do the following:

client.say('#itslittany', 'extendsub.tier3 --months 6 --timestamp 1420092000000')

giftpaidupgrade

This event is normally triggered when a user upgrades from a gifted subscription.

Supported parameters

Examples

client.say('#themessycoder', 'giftpaidupgrade --username2 MrDemonWolf')

primepaidupgrade.tier1

This event is normally triggered when a user upgrades from a Prime subscription to a Tier 1 subscription.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#shadesofpixie', 'primepaidupgrade.tier1')

primepaidupgrade.tier2

This event is normally triggered when a user upgrades from a Prime subscription to a Tier 2 subscription.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#edcharbeneau', 'primepaidupgrade.tier2')

primepaidupgrade.tier3

This event is normally triggered when a user upgrades from a Prime subscription to a Tier 3 subscription.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#ramblinggeek', 'primepaidupgrade.tier3')

raid

This event is normally triggered when a channel is raided by another stream.

Supported parameters

Examples

client.say('#narebabr', 'raid --viewerCount 100')

resubscription.prime

This event is normally triggered when a user continues their Prime subscription.

Supported parameters

Examples

client.say('#developersgarage', 'resubscription.prime --months 6')

resubscription.tier1

This event is normally triggered when a user continues their Tier 1 subscription.

Supported parameters

Examples

client.say('#relevantjesse', 'resubscription.tier1 --months 6')

resubscription.tier2

This event is normally triggered when a user continues their Tier 2 subscription.

Supported parameters

Examples

client.say('#roberttables', 'resubscription.tier2 --months 6')

resubscription.tier3

This event is normally triggered when a user continues their Tier 3 subscription.

Supported parameters

Examples

client.say('#timvanmonero', 'resubscription.tier3 --months 6')

slowmode.off

This event is normally triggered when the room is set to slow mode, then slow mode is turned off.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#rosuav', 'slowmode.off --channel fiercekittenz')

slowmode.on

This event is normally triggered when the room is set to slow mode.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#lannonbr', 'slowmode.on --channel sudokid')

subgift.tier1

This event is normally triggered when a user gifts a Tier 1 subscription to another user in the channel.

Supported parameters

Examples

client.say('#chiefcll', 'subgift.tier1 --username2 jitterted')

subgift.tier2

This event is normally triggered when a user gifts a Tier 2 subscription to another user in the channel.

Supported parameters

Examples

client.say('#davidortinau', 'subgift.tier2 --username2 syropian')

subgift.tier3

This event is normally triggered when a user gifts a Tier 3 subscription to another user in the channel.

Supported parameters

Examples

client.say('#cldubya', 'subgift.tier3 --username2 drmikachu')

submysterygift.tier1

This event is normally triggered when a user gives Tier 1 mystery subscription gifts.

Supported parameters

Examples

client.say('#jumpystick', 'submysterygift.tier1 --giftcount 10')

submysterygift.tier2

This event is normally triggered when a user gives Tier 2 mystery subscription gifts.

Supported parameters

Examples

client.say('#lizelive', 'submysterygift.tier2 --giftcount 10')

submysterygift.tier3

This event is normally triggered when a user gives Tier 3 mystery subscription gifts.

Supported parameters

Examples

client.say('#fullstacklive', 'submysterygift.tier3 --giftcount 10')

subscription.prime

This event is normally triggered when a user subscribes to a channel for the first time with Prime.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#talk2megooseman', 'subscription.prime --channel funfunfunction')

subscription.tier1

This event is normally triggered when a user purchases a Tier 1 subscription to a channel for the first time.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#lana_lux', 'subscription.tier1 --channel jamesmontemagno')

subscription.tier2

This event is normally triggered when a user purchases a Tier 2 subscription to a channel for the first time.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#coderushed', 'subscription.tier2 --channel codingbandit')

subscription.tier3

This event is normally triggered when a user purchases a Tier 3 subscription to a channel for the first time.

Supported parameters

This event only supports the global parameters.

Examples

client.say('#clarkio', 'subscription.tier3 --channel kasuken')

subsonly.off

This event is normally triggered when the room is set to subscribers-only mode, then subscribers-only mode is turned off.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#alca', 'subsonly.off --channel atomikjaye')

subsonly.on

This event is normally triggered when the room is set to subscribers-only mode.

Supported parameters

This event does not support all global parameters. The table below is an exhaustive list of the supported parameters for this event.

Examples

client.say('#devchatter', 'subsonly.on --channel brandonsatrom')

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Trezy 💻 💼 📖 💡 🚇 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!