Installation

Docker Compose

mkdir twitchbot && cd twitchbot && \
wget https://raw.githubusercontent.com/Helltar/twitchviewer-bot/master/{.env,compose.yaml,compose.with-postgres.yaml}

Edit .env and fill in your values:

• CREATOR_ID: your Telegram user ID
• BOT_TOKEN: Telegram bot token (BotFather)
• BOT_USERNAME: Telegram bot username (BotFather)
• TWITCH_CLIENT_ID: Twitch app client ID (Twitch Developer Console)
• TWITCH_CLIENT_SECRET: Twitch app client secret (Twitch Developer Console)
• POSTGRESQL_* + DATABASE_*: PostgreSQL connection settings

Run with an external PostgreSQL database:

docker compose up -d

Run with PostgreSQL container included:

docker compose -f compose.with-postgres.yaml up -d

Commands

• /clip - Record clips from all tracked channels or a specific channel
• /screenshot - Capture screenshots from all tracked channels or a specific channel
• /add - Add channel to favorites
• /list - Show your favorite channels
• /cancel - Cancel your active background tasks

Notes

• The bot requires ffmpeg and streamlink (already included in the provided Docker image).