Go to file
Ash Keel 84bef02a42
Add version to executable
2021-12-06 14:47:38 +01:00
.github/workflows Add release CI 2021-09-18 22:28:34 +02:00
docs Less ugly json highlight 2021-12-02 12:22:11 +01:00
frontend Alert templates are precalculate on config load/change 2021-12-06 14:32:03 +01:00
modules Alert templates are precalculate on config load/change 2021-12-06 14:32:03 +01:00
.gitignore Fix linting issues (Thanks GoLand!) 2021-10-28 11:01:52 +02:00
CHANGELOG.md Fix twitch bot custom command checking 2021-12-01 23:32:51 +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 Add some docs 2021-12-02 12:20:20 +01:00
build.ps1 Add version to executable 2021-12-06 14:47:38 +01:00
commands.go Fix linting issues (Thanks GoLand!) 2021-10-28 11:01:52 +02:00
go.mod Alert templates are precalculate on config load/change 2021-12-06 14:32:03 +01:00
go.sum Alert templates are precalculate on config load/change 2021-12-06 14:32:03 +01:00
main.go Add version to executable 2021-12-06 14:47:38 +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 redeems1

1. Requires external tool hosted somewhere

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 strimertul'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 informations.

Building

You need to build the frontend first!

cd frontend
npm i
npm run build

Once that's done, just build the app like any other Go project

go build

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).