Introduction

Here be dragons! 🐉✨ The emoteTTV docs is still a work in progress, but the API reference should always be up to date.

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.

You can get to know more about emoteTTV inner works on the 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.

Get started now

Ready to use emoteTTV? Let's get started!