# Introduction

{% hint style="warning" %}
***Here be dragons!*** 🐉✨ The emoteTTV docs is still a work in progress, but the [API reference](/emotettv/api-reference/reloadbadges.md) should always be up to date.
{% endhint %}

**emoteTTV** is a chat utility JavaScript library for parsing badges and emotes from Twitch, BetterTTV, FrankerFaceZ and 7TV with ease ✨

## Why emoteTTV?

There aren't many great Twitch emotes parsers available, but emoteTTV stands out by offering:

* 🤪 Stupid **ease of use** so you can get started quickly
* 🎨 Super **customizable** with flexible parsed results 
* 🧩 Wide compatibility with all the most **popular Twitch extensions** 
* 🧰 Perfect integration with **libraries you already use** 
* 🔓 Browser-friendly — **no authentication required**

So if you want to build any type of chatbox, overlay or simply parse emotes from any message, emoteTTV got you covered!

## How does it work?

We fetch all needed emotes and badges for a channel on the first parse, and get it all stored internally so you don't have to keep track of different parsers. We get around authentication for fetching Twitch badges by using [UNTTV](https://github.com/doceazedo/unttv).

You can get to know more about emoteTTV inner works on the [Core concepts](/emotettv/getting-started.md#core-concepts) section.

## What we cover?

| Provider                  | Feature |
| ------------------------- | ------- |
| **Twitch**                |         |
| Global and channel badges | ✅       |
| Global and channel emotes | ✅       |
|                           |         |
| **BetterTTV**             |         |
| Global badges             | ✅       |
| Global and channel emotes | ✅       |
|                           |         |
| **FrankerFaceZ**          |         |
| Global badges             | ✅       |
| Global and channel emotes | ✅       |
| Modifier emotes           | ❌       |
| Emote effects             | ❌       |
|                           |         |
| **7TV**                   |         |
| Global badges             | ❌       |
| Global and channel emotes | ✅       |
| Zero-width emotes         | ✅       |
| Personal emotes           | ❌       |
| Custom avatar             | ❌       |
| Custom name color         | ❌       |

All features marked as not supported are planned to be added in the near future. If a feature is missing, please let us know by [opening an issue](https://github.com/doceazedo/emotettv/issues/new).

## Get started now

Ready to use emoteTTV? Let's get started!


---

# 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://emotettv.gitbook.io/emotettv/introduction.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.