⚙️ Overtalkerr Configuration

Configure your voice assistant settings

🎬 Media Request Backend

Backend URL URL of your Overseerr, Jellyseerr, or Ombi instance

Backend API Key

• Overseerr/Jellyseerr: Settings → General → API Key
• Ombi: Settings → Ombi → API Key

🌐 Application Settings

Public URL Public HTTPS URL for Alexa/Google/Siri to reach this service

Environment

UI Theme Choose your preferred color scheme. Auto follows your system settings.

Mock Mode (Testing)

Disabled

Enable to test without a real backend (returns fake data)

💾 Database

💡 Default Recommended: Overtalkerr uses SQLite to remember conversation context between voice requests (e.g., when you say "No" to iterate through results). The database is created automatically - no setup required! Only change this if you have specific requirements like high availability.

Database URL Default: sqlite:///./overtalkerr.db (recommended)
Advanced: postgresql://user:pass@host/db or mysql://user:pass@host/db

Session Cleanup (hours) Automatically delete old conversation states after this many hours (default: 24)

🔍 Enhanced Search

Language Filter Comma-separated list of ISO 639-1 language codes to filter results (e.g., "en,es,fr" for English, Spanish, French).
Common codes: en (English), es (Spanish), fr (French), de (German), it (Italian), ja (Japanese), ko (Korean), zh (Chinese)
Leave empty to show all languages. Default: en

📝 Logging

Log Level

Log Format

🏠 Home Assistant Integration

💡 About Home Assistant Assist: Connect Overtalkerr to Home Assistant Assist as a conversation agent using the webhook-conversation custom integration. This allows you to request media through voice commands to your Home Assistant voice assistant.

Enable Home Assistant

Enabled

Enable or disable the Home Assistant webhook endpoint

Webhook Secret (Optional)

Optional Bearer token for webhook authentication. If set, Home Assistant must include this in the Authorization header.
Example: Authorization: Bearer your-secret-here
Leave empty if Overtalkerr is only accessible within your local network.

📍 Webhook URL:
http://your-server:5000/homeassistant
Use this URL in the Home Assistant webhook-conversation integration configuration.

📖 Setup Instructions:
1. Install the webhook-conversation custom integration in Home Assistant
2. Configure a new conversation agent with the webhook URL above
3. Set the conversation agent as your default assistant in Home Assistant
4. Say "Hey [assistant name], download Inception" to test!

Tip: Use "Save & Restart" to apply changes immediately, or just "Save" if you'll restart manually later.