MiniBotLauncher

MiniBotLauncher is a lightweight, C#/.NET 8 Windows Forms application that connects to Twitch chat and enables several fun, chat-interactive scripts, including: • AskAI — Ask natural language questions to a local AI model • Weather — Get real-time weather info for cities • Translate — Automatically translate non-English messages to English • ButtsBot — Randomly replaces syllables in messages with "butt" for comedic effect • ClapThatBot — Generates "I'd clap that" responses from adjective+noun pairs • MarkovChain — Builds a Markov chain brain from chat and generates random responses • Sound Alerts — Plays sound effects on specific commands; supports .mp3/.wav, volume control, and a stop/clear queue button • WalkOnScript — Plays personalized entrance sounds for viewers when they first speak after the stream has started

---

✨ Features

• OAuth-based Twitch login flow built into the app

• Auto-saves all settings to Documents\MiniBot\settings.json

• Enable or disable each script individually using toggles

• Each script has its own ⚙️ settings popup for configuration:

  • AskAI: Server address, port, model dropdown (auto-fetched), max tokens (1–255), optional system message
  • Weather: Format string for customizing response output
  • Translate: Choose target language from dropdown
  • ButtsBot: Adjustable reply frequency (syllable replacements are fixed at 5%)
  • ClapThatBot: Adjustable reply frequency
  • MarkovChain: Reset brain with confirmation dialog
  • Sound Alerts: Add trigger-to-sound mappings, adjust volume, and stop/clear playback queue
  • WalkOnScript: Assign personalized walk-on sounds per user, plays once per stream unless reset by reconnect or stream restart

• Ignore messages from specific users using the Ignore List popup

• Stylish dark mode UI with rounded corners and tooltips

• Most scripts operate offline. Weather and Translate use public web APIs and require an internet connection, but no user setup is needed.

---

💪 Requirements

• Windows 10 or 11
• .NET 8 Runtime (unless using self-contained build)
• Twitch account

Optional:

• Local GPT4All server with compatible models such as llama3-8b-instruct or phi-3-mini-instruct

ButtsBot and ClapThatBot use embedded offline models, no external services required.

---

📙 Installation

1. Download the latest release from GitHub
2. Extract the contents
3. Run MiniBotLauncher.exe

Settings are stored at:

C:\Users\<YourName>\Documents\MiniBot\settings.json

Markov brain data is stored at:

C:\Users\<YourName>\Documents\MiniBot\markov_brain_<channel>.json

---

⚙️ Setup Instructions

1. Enter your Twitch Bot Username

2. Enter your Client ID from https://dev.twitch.tv/console/apps

   • Set redirect URL: http://localhost:8750/callback/

3. Enter the Channel Name to join

4. Click Get Token and authorize access

5. Click Connect

6. Toggle the scripts you want active

7. Click each script's ⚙️ to configure its behavior

8. Use the 📄 button in the top-right to open the Ignore List

AskAI requires GPT4All running locally. Now includes server/port configuration and automatic model listing. Responses with trailing tags like tutor: or response: are automatically cleaned unless clearly part of the content. ButtsBot replaces syllables at random, one syllable is always replaced if none were hit by chance. MarkovChain will respond every 35 messages and can be reset via its settings. Sound Alerts maps chat commands to sound files and queues them for playback with a short delay. It supports .mp3 and .wav, adjustable volume, and a button to stop and clear the current queue. WalkOnScript plays a specific sound the first time a user speaks during a stream. Triggers reset on reconnect or when stream start time changes.

---

🔹 Scripts Overview

Script	Description
AskAI	Answers natural language queries using a local AI model
Weather	Provides current weather using wttr.in with customizable output formatting
Translate	Detects non-English and translates into your chosen target language
ButtsBot	Replaces ∼5% of syllables in messages with "butt" — reply rate adjustable in settings
ClapThatBot	Detects adjective+noun phrases and responds with "I'd clap that" — reply rate adjustable
MarkovChain	Learns from chat to generate new phrases every 35 messages — brain can be reset from settings
Sound Alerts	Plays sound files on command triggers with volume and queue control
WalkOnScript	Plays a unique walk-on sound per user the first time they speak after the stream starts

---

🚀 Building from Source

• Open MiniBotLauncher.sln in Visual Studio 2022+
• Build in Release mode
• Right-click project → Publish
• Use self-contained, single-file publish option for portability

---

📄 License

MIT License — free for personal or commercial use

Third-party libraries:

• OpenNLP — POS tagging (Apache 2.0)
• CMUdict — Syllable parsing (BSD-style license)
• TwitchLib — Twitch connection
• GPT4All — Local AI inference engine
• Newtonsoft.Json — JSON parsing for settings and Markov brain
• NAudio — Audio playback for .wav and .mp3 support

---

🚀 Credits

Thanks to:

• TwitchLib
• GPT4All
• OpenNLP
• CMUdict
• Newtonsoft.Json
• NAudio

Built with ❤️ by Ixitxachitl