# Live Chat Overlay

## Introduction

Powerchat offers a unique Live Chat Overlay, which is customizable and supports multistreaming (displaying chats from multiple platforms together in one overlay). Not only is it unique, it's reliable, and free.

## Setup

To start customizing your Live Chat Overlay settings, navigate to the Live Chat Overlay Settings area of the [Overlay Settings ](https://powerchat.live/creator-dashboard?tab=overlay-settings)Tab in the Powerchat Creator Dashboard. Here you can set various options and themes:

* Chat Remove Time (TTL): Time in seconds until a chat message disappears after showing on the overlay. Leaving this set to 0 will leave the message on screen until scrolls off as the result of new chats coming in.
* Max Emote Size (pixels): This is a unique customizable option which allows the creator to set the size of emotes in the chat overlay.
* Emotes Only: Toggle that allows you to set the overlay to only display emotes.
* No emotes: Toggle that allows you to set the overlay to never display emotes.
* Enable live chat TTS: Reads all chat messages with Text-to-Speech.
* Chat Theme: Allows you to pick one of Powerchat's unique and customizable chat themes.
* Customize Theme: Allows you to set various options like color, font, transparency, and more!

## Live Chat Overlay Moderation

There is a toggle under the [TTS Settings](https://powerchat.live/creator-dashboard?tab=settings) Tab in the Powerchat Creator Dashboard under the 'TOS Protection & Toggles' section called 'Enable Chat Profanity Filter' which attempts to replace all profanity and slurs in the Live Chat Overlay with asterisks. Example: shit becomes \*\*\*\*.

## URL Flag System

Powerchat also has a unique flag system which allows you to customize the Powerchat Chat Overlay by adding flags to the end of the overlay URL. This is useful if you want to change chat overlay settings on the fly without having to use the Powerchat Creator Dashboard. It's also useful if you use the overlay in different ways.

For example:\
\
\&#xNAN;*<https://powerchat.live/powerchat/chat>* would load the chat overlay for the user 'powerchat.' \
\
\&#xNAN;*<https://powerchat.live/powerchat/chat?backgroundColor=black>* would load it with a black background.

*<https://powerchat.live/powerchat/chat?backgroundColor=red\\&backgroundMessageColor=#FFFFFF\\&emoteSize=40>* would load it with a black background, white message background color, and emotes set to size 40 instead of whatever they are in the dashboard.

The following commands can be used and changed:\
backgroundColor\
backgroundMessageColor\
backgroundTitleColor\
chatterColor\
chatterColorDefault (True/False)\
chatterColorRandom (True/False)\
emoteSize\
emotesOnly (True/False)\
font\
fontSize\
messageColor\
messageColorRandom (True/False)\
noAvatars (True/False)\
noBadges (True/False)\
noEmotes (True/False)\
noEmotes (True/False)\
noUsernames (True/False)\
orientation (Ex: topLeft)\
theme\
ttl\
tts (True/False)\
ttsVolume (1-100)\
useDefaultChatFilter (True/False)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.powerchat.live/overlay-configuration/live-chat-overlay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
