# ISR - Audio Recorder Configuration
# Supports multiple recording sources: Icecast streams and soundcards
#
# Configuration sections:
#   [general]     - Shared settings for all sources (optional)
#   [sourcename]  - One section per recording source (name is your choice)
#
# Each source section must have 'type' set to either 'stream' or 'soundcard'

# =============================================================================
# GENERAL SETTINGS (optional - can be overridden per source)
# =============================================================================
[general]
# Output directory for recordings (will be created if it doesn't exist)
output_directory = recordings

# Duration in minutes after which to split into a new file
split_minutes = 60

# Filename pattern with strftime format codes
# Examples:
#   %Y%m%d_%H%M%S           -> 20241216_143000.ext
#   recording_%Y-%m-%d_%H%M -> recording_2024-12-16_1430.ext
#   %Y/%m/%d/audio_%H%M%S   -> 2024/12/16/audio_143000.ext (creates subdirs)
# Common codes: %Y=year, %m=month, %d=day, %H=hour, %M=minute, %S=second
filename_pattern = %Y%m%d_%H%M%S

# Maximum number of connection/recording retry attempts before giving up
max_retries = 10

# Delay in seconds between retry attempts
retry_delay_seconds = 5

# Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
log_level = INFO

# Log file location
log_file = recorder.log


# =============================================================================
# EXAMPLE: ICECAST STREAM SOURCE
# =============================================================================
[mystream]
# Source type (required): stream or soundcard
type = stream

# Stream URL (required for stream type)
url = http://example.com:8000/stream

# Authentication (optional - leave empty for public streams)
username =
password =

# Audio format: auto (detect from stream), mp3, ogg, aac, flac, opus
format = auto

# Override general settings for this source (optional):
# output_directory = recordings/streams
# split_minutes = 30
# filename_pattern = mystream_%Y%m%d_%H%M%S


# =============================================================================
# EXAMPLE: SOUNDCARD SOURCE (Linux)
# =============================================================================
# Uncomment and configure to record from a soundcard
#
# [stereo_mix]
# type = soundcard
#
# # Device selection (use one of these methods):
# #   device = default    - Use system default input device
# #   device = monitor    - Auto-select first monitor/loopback source (for system audio)
# #   device = <name>     - Match device by partial name (e.g., "Stereo Mix")
# #   device = <id>       - Use exact device ID from --list-devices
# #
# # To list available devices, run: python isr.py --list-devices
# device = default
#
# # Audio backend (only 'alsa' is supported):
# # backend = alsa
#
# # Sample rate in Hz (common: 44100, 48000, 96000)
# sample_rate = 44100
#
# # Number of audio channels (1 = mono, 2 = stereo)
# channels = 2
#
# # Output format: wav, flac
# format = wav
#
# # Override general settings for this source (optional):
# # output_directory = recordings/soundcard
# # split_minutes = 60
# # filename_pattern = soundcard_%Y%m%d_%H%M%S


# =============================================================================
# MULTIPLE SOURCES EXAMPLE
# =============================================================================
# You can define as many sources as you want. Each will record simultaneously.
#
# [radio_station_1]
# type = stream
# url = http://radio1.example.com:8000/live
# format = auto
# filename_pattern = radio1_%Y%m%d_%H%M%S
#
# [radio_station_2]
# type = stream
# url = http://radio2.example.com:8000/live
# format = auto
# filename_pattern = radio2_%Y%m%d_%H%M%S
#
# [system_audio]
# type = soundcard
# device = Stereo Mix
# sample_rate = 48000
# channels = 2
# format = flac
# filename_pattern = system_%Y%m%d_%H%M%S


# =============================================================================
# SOUNDCARD TIPS (Linux / Raspberry Pi)
# =============================================================================
# ISR uses ALSA (arecord) for soundcard recording. arecord is pre-installed
# on Raspberry Pi OS and most Linux distros (package: alsa-utils).
#
# Run: python isr.py --list-devices   (or: arecord -l) to list devices.
#
# EASY: Use the "monitor" keyword to capture system/loopback audio:
# [system_audio]
# type = soundcard
# device = monitor
# format = wav
#
# MANUAL: Specify a device by ALSA hardware ID from --list-devices:
# [usb_mic]
# type = soundcard
# device = hw:1,0
# backend = alsa
# sample_rate = 44100
# channels = 2
# format = flac