Evotars

Overview

Evotars is a simple and free web-based overlay that adds animated avatars for your Twitch chatters. It's a lightweight alternative to Stream Avatars, designed with accessibility and ease of use in mind. Perfect for small or new streamers who want to add some fun interactivity to their streams without complex setup or extra software.

Features

• Animated avatars for chatters in your stream
• Chat commands: !jump, !dash, !color
• Channel point reward integration
• Separate display of 7tv emotes
• Falling avatars triggered by raids
• Web-based — no installation required

How to Use

1. Go to https://evotars.inferst.com
2. Log in with your Twitch account
3. Customize your settings
4. Copy your unique overlay URL
5. Add it to OBS as a Browser Source

Development

Run the database in docker

docker compose -f compose.dev.yaml up -d

Warning

By default, PostgreSQL runs on port 5432. Before starting, ensure this port is not already in use on your system.

To change the PostgreSQL port, use the following command structure:

docker compose -f compose.dev.yaml run -d -p <port>:5432

Run locally

Important

You need to have Node.js installed.

1. Copy the environment variables file and update it

   cp .env.example .env

2. Install and run PostgreSQL

   You can install PostgreSQL directly on your system or use Docker. For Docker instructions, refer to Run the database in docker.

3. Install pnpm

   npm install -g pnpm

4. Install dependencies

   pnpm install

5. Generate the schema and run migrations

   pnpm run db:migrate:dev

6. Seed the database with initial data

   pnpm run db:seed

7. Start the server

   pnpm run dev

Links

• http://localhost - website
• http://localhost/api - api
• http://localhost/admin - admin panel
• http://localhost/client - client overlay

Run the linter

pnpm run lint

Contributors