Twitch Chat HUD

Twitch Chat HUD

EmoTracker's Twitch Chat HUD extension connects to your Twitch channel and lets chat interact with the tracker in real time — viewers can toggle items, advance progressives, and increment consumables using chat commands.

Setup

Twitch configuration is done by editing application_settings.json in your EmoTracker data directory:

Platform	Path
Windows	%USERPROFILE%\Documents\EmoTracker\application_settings.json
macOS	~/Documents/EmoTracker/application_settings.json
Linux	~/Documents/EmoTracker/application_settings.json

If your Documents folder does not exist or is not writable, EmoTracker falls back to %APPDATA%\EmoTracker\ (Windows) or ~/.config/EmoTracker/ (macOS / Linux).

Add your Twitch channel name (your Twitch username, lowercase) using the twitch_channel key:

{
  "twitch_channel": "yourchannel"
}

Edit the file while EmoTracker is closed, then relaunch. Once a channel name is configured, a Twitch icon will appear in the status bar.

Connecting and disconnecting

Click the Twitch icon in the status bar to open its context menu:

• Connect — join your channel and start listening for commands.
• Disconnect — leave the channel and stop processing commands.

EmoTracker connects as the read-only EmoTracker account and never posts to chat on its own.

How commands work

Viewers type commands in chat using the !tracker prefix, followed by the item code and an optional modifier:

!tracker [item_code]
!tracker [item_code] off
!tracker [item_code] down
!tracker [item_code] [stage_code]

Item command reference

Chat message	Effect
!tracker [code]	Toggle item on, advance progressive by one step, or increment consumable
!tracker [code] off	Toggle item off
!tracker [code] down	Downgrade a progressive item by one step, or decrement a consumable
!tracker [code] [stage]	Advance a progressive or toggle-badged item to the named stage code

Item codes are the codes values defined in the pack's items JSON. For example, if an item is defined with "codes": "hookshot", the command is !tracker hookshot.

Permissions

By default, moderators can issue item commands. The broadcaster always has full access.

You can adjust the default permission level in the user_permissions.json file (see Managing permissions below). The supported permission levels are:

Level	Who can use item commands
Moderator	Moderators (default)
Subscriber	Subscribers
VIP	VIPs
All	All viewers

Levels can be combined — e.g. "Moderator, Subscriber" allows both moderators and subscribers.

Individual viewers can also be explicitly whitelisted or banned regardless of their role (see broadcaster commands below).

Broadcaster-only commands

The broadcaster has access to additional management commands:

Chat message	Effect
!tracker reset	Reload the current pack (resets all items to their defaults)
!tracker add [username]	Add a viewer to the whitelist
!tracker remove [username]	Remove a viewer from the whitelist
!tracker ban [username]	Block a viewer from issuing commands
!tracker unban [username]	Remove a viewer from the block list

Managing permissions

Permissions are stored in a JSON file at:

[EmoTracker data directory]/extensions/twitch_chat_hud/user_permissions.json

The file is created automatically the first time you connect. Its structure is:

{
  "default_permissions": "Moderator",
  "whitelist": [
    "friend_username"
  ],
  "blacklist": [
    "disruptive_username"
  ]
}

Edit this file in any text editor while EmoTracker is closed to adjust defaults or pre-populate your lists. Changes made via broadcaster chat commands (add, remove, ban, unban) are saved back to this file automatically.

Troubleshooting

The Twitch icon does not appear in the status bar : Make sure twitch_channel is set in application_settings.json and is not blank.

Commands are typed correctly but nothing happens : Confirm EmoTracker shows as Connected in the status bar context menu. Check that the viewer issuing the command has the required permission level — by default, only moderators (and the broadcaster) can use item commands.

Connection drops immediately after connecting : This can happen if Twitch's IRC servers are experiencing issues. Try disconnecting and reconnecting after a few seconds.