Frequently Asked Questions

What is FaustBot?

FaustBot is a stream automation tool that helps you create interactive experiences for your viewers. It connects to streaming platforms like Twitch, YouTube, and Kick to respond to events, manage chat, and control software like OBS.

Is FaustBot free?

FaustBot has a free tier that includes all core features. Premium features are available through a subscription. Check our pricing page for details.

What platforms does FaustBot support?

FaustBot supports Twitch, YouTube, Kick, TikTok, Trovo, Facebook, and many adult streaming platforms. Each platform has different levels of API access depending on what they offer.

Can I use FaustBot on multiple computers?

Yes! Your settings are stored locally, but you can export/import your configuration or use cloud sync (coming soon) to keep multiple installations in sync.

Does FaustBot work on Mac?

Currently FaustBot supports Windows and Linux. Mac support is planned for a future release. In the meantime, you can run FaustBot on a Windows VM or use a dedicated streaming PC.

How do I connect my Twitch account?

Go to the Twitch section in the sidebar, click "Connect Account", and authorize FaustBot. You can connect both a broadcaster account and a separate bot account for chat messages.

Can I use FaustBot with multiple Twitch accounts?

Yes, you can connect a broadcaster account and a bot account. The bot account is used for sending chat messages so they don't come from your main account.

Why aren't my YouTube events triggering?

YouTube has stricter API limitations than Twitch. Make sure you've enabled YouTube Live in your channel settings and that your stream is actually live. Some events may have a delay due to YouTube's API.

Does FaustBot support Kick?

Yes! FaustBot has full Kick integration including chat, follows, subscriptions, and gifted subs. Connect your Kick account in the Kick section of the sidebar.

Which scripting language should I use?

We recommend Python or Lua for most users. Python is great for beginners and has excellent library support. Lua is lightweight and fast. C# offers the best performance and full .NET support but has a steeper learning curve.

Can I use external libraries in my scripts?

Yes! Python scripts can import standard library modules and installed packages. C# scripts have access to common .NET assemblies. For external dependencies, you may need to configure paths in settings.

How do I debug my scripts?

Use CPH.LogInfo(), CPH.LogDebug(), and CPH.LogError() to output messages to the Script Console. You can also use the Test Action feature to run your scripts with mock data.

Why is my script not executing?

Common issues include:

• Syntax errors - check the Script Console for error messages
• Missing return True at the end of your Execute function
• The action is disabled or has no trigger attached
• Script permissions are too restrictive

How do I connect OBS?

FaustBot uses OBS WebSocket to control OBS. Make sure you have OBS WebSocket enabled (it's built-in to OBS 28+). Go to FaustBot's OBS settings, enter your WebSocket password, and click Connect.

Can I control multiple OBS instances?

Yes! FaustBot supports multiple OBS connections. Add additional connections in the OBS settings and give each one a unique name. Your scripts can target specific connections by name.

How do I set up Discord notifications?

FaustBot can send Discord messages via webhooks or a bot account. For webhooks, create a webhook in your Discord server settings and add it to FaustBot. For bot features, you'll need to create a Discord application and add the bot token.

Does FaustBot work with VTube Studio?

Yes! FaustBot can control VTube Studio to trigger hotkeys, change models, and control expressions. Make sure the VTube Studio API is enabled in VTS settings.

Can I control smart lights?

FaustBot supports Philips Hue, LIFX, Nanoleaf, Govee, and other smart lighting systems. Configure the integration in settings and use the lighting effects in your actions.

FaustBot is using too much CPU/memory

This is usually caused by a script running in an infinite loop or too many rapid triggers. Check your actions for any recursive patterns and add cooldowns to prevent spam.

My triggers aren't firing

Verify that:

• The platform is connected (check status bar)
• The action is enabled
• The trigger conditions are met
• There's no active cooldown on the action

How do I reset FaustBot to default settings?

Close FaustBot and delete the configuration folder:

• Windows: %APPDATA%/FaustBot
• Linux: ~/.local/share/FaustBot

This will remove all settings, actions, and triggers. Export your data first if you want to keep anything.

Where are the log files?

Log files are stored in:

• Windows: %APPDATA%/FaustBot/logs
• Linux: ~/.local/share/FaustBot/logs

Include relevant log files when reporting issues on Discord or GitHub.

How do I report a bug?

You can report bugs on our GitHub issues page or in the #bug-reports channel on our Discord server. Please include your FaustBot version, operating system, and steps to reproduce the issue.