Go to file
Ash Keel 9a72c5808b
ci: AAAAAAAAAAAA
2022-12-24 15:29:14 +01:00
.github/workflows ci: AAAAAAAAAAAA 2022-12-24 15:29:14 +01:00
build feat: add renko icon and credits 2022-12-03 17:28:47 +01:00
database refactor: bump to containers v0.3.0 (API changes) 2022-12-04 14:45:34 +01:00
docs Update docs 2022-01-02 11:59:54 +01:00
frontend fix: always show log messages with higher severity than chosen one 2022-12-24 14:07:27 +01:00
http feat: generate a random Kilovolt password on first start 2022-12-07 11:48:23 +01:00
loyalty refactor: module conundrum part 2: Loyalty manager 2022-12-04 18:03:05 +01:00
twitch fix: update the correct IRC bot instance so we don't keep more than one 2022-12-24 14:34:46 +01:00
utils refactor: bump to containers v0.3.0 (API changes) 2022-12-04 14:45:34 +01:00
.gitignore feat: rework loggers and pass data to the UI 2022-11-24 01:54:56 +01:00
CHANGELOG.md docs: update changelog 2022-12-24 14:35:41 +01:00
LICENSE First public commit \o/ 2021-05-02 14:29:43 +02:00
LICENSING.md Remove ISC restriction (file doesn't exist anymore) 2021-11-15 17:29:58 +01:00
README.md refactor: use SyncSlice 2022-12-04 00:04:15 +01:00
app.go fix: wrap logs to prevent data races 2022-12-04 18:35:15 +01:00
backup.go refactor: bump to containers v0.3.0 (API changes) 2022-12-04 14:45:34 +01:00
build.ps1 Add version to executable 2021-12-06 14:47:38 +01:00
cli.database.go refactor: begone modules 2022-11-30 19:15:47 +01:00
commands.go Fix linting issues (Thanks GoLand!) 2021-10-28 11:01:52 +02:00
go.mod fix: clear templated functions so deleted commands don't stick around 2022-12-24 13:48:58 +01:00
go.sum fix: clear templated functions so deleted commands don't stick around 2022-12-24 13:48:58 +01:00
logging.go fix: wrap logs to prevent data races 2022-12-04 18:35:15 +01:00
main.go refactor: bump to containers v0.3.0 (API changes) 2022-12-04 14:45:34 +01:00
wails.json Add Wails, refactor into multi CLI app 2022-11-16 12:23:54 +01:00

README.md

Small broadcasting suite for Twitch, includes:

  • Simple way to build stream overlays with minimal code
  • Loyalty points system with redeems and community goals
  • Twitch chat integration with custom commands
  • Support for Twitch alerts and channel point redeems

Note: some technical/coding experience is currently required to be able to use this effectively, see the technical overview below for more information.

Getting started

Download the latest build from here: github.com/strimertul/strimertul/releases/latest

Start strimertul.exe and as soon as it's ready it will open a browser window with the Web UI you can use to configure it to your heart's content.

You can also build the project yourself, refer to the Building section below.

Technical overview

Strimertül is a single executable app that provides the following:

  • HTTP server for serving static assets and a websocket API
  • Twitch bot for handling chat messages and providing custom commands
  • Polling-based loyalty system for rewards and community goals

At strimertül's core is Kilovolt, a pub/sub key-value store accessible via websocket. You can access every functionality of strimertul through the Kilovolt API. Check this repository for a list of officially supported kilovolt clients (or submit your own). You should be able to easily build a client yourself by just creating a websocket connection and using the Kilovolt protocol.

Check out the project's wiki for more information on how to use the API to interact with strimertul, or the docs folder for more technical information.

Development

This project uses Wails, check out the Getting Started guide on how to install it.

To run in live development mode, run wails dev in the project directory. This will run a Vite development server that will provide hot reload of frontend changes, while hard-reloading on backend changes.

Building

To build a redistributable, production mode package, use wails build.

Credits

  • Renko, strimertül's mascot and app icon, was drawn by Sonic_Chan

License

Kilovolt's code is based on Gorilla Websocket's server example, licensed under BSD-2-Clause

The entire project is licensed under AGPL-3.0-only (see LICENSE).