Skip to content

Repository files navigation

Joysticktv-Bytebot

Joysticktv-Bytebot is a Streamer.bot integration for Joystick.TV OAuth, GatewayChannel events, chat commands, outbound messages, and a local combined-chat display.

Status: 0.2.1 preview, tested with Streamer.bot 1.0.7 on Windows and .NET Framework 4.8.1.

Features

  • Joystick.TV authorization-code OAuth with state validation
  • DPAPI protection for client secrets and OAuth tokens
  • Tips/tokens, follows, subscriptions, gifted subscriptions, wheel spins, drop-ins, and stream status events
  • Joystick chat command fields exposed to Streamer.bot without adding a second command engine
  • Permission-gated Send Message action for replies, links, and Streamer.bot timers
  • Local Twitch, YouTube, Kick, and Joystick.TV combined-chat page for OBS
  • Streamer.bot actions for Configure, Authorize, Start, Stop, Reconnect, Status, Send Message, and Test
  • Generic preservation of unknown stream events with sanitized rawJson

The original v0.1.0 release remains available as the personal no-chat edition. Starting with v0.2.0, Joystick.TV chat can be displayed through the packaged local overlay.

Install

Download Joysticktv-Bytebot-v0.2.1.zip from the repository's Releases page and follow the installation guide. Combined-chat setup is covered in the overlay guide.

Security

Every installation uses the owner's own Joystick.TV bot application. Client secrets, access tokens, and refresh tokens must never be placed in repository files, issues, screenshots, or logs. See Security.

Development

Build instructions are in docs/BUILDING.md. Event names and arguments are documented in docs/EVENTS.md.

License

MIT License. See LICENSE.

Notes

I vibe coded this with GPT 5.6 Sol. I have tested it on my own streams and it works. Use at your own risk.

Be aware that Joystick chat content is could violate Twitch, Youtube, and Kick TOS if you include it. It's on you to moderate your chat so you're not banned.

This was inspired by the KickBot plugin that expanded StreamerBot's abilities to interact with Kick.

About Dominic Bytes

Greetings! I am Dominic Bytes, the synth walker. I hail from the distant future. Where brains occupy robot bodies, time travel is a trip to the corner store, and the neon glow of our attire is powered by the light of our souls. Join me on a 1.21 gigawatt powered journey of chill vibes with gaming, anime, movies, and more!

About

Joystick.TV stream events, chat commands, and messaging integration for Streamer.bot.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages