.env.example

# Chat Yapper Environment Configuration
# Copy this file to .env and fill in your actual values

# =============================================================================
# STREAMING PLATFORM OAUTH CREDENTIALS
# =============================================================================

# Twitch OAuth Configuration
# Create a Twitch app at: https://dev.twitch.tv/console/apps
# 
# IMPORTANT: The OAuth redirect URL MUST match the port Chat Yapper uses!
# Default port is 8008. If you change PORT below, update your Twitch app's redirect URL.
# Set OAuth redirect URL to: http://localhost:8008/auth/twitch/callback
# (Replace 8008 with your PORT value if different)
TWITCH_CLIENT_ID=your_twitch_client_id_here
TWITCH_CLIENT_SECRET=your_twitch_client_secret_here

# YouTube OAuth Configuration
# Create OAuth 2.0 credentials at: https://console.cloud.google.com/apis/credentials
# 1. Enable YouTube Data API v3
# 2. Create OAuth 2.0 Client ID (Web application)
# 3. IMPORTANT: Add authorized redirect URI with the SAME port as PORT setting below
#    Add: http://localhost:8008/auth/youtube/callback
#    (Replace 8008 with your PORT value if different)
YOUTUBE_CLIENT_ID=your_youtube_client_id.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=your_youtube_client_secret_here

# =============================================================================
# APPLICATION SETTINGS (OPTIONAL)
# =============================================================================

# Server Configuration
# PORT=8008  ⚠ WARNING: If you change this, you MUST update OAuth redirect URIs
#                       in both Twitch and YouTube/Google Cloud Console!
# HOST=0.0.0.0
# DEBUG=false

# Database Configuration
# DB_PATH=custom_database_path.db

# Audio Storage Directory
# AUDIO_DIR=./audio

# Frontend Development Port (for npm run dev)
# FRONTEND_PORT=5173

# =============================================================================
# TTS PROVIDER API KEYS (OPTIONAL)
# =============================================================================
# Configure TTS providers in the web UI Settings > TTS tab
# Or set environment variables here for convenience

# MonsterAPI TTS
# Get your API key at: https://monsterapi.ai/
# MONSTER_API_KEY=your_monster_api_key_here

# Google Cloud TTS
# Get your API key at: https://console.cloud.google.com/apis/credentials
# GOOGLE_API_KEY=your_google_api_key_here

# Amazon Polly
# Get your AWS credentials at: https://console.aws.amazon.com/iam/
# AWS_ACCESS_KEY=your_aws_access_key_here
# AWS_SECRET_KEY=your_aws_secret_key_here
# AWS_REGION=us-east-1

# =============================================================================
# BUILD CONFIGURATION (CI/CD)
# =============================================================================

# Application version (displayed in UI and used for releases)
# Set this before running build.py to embed version in the executable
# During GitHub Actions builds, this is auto-populated from git tags
# VITE_APP_VERSION=1.1.0

# =============================================================================
# NOTES
# =============================================================================
# - Edge TTS is free and doesn't require API keys
# - Streaming platform OAuth is required for chat integration
# - TTS API keys are optional (can be configured in web UI)
# - For Docker deployment, see docker/.env.docker for container-specific settings
# - VITE_APP_VERSION: Set in .env before running build.py, or use git tags for CI/CD