OpenChat Overlay Documentation

Overview

OpenChat Overlay is a lightweight, open-source Twitch chat overlay solution designed to be hosted on minimal hardware (like a Proxmox LXC container). It provides a user-friendly dashboard for customization and a highly optimized, client-side rendered overlay URL.

Getting Started

Prerequisites

Node.js (v18+)
Supabase Account
Twitch Developer Application (Client ID & Secret)

Installation

Clone the repository.
Install dependencies:
```
npm install
```

Configure environment variables in .env.local:

NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
NEXTAUTH_SECRET=...
TWITCH_CLIENT_ID=...
TWITCH_CLIENT_SECRET=...

Run the development server:
```
npm run dev
```

Architecture Notes

The application uses Next.js App Router.
Dashboard: Located in src/app/(dashboard). Protected by authentication.
Overlay: Located in src/app/overlay/[token]. Publicly accessible but requires a valid token. Renders with a transparent background.

Deployment

(To be added: Instructions for building the Docker image and deploying to an LXC container.)

1.2 KiB Raw Blame History