Dirework Documentation

Dirework is a self-hosted Pomodoro timer and task list for Twitch co-working and body-doubling streams. Streamers sign in with Twitch, connect a bot account, configure OBS overlays, and their viewers interact via chat commands.

This documentation covers everything from initial setup to production deployment.

Overview

Features

Full feature list: timer, tasks, chat bot, overlays, theme center, and more.

Setup

Getting Started

Clone, install, configure, and run Dirework locally in minutes.

Twitch OAuth Setup

Create a Twitch application, configure OAuth, and connect your bot account.

Environment Variables

Full reference for all required and optional environment variables.

Usage

OBS Overlays

Add the timer and task list overlays to OBS as browser sources.

Chat Commands

All Twitch chat commands for tasks, timer, and moderation.

Operations

Deployment

Deploy Dirework to production with Docker, Coolify, a VPS, or any Node.js host.

Troubleshooting

Common issues and solutions for setup, auth, overlays, timer, and more.