# Matrix-Hermes Configuration
# Copy this to .env and fill in your Matrix server details

# Required: your Matrix homeserver URL
MATRIX_HOMESERVER=https://matrix.org

# Option A: Use an existing access token (preferred)
# Get this from Element Web: Settings → Help & About → Access Token
# Or use `matrix-hermes login` to generate one
MATRIX_ACCESS_TOKEN=

# Option B: Login with password (token auto-saved to ~/.hermes/matrix_sessions/)
# MATRIX_USER_ID=@hermes:matrix.org
# MATRIX_PASSWORD=your-password-here

# --- Optional settings ---

# Stable device ID for E2EE persistence across restarts
# MATRIX_DEVICE_ID=

# Enable end-to-end encryption (requires mautrix[encryption])
# MATRIX_ENCRYPTION=false

# HTTP(S) proxy for Matrix traffic
# MATRIX_PROXY=

# Directory for E2EE key storage
# MATRIX_STORE_DIR=

# Directory for session token persistence (default: ~/.hermes/matrix_sessions)
# MATRIX_SESSION_DIR=

# --- Gateway-compatible settings ---

# Comma-separated list of allowed Matrix user IDs
# MATRIX_ALLOWED_USERS=@alice:matrix.org,@bob:matrix.org

# Room ID for cron/notification delivery
# MATRIX_HOME_ROOM=!abc123:matrix.org

# Require @mention in rooms to trigger the bot
# MATRIX_REQUIRE_MENTION=true

# Auto-create threads for room messages
# MATRIX_AUTO_THREAD=true