strimertul-website/content/releases/v4.0.0-beta.1.md

tag	title	date	prerelease	downloads
v4.0.0-beta.1	v4.0.0-beta.1	2024-10-12T20:49:36.112Z	true	target url Windows 64bit https://downloads.strimertul.stream/v4.0.0-beta.1/strimertul.exe target url Linux amd64 https://downloads.strimertul.stream/v4.0.0-beta.1/strimertul-amd64 target url Linux arm64 https://downloads.strimertul.stream/v4.0.0-beta.1/strimertul-arm64

Release notes

It's been a while since the alpha, things have been changing in my life and honestly the alpha worked so well I didn't really feel like needing to go back and change things, but also the 3.x.x has been giving people (those few who actually use this damn thing) issues, so I better start bringing 4.x to the stable field.

I'm cutting down on new features and will just add them later, the IRC bot needs to be dead ASAP, so this is now a beta (it's not just the same as the alpha, some stuff has been updated all around).

Below is the rest of the changelog exactly as-is from the Alpha. Don't expect new features between this and stable release, it's only bug fixes.

---

If you built any software using the kilovolt API: Woops, you gotta re-do a lot of that. Most of the keys have changed in naming and some in format as well.

Two important things: back up your data folder and re-authenticate your user (it should tell you to, more on that below).

The IRC bot is dead

With Twitch finally pushing out the latest EventSub APIs for chat interaction I could finally kiss the IRC bot goodbye. All the existing chat functionality works as before but you'll notice it be way more stable.

Setting a secondary user as the chatting user is now done through the API (with a similar flow)

New permissions required warning

v4.0.0 sets up the foundation for a "problem detection system" aimed at finding configuration problems. I will be adding checks as I find them but for now the only one will be to check if a user is authorized to the Twitch app and if the scope of that authorization is valid. As Twitch adds new features and strimertül adopts them the scope of authorization will change and this warning will tell you to re-authenticate when needed.

Compact sidebar with narrow window

To accomodate people with not that much screen estate the strimertül window can now make better use of narrow spaces by compressing the sidebar to only show icons. You can still hover over the icons to check which page they link to.

Internal API overhaul

As v4.0.0 was going to be a big breaking change I took the opportunity to rename a lot of the kilovolt keys. You can check the changelog for a key-by-key breakdown or just take a look at the new API reference (since this is a pre-release, you'll need to check indev). If you have built integrations such as overlays or extensions it's very much likely that you'll need to at least change the keys. If you wrote any chat integrations you'll definitely have to update the formats as well.

Overall stability improvements

While developing v4.0.0 I found a lot of random crashes and I could fix most of the causes. There's still work to do on a lot of tickets that are still open but this should be much more stable than v3 even as an alpha. You can check the list of tickets still open here. Not all of them will be addressed in this release but all the bugs should be!

Changelog

Added

• The UI sidebar has been modified to better adapt to small window sizes
• A new part of the dashboard will now inform the user if any configuration problems have been detected.

Changed

• The required set of permissions has changed. Existing users must re-authenticate their users to the app connected to strimertül.
• The twitch/ev/eventsub-event and twitch/eventsub-history keys have been replaced by a set of keys in the format twitch/ev/eventsub-event/<event-id> and twitch/eventsub-history/<event-id>. Users of the old system will have to adjust their logic. A simple trick is to change from get/subscribing from a single key to the entire prefix. The data structure is the same.
• The twitch/bot/@send-message key has been renamed to twitch/chat/@send-message. The data structure is the same.
• A lot of keys for internal use have been changed, make sure to check the new reference for fixing up any integrations you might have. A migration process will convert v3 keys to v4 keys.
• The log format has changed significantly as the internal logging library has been replaced.
• The Twitch chat integration has been rewritten from the ground up to not use an IRC bot and rely on EventSub. This means that you will need to reconfigure your twitch account, especially if you used a different account as the "bot" account. Because of this rewrite, the terminology around chat functionalities have been renamed from "Bot" to "Chat" (e.g. "Bot commands" are now "Chat commands").
• The (i) icon next to "Recent events" in the dashboard now uses a custom tooltip that shows up more consistently.
• The "strimertul is already running" message now pops up from the currently running instance.
• Setting up a secondary user for chat interactions is now much simpler through an auth flow much like the one for setting up the main user.

Fixed

• Updated Kilovolt to a version that fixes an annoying crash when managing subscriptions.
• A new cleanup routine will remove old eventsub subscriptions that are no longer used. This should remove most of the errors when trying to set new API keys about "too many subscriptions".

Removed

• twitch/@send-chat-message has been removed. Use twitch/chat/@send-message instead.
• The twitch/ev/chat-message and twitch/chat-history keys have been removed. Use the EventSub keys twitch/ev/eventsub-event/channel.chat.message and twitch/eventsub-history/channel.chat.message instead. The data structure will be different!

Downloads

{{< release-dl >}}