Twitch Stream Downloader and Notifier

This project consists of a script for automatically downloading live streams from a specified Twitch user and notifying a user via Telegram when a new stream is available. It utilizes yt-dlp for downloading streams and the Telegram API for sending notifications.

Features

Automatic Stream Download: Automatically detects and downloads live streams from a specified Twitch user.
Telegram Notifications: Sends a notification via Telegram when a new stream is downloaded and available.
Move downloaded Streams: Downloaded streams get moved to a specified output/mounted directory

Prerequisites

Docker and/or Docker Compose
A Telegram Bot Token and a Chat ID where notifications will be sent

Setup

Compose

Copy the .env.sample file to a new file named .env.
Open the .env file and replace the placeholder values with your actual data.
- TWITCH_USERNAME: The Twitch username of the streamer you're interested in.
- BOT_TOKEN and CHAT_ID: Your Telegram bot's token and the chat ID where you want to send notifications.
- Adjust other settings as necessary.
Save the .env file. The application will use these environment variables when running.

Docker

docker run -d \
  -e TWITCH_USERNAME='example_username' \
  -e DOWNLOAD_DIR='/usr/src/app/downloads' \
  -e MOUNTED_DRIVE='/mnt/mounted_drive' \
  -e CHECK_INTERVAL='300' \
  -e BOT_TOKEN='your_telegram_bot_token_here' \
  -e CHAT_ID='your_telegram_chat_id_here' \
  -v /path/to/your/local/downloads:/usr/src/app/downloads \
  -v /path/to/your/mounted_drive:/mnt/mounted_drive \
  --name twitch-downloader ghcr.io/julianfbeck/twitch-downloader:latest