- twitchat.fr -
- Join discord -

A custom twitch chat that aims to fill gaps in the official Twitch chat for streamers.
The main goal is to follow your chat as best as possible.

For developpers, Twitchat exposes an API to receive events and control some features remotely.
📖 Read its documentation.

Features

• Enable an emergency button with custom actions to prevent from follow bots and doxxing
• Create your own sub/follow/rewards/poll/... alerts and chat commands with the Trigger system that allows to control your OBS sources and filters as well as Spotify when an event occurs
• Control Twitchat and create polls or predictions with your voice
• Read your messages and alerts out loud thank to the include text-to-speech
• Pin messages and find them back later
• Display the first message of users seperatly so you don't forget to greet them
• Show any message of your chat on your stream with a single click
• Stream Deck™ plugin
• Custom spoiler feature so viewers can hide message contents to the streamer
• Alert command to make Twitchat shake, blink, emit sound and display a message over everything else
• Edit your stream's info from Twitchat with possibility to create pressets
• Create a timer or a countdown with a simple command and show it on your stream
• Control spotify from chat commands (create your own song request system) and show currently playing track on your stream
• Make it easier to follow a conversation between users
• Remember where you stopped reading the chat by clicking any message
• Track a user to make sure not to miss their messages
• Create a raffle and pick random winners. An overlay is available to display a wheel that selects a winner.
• Create a bingo in which users have to find a number or an emoji
• Ask your viewers for suggestions with a dedicated command
• See if a user is not following the channel
• Display received whispers and answer them
• Filter some messages (bots, commands, self, /me, etc...)
• Customize messages display (remove badges, show minimalist badges, remove emotes)
• Customize messages appearance by roles (viewers, mods, vips, subs)
• Moderate messages (ban, timeout, delete message)
• Allow/deny messages blocked by automod
• Display when it's the first message ever of a user on the channel
• Display mod notifications on chat (ex: "User XXX has been banned by YYY")
• Display sub/bits/raid/reward/follow notifications
• Display hype train status
• Show the last stream info of a raider
• Integrated activity feed to see subs/cheers/follows/raids/rewards history
• Create/Delete polls
• Create/Delete predictions
• Emote selector
• BTTV, FFZ and 7TV emotes supported
• Message autocomplete nickname via "@", emotes via ":", commands via "/" or all via TAB key
• Allow to search on all messages via command /search
• Split view in half with chat on left and notifications/activity feed, new viewers, etc.. on the right
• Filter out only specific commands
• See live viewers count
• Keep or remove deleted messages
• See all your followings that are live to raid them easily
• Supports boost trains
• Supports /announce message feature
• Allow your mods to control your OBS scenes or mute/unmute your mic from chat
• Expose an API to control some stuff remotely
• Chat suggestion feature: allow your viewers to give suggestions with a dedicated command and randomly pick one of them
• Handles "low trust" feature (more info)
• And many other things....

Project setup

Rename the credentials.default.json file within the credentials folder to credentials.json and fill in these values :

{
	"server_port": 3018,
	"admin_ids": ["YOUR_TWITCH_USER_ID"],
	"csrf_key": "",

	"twitch_client_id": "",
	"twitch_client_secret": "",
	"twitch_redirect_uri": "http://localhost:8080/oauth",
	"twitch_scopes": [
		"chat:read",
		"chat:edit",
		"moderator:manage:announcements",
		"moderator:manage:chat_messages",
		"moderator:manage:shoutouts",
		"whispers:read",
		"user:manage:whispers",
		"moderator:read:chatters",
		"channel:read:redemptions",
		"channel:manage:redemptions",
		"channel:manage:polls",
		"channel:manage:predictions",
		"moderator:manage:chat_settings",
		"channel:moderate",
		"moderation:read",
		"channel:manage:moderators",
		"channel:manage:vips",
		"channel:manage:raids",
		"channel:manage:broadcast",
		"channel:read:hype_train",
		"channel:edit:commercial",
		"channel:read:subscriptions",
		"user:read:follows",
		"user:read:moderated_channels",
		"moderator:read:followers",
		"user:read:blocked_users",
		"user:manage:blocked_users",
		"user:edit:broadcast",
		"moderator:manage:banned_users",
		"moderator:manage:automod",
		"moderator:manage:shield_mode",
		"clips:edit",
		"channel:read:ads",
		"channel:manage:ads"
	],
	
	"spotify_client_id": "",
	"spotify_client_secret": "",
	"spotify_scopes": "user-read-currently-playing user-modify-playback-state playlist-read-private",
	"spotify_redirect_uri": "http://localhost:8080/spotify/auth",
	
	"patreon_client_id": "",
	"patreon_client_secret": "",
	"patreon_scopes": "identity identity.memberships",
	"patreon_redirect_uri": "http://localhost:8080/patreon/auth",
	
	"patreon_my_uid": "",
	"patreon_client_id_server": "",
	"patreon_client_secret_server": "",
	"patreon_redirect_uri_server": "http://localhost:3018/api/patreon/serverauth",
	"patreon_webhook_secret": "",

	"tenor_secret": "",
	"youtube_key": "path/to/key.json",
	"youtube_scopes": ["https://www.googleapis.com/auth/youtube.readonly", "https://www.googleapis.com/auth/youtube.force-ssl"],
	"google_key": "path/to/key.json",

	"paypal_client_id":"",
	"paypal_client_secret":"",

	"donors_remote_api_secret": "",
	"contact_mail": "",

	"discord_client_id":"",
	"discord_public_key":"",
	"discord_bot_token":"",

	"streamlabs_client_id":"",
	"streamlabs_client_secret":"",
	"streamlabs_redirect_uri":"",

	"streamelements_client_id":"",
	"streamelements_client_secret":""
}

Create a twitch application and fill in the client_id and client_secret values.
Write anything you want in the csrf_key field, it will be used to secure twitch authentication from CSRF attacks.
Configure the redirect URI of the twitch application to:\

http://localhost:8080/oauth

(adapt with the proper port and domain if deploying online)
Set the same value to the redirect_uri property of the credentials.json file.\

You can also create a spotify application and fill in the spotify spotify_client_id and spotify_client_secret
By default the server listens on port 3018, you can change it on credentials.json and src_front/utils/Config.ts.

Environment setup

This project has been coded with VSCode.
It is recommended to install these plugins:
TypeScript Vue Plugin: https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin

I18n-ally Plugin: https://marketplace.visualstudio.com/items?itemName=lokalise.i18n-ally

Compile project

Install dependencies

npm install

Compiles and hot-reloads for development

npm run dev

Compiles and minifies for production

npm run build

Run server

node server/boostrap.js

Install server

All the following MUST be done on a seperate folder from the GIT project.
Compile the project and push the content of the server folder on your server root.
Next to this file, create a public folder and push the content of your local dist folder inside it.
Also add the credentials folder inside a data older at the root of the project.
Create an env.conf file, just write prod inside, and push it at the root of the project.
Install all the production dependencies and run the server.
Here is the expected file structure:
─ root
  ├─ node_modules/
  ├─ public/
  ├─ utils/
  ├─ data/
    ├─ credentials/
  ├─ controllers/
  ├─ bootstrap.js
  ├─ env.conf

Localization

Adding new language

Just create a new folder under the i18n folder with the ISO 639-1 code of the language.
Read the next section to know how to translate labels

Translating labels

To make localization as easy as possible, a dedicated interface has been made that lists all available categories and labels with the possibility to edit them.
Any update on this interface triggers a rebuild of the compiled file as well as an update on any twitchat page opened on the same browser.

The interface is only accessible to adminitrators and can be found here:
localhost:8080/labels
To get admin rights you must set your twitch user ID under the admin_ids array in the credentials.json file.\

Adding new labels

If you need to add new labels, you'll have to edit JSON sources.
All label files can be found under i18n folder.
They are splitted by language then by sections.
Any new file or folder structure can be added to this.
These are all merged into static/labels.json during the build process.

Files can have any name but all labels within it must be under a single property that will be the base path to use the label. The property name is usually the same as the file's name.
Example:

─ en\
  ├─ global.json\
  ├─ home.json/\
  ├─ triggers.json/\

global.json example:

{
	"global":{
		"hello":"World"
	}
}

home.json example:

{
	"home":{
		"lorem":"ipsum dolor sit amet"
	}
}

This will output this JSON file:

{
	"en":{
		"global":{
			"hello":"World"
		},
		"hello":{
			"lorem":"ipsum dolor sit amet"
		}
	}
}

Package Stream Deck™ plugin

Run the following command:

npm run streamdeck_package

The compiled plugin will be there streamdeck_plugin/fr.twitchat.streamDeckPlugin.