Go to file
Ash Keel b53778a729
Expose a couple internal metrics to show in the dashboard
2022-01-22 13:05:24 +01:00
.github/workflows Fix workflow 2021-12-06 15:17:54 +01:00
docs Update docs 2022-01-02 11:59:54 +01:00
frontend Expose a couple internal metrics to show in the dashboard 2022-01-22 13:05:24 +01:00
modules Expose a couple internal metrics to show in the dashboard 2022-01-22 13:05:24 +01:00
.gitignore Add database export/import and backups 2022-01-02 11:45:09 +01:00
CHANGELOG.md Expose a couple internal metrics to show in the dashboard 2022-01-22 13:05:24 +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 Restore backup in a worse way, but one that works! 2022-01-07 09:42:06 +01:00
go.sum Restore backup in a worse way, but one that works! 2022-01-07 09:42:06 +01:00
main.go Change backup format to a sane one 2022-01-22 11:08:00 +01:00
migrations.go Move to different logic for enabling modules 2021-12-09 11:45:10 +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).