ComfyJazz

ComfyJazz is a tool to play easy-listening, comfy, computer-generated Jazz music, with built-in Twitch and YouTube chat integration. Notes are played along randomly and for each chat message on your channel.

Table of Contents

• Credits
• Prerequisites
• Installing ComfyJazz
• Using ComfyJazz
  • Twitch
  • YouTube

Credits

All credits to the original project go to @Instafluff and all participants in the original project. Instafluff can also be found on Twitch at ttv/Instafluff

Prerequisites

Before you begin, ensure you have met the following requirements:

• Download and install Node.js matching for your operating system.
  • The LTS (Long-term Support) version is recommended for most users.

Installing ComfyJazz

1. Navigate to the ComfyJazz folder.
2. Run npm install to install required dependencies.

Using ComfyJazz

Twitch

1. Run the application from the command line.
   1. node index.js
2. You should see a message like Listening on 8901
   1. Where 8901 is the port that ComfyJazz is listening on.
3. Add a Browser Source to your broadcasting software (e.g. OBS).
4. In the URL field, enter http://localhost:8901?channel=yourchannel
   1. Replace yourchannel with your Twitch username.
5. Enjoy!

Example:

http://localhost:8901?channel=zephsinx

Notes:

1. Keep the command prompt window open, as closing it will stop ComfyJazz.
   1. If you would like ComfyJazz to run as a Windows service and not have to keep a command prompt open, NSSM can be used for this purpose.
2. To stop the application, press CTRL+C in the command prompt window, or simply close the command prompt.

YouTube

To integrate ComfyJazz with YouTube Live chat, you have two options:

Streamer.bot Integration

By connecting setting up Streamer.bot to your YouTube account, you can make ComfyJazz listen to events emitted by Streamer.bot when it detects a YouTube Live message.

1. Set up Streamer.bot and log in with your YouTube account you use for streaming.
2. Ensure your Streamer.bot WebSocket server is started, and using the default IP and Port.
   1. ComfyJazz does not currently support custom WebSocket URLs and ports.
3. Run the ComfyJazz from the command line.
   1. node index.js
4. Add a Browser Source to your broadcasting software (e.g. OBS).
5. In the URL field, enter http://localhost:8901?useStreamerBot=true
   1. If you get an error, re-check your settings.
6. Enjoy!

Local WebSocket Integration

Note: The server must be started after the YouTube stream has begun to have a valid stream Live ID. Future improvements will attempt to remove this requirement.

1. Run the application from the command line and provide your YouTube Live ID.
   1. node index.js -y YOUR_LIVE_ID
2. You should see the following messages:
   1. Attempting connection to YouTube chat with Live ID: YOUR_LIVE_ID
   2. Listening on 8901
      1. Where 8901 is the port that ComfyJazz is listening on.
3. Add a Browser Source to your broadcasting software (e.g. OBS).
4. In the URL field, enter http://localhost:8901?useWebsockets=true
   1. yourchannel is not needed but doesn't hurt anything if kept.
5. Enjoy!

As the YouTube event listener run on the server-side, notes are triggered via websocket requests to the client-side.