Celeste is a Twitch bot written in C++/Qt. It's purpose is to watch for commands that appear in chat and function as a widget in your OBS scene collection that displays reactions to those commands, while maintaining a minimal CPU/memory footprint. It is cross-platform and open source.
Most configuration can be done via the UI (via right click context menu), but the configuration files can also be edited manually. There are in either JSON or INI format.
All of Celeste's configuration files can be found in the EngineeringDeck folder of your QStandardPaths::writableLocation location. Visit the Qt documentation for the location specific to your platform.
The main configuration files are Celeste.conf (or .ini if you're on Windows) for media paths and layout options, and Private.conf for secure options such as your auth token.
The following files also exist:
commands.json- List of user-defined commands and the media locations they point to.songs.json- List of songs that make up the vibe playlistlogs- Directory holding logs for troubleshooting
An installer is available for Windows on the releases page. Debian and rpm packages (and likely a Gentoo ebuild) for Linux are planned.
Celeste can be built from source on Windows, Linux, and macOS. You will need, at a minimum, the following:
- cmake >= v3.29
- A build of the Qt Framework that contains these modules:
- QtWidgets
- QtNetwork
- QtMqtt
- QtMultimedia
- QtMultimediaWidgets
- QtWebSockets
On Windows you will also need to install Visual Studio (with the "Desktop development with C++" module), Inno Setup 7, a Perl interpreter, a Python interpreter, and Powershell 7.5+. Then run windows-bootstrap.ps1 from a Powershell terminal.