dcpesses / code-whisperer

Twitch Code Whisperer for Party Game Streamers

Home Page:https://dcpesses.github.io/code-whisperer/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Code Whisperer logo

Code Whisperer

Twitch Code Whisperer for Party Game Streamers

https://dcpesses.github.io/code-whisperer/

license ci codecov.io


Developed as a way to help streamers thwart Jackbox trolls, this tool gives Twitch streamers the power to decide who can play in games they host by sending invites only to approved users.

Note

Hey! This project is still actively in development and may be subject to change without notice. YMMV.

Overview

app interface screenshot

The app uses two queues, Interested and Playing, which allows a streamer to manage who will be whispered. Users indicate if they want to join a game by entering commands in chat, which automatically adds them to the Interested queue. From there, the streamer can move users to and from the Playing queue; when a code is entered in the text form, all users in the Playing queue will be sent the code via a Twitch whisper.

Features

  • Sends game or lobby code to specific users by Twitch whisper (direct message)
  • Can send to all users at once as well as individually
  • Easy for users to join using commands in Twitch chat
  • No additional login necessary from users willing to play
  • Option to randomize user selection
  • Set the Max # of Players via Dropdown
  • Indicates if issues occur when sending whispers
  • Specify your own !join/!leave commands
  • More features coming soon...

Caveats

  • Users must be able to receive whispers
  • App must remain open in an active browser window to receive commands
  • Number of whispers sent is subject to rate limits

Chat Commands

User Commands:

  • !join - Adds the user to the Interested queue*
  • !leave - Removes the user from all queues*
  • !version - Posts the version of the app and its url
  • !whichpack GAME - replies with the Jackbox Party Pack of a given game
  • !commands - Lists all available commands
  • !queue - Lists all player in the queue

Mods / Streamer Commands:

  • !open - Opens the Interested queue
  • !close - Closes the Interested queue
  • !clear - Removes all users from the queues
  • !clearopen - Removes all users from the queues and reopens the Interested queue
  • !adduser @USER - Adds specified user directly to Playing queue
  • !removeuser @USER - Removes specified user from all queues

*Commands can be changed in the Settings menu

Currently Planned Features:

  • Display creation date of player's account
  • In-app Documentation & Tutorial
  • Usage instructions via command
  • Custom join/leave commands
  • Using icons in place of text
  • Game description lookup via command
  • Player blacklisting
  • Possible usage in other channels (Moderation privileges required)

Support

License and Contributor Code of Conduct

This project is open source under the MIT license. (TL;DR: you may access the source code and modify it to fit your own needs, but you do not have access to deploy it.)

Contributors must subscribe and adhere to the Contributor Code of Conduct based on the Contributor Covenant version 2.1.

Shut up and take my money!

If you would like to support the development of Code Whisperer, feel free to donate at ☕️ ko-fi. Donations are never expected but are always appreciated. All donations are non-refundable and go towards improving the app and its infrastructure.

ko-fi

Related Repos

About

Twitch Code Whisperer for Party Game Streamers

https://dcpesses.github.io/code-whisperer/

License:MIT License


Languages

Language:JavaScript 87.8%Language:TypeScript 7.1%Language:CSS 4.0%Language:HTML 1.0%Language:Shell 0.0%