# ComfyJS
**Repository Path**: mirrors_rochacbruno/ComfyJS
## Basic Information
- **Project Name**: ComfyJS
- **Description**: Comfiest Twitch Chat Module for Coding Cafe
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-05-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Comfy.JS
We built this Comfy Twitch Chat Module live on Twitch for Coding Cafe!
**Special Thanks:** *Comfy.JS is possible thanks to [tmi.js](https://tmijs.com/) maintained by [@AlcaDesign](https://github.com/AlcaDesign)*
**Comfy.JS** lets you integrate with Twitch chat for your Twitch channel ***SUPER EASILY*** in just a few lines of code. Here's a quick 3-min video on how to use it: (Click image to open video)
[](https://www.youtube.com/watch?v=oXpPwnUQCCk)
## Instafluff ##
> *Like these projects? The best way to support my open-source projects is by becoming a Comfy Sponsor on GitHub!*
> https://github.com/sponsors/instafluff
> *Come and hang out with us at the Comfiest Corner on Twitch!*
> https://twitch.tv/instafluff
## Instructions ##
#### Node
1. Install `comfy.js`
```
npm install comfy.js --save
```
2. Respond to !commands your channel
```javascript
var ComfyJS = require("comfy.js");
ComfyJS.onCommand = ( user, command, message, flags, extra ) => {
if( flags.broadcaster && command === "test" ) {
console.log( "!test was typed in chat" );
}
}
ComfyJS.Init( "MyTwitchChannel" );
```
#### Browser
1. Download and add `comfy.js` from the `dist` folder or include from the JSDelivr CDN:
```javascript
```
OR
```javascript
```
2. Respond to !commands your channel
```html
```
## Flags ##
Currently, the flags possible in `onCommand()` and `onChat()` are:
- broadcaster
- mod
- founder
- subscriber
- vip
- highlighted
- customReward
## Extra Parameter ##
Currently, the `extra` parameter for the `onCommand()` contains the following fields:
- id (the message message)
- channel
- roomId
- messageType
- messageEmotes
- isEmoteOnly
- userId
- username
- displayName
- userColor
- userBadges
- flags
- timestamp
- customRewardId (only works with custom channel rewards with required-text)
If the message is a command, the `extra` parameter will contain an additional field:
- sinceLastCommand
which contains the information on the time periods in `ms` since the last time any user, or the specific user, has used the same
command. This field can be convenient to be used for setting global cooldown or spamming filters. See examples below:
```javascript
ComfyJS.onChat = ( user, message, flags, self, extra ) => {
if( flags.broadcaster && command === "test" ) {
if( extra.sinceLastCommand.any < 100 ) {
console.log(
`The last '!test' command by any user was sent less than 100 ms ago`
);
}
if( extra.sinceLastCommand.user < 100 ) {
console.log(
`The last '!test' command by this specific user (as denoted by the 'user' parameter) was sent less than 100 ms ago`
);
}
}
}
```
## Reading Chat Messages ##
You can read chat messages by using the `onChat()` handler
```javascript
ComfyJS.onChat = ( user, message, flags, self, extra ) => {
console.log( user, message );
}
```
## Sending Chat Messages ##
Sending Chat Messages can be done through `ComfyJS.Say( message )` but requires an OAUTH password when connecting to chat.
#### Securely adding your password
1. Get a Twitch Chat OAuth Password Token - [http://twitchapps.com/tmi/](http://twitchapps.com/tmi/)
2. Install `dotenv`
```
npm install dotenv --save
```
3. Create a file named `.env` that looks like this:
```javascript
TWITCHUSER=[YOUR-USERNAME-HERE]
OAUTH=[YOUR-OAUTH-PASS HERE] # e.g. OAUTH=oauth:kjh12bn1hsj78445234
```
4. Initialize with the Username and OAUTH password
```javascript
var ComfyJS = require("comfy.js");
ComfyJS.onCommand = ( user, command, message, flags, extra ) => {
if( command === "test" ) {
ComfyJS.Say( "replying to !test" );
}
}
ComfyJS.Init( process.env.TWITCHUSER, process.env.OAUTH );
```
## Joining a Different Channel ##
You can join a different channel or groups of channels by specifying in the `Init()`
#### Joining a Single Channel
```javascript
ComfyJS.Init( "MyTwitchChannel", null, "ChannelToJoin" );
```
#### Joining Multiple Channels
```javascript
ComfyJS.Init( "MyTwitchChannel", null, [ "ChannelA", "ChannelB", "ChannelC" ] );
```
## Disconnecting from Server
You can disconnect from the server and all channels by using `Disconnect()`.
```javascript
ComfyJS.Disconnect();
```
## All Supported Events ##
- **onCommand**`( user, command, message, flags, extra )`
- Responds to "!" commands
- **onChat**`( user, message, flags, self, extra )`
- Responds to user chatting
- **onWhisper**`( user, message, flags, self, extra )`
- Responds to user whisper event
- **onMessageDeleted**`( id, extra )`
- Responds to chat message deleted
- **onJoin**`( user, self, extra )`
- Responds to user joining the chat
- **onPart**`( user, self, extra )`
- Responds to user leaving the chat
- **onHosted**`( user, viewers, autohost, extra )`
- Responds to channel being hosted
- Requires being authorized as the broadcaster
- **onRaid**`( user, viewers, extra )`
- Responds to raid event
- **onCheer**`( user, message, bits, flags, extra )`
- Responds to user cheering
- **onSub**`( user, message, subTierInfo, extra )`
- Responds to user channel subscription
- **onResub**`( user, message, streamMonths, cumulativeMonths, subTierInfo, extra )`
- Responds to user channel subscription anniversary
- **onSubGift**`( gifterUser, streakMonths, recipientUser, senderCount, subTierInfo, extra )`
- Responds to user gift subscription
- **onSubMysteryGift**`( gifterUser, numbOfSubs, senderCount, subTierInfo, extra )`
- Responds to user sending gift subscriptions
- **onGiftSubContinue**`( user, sender, extra )`
- Responds to user continuing gift subscription
- **onConnected**`( address, port, isFirstConnect )`
- Responds when connecting to the Twitch chat.
- **onReconnect**`( reconnectCount )`
- Responds when attempting to reconnect to the Twitch chat.
- **onError**`( error )`
- Hook for Errors
## Credits ##
Thank you too all the participants of this project!
**Instafluff, Instafriend, Neo_TA, ChatTranslator, fydo, That_MS_Gamer, MrRayKoma, Amarogine, HunWalk, simrose4u, sparky_pugwash, soggycoffee, blackdawn1980, BooobieTrap, lizardqueen, TastyGamers101, MalForTheWin, SourBeers, Stay_Hydrated_Bot, codeaurora, DutchGamer46, TheHungerService, BungalowGlow, koralina_211, TominationTime, itsDeke, fd_god92, SushiDay, FlyToto_, Docpinecone, katori15, ScrtSolstice, QeraiX, superravemonster, Jwh1o1, Deitypotato, Stobie, Chlapicek99, tehWokes, SuperChihuahua, FranC312, FuriousFur, Moopaloo, CreativeBuilds, donaldwm, Zorchenhimer, Grognardian, ravavyr, Chibigirl24, DR4G0N_S4MUR41, PokemoHero, rekaj3773, cunavrito, TheGeekGeneration, DevMerlin, julieee22, malfunct, blazeninja3, pookiepew, xxMiabellexx, Rlchibi**
Thank you to everyone that helped in turning Comfy.JS into a browser module!
**Instafluff, Instafriend, ChatTranslator, Gilokk0, qbotv3, That_MS_Gamer, KitAnnLIVE, simrose4u, MacabreMan2, LuRiMer313, sparky_pugwash, AbbyFabby, sethorizer, julieee22, Numb3rY, Jwh1o1, baileydale, kevkab, Stay_Hydrated_Bot, DrJavaSaurus, stresstest, BungalowGlow, Dr_Zero, NiteCrawla, fd_god92, DrEriksen, codeheir, Talk2meGooseman, sneelps, cottonsmiles, DutchGamer46, LilyHazel, Kyoslilmonster, guthron, DragosNox, sciondragons, HonestDanGames, Xynal, MerlinLeWizard, FablesGames, BrainoidGames, donaldwm, Gharrotey, RIKACHET, HeyOhKei, DevMerlin, CrimsonKnightZero, ellie_pop, ItsNaomiArt, SomaPills, TheSabbyLife, bktdakid31, IsaisChannel, thegooseofwild, itsDeke, bubblesandunicorns, jellydance, MalForTheWin, Chibigirl24, Pearcington, RikuRinku, rockysenpai24, DEAD_P1XL, codeaurora, EndlessMoonfall, fromtheannex, Optik_Nerve, qerwtr546, REAZNxxx, GoonPontoon, JesseSkinner, roberttables, pookiepew, Lannonbr, SoG_Cuicui, Deitypotato, shalomhanukkahbneishimon, UpmostKek, xeiu, skatesubzero, kingswerv, K1ng440, kaisuke, kinbiko, malfunct, BooobieTrap, Kara_Kim**