Immutable, RCU-published snapshot of the application's runtime configuration. More...

#include <include/ascii-chat/options/options.h>

Data Fields
asciichat_mode_t	detected_mode
	Mode detected from command-line arguments.
int	mode_arg_index
	Explicit mode token in original argv, or -1 for implicit discovery/session strings.
bool	help
	Show help message.
bool	version
	Show version information.
char	config_file [256]
	Config file path (–config).
int	width
	Terminal width in characters (int for OPTION_TYPE_INT compat).
int	height
	Terminal height in characters (int for OPTION_TYPE_INT compat).
bool	auto_width
	Auto-detect width from terminal.
bool	auto_height
	Auto-detect height from terminal.
bool	address_explicit
	Native client destination overrides automatic LAN discovery.
char	address [256]
	Server address (client) or bind address (server).
char	address6 [256]
	IPv6 bind address (server only).
int	port
	Server port number.
int	websocket_port
	WebSocket server port (server/discovery-service only).
char	tls_cert [256]
	Shared TLS certificate file path for secure network listeners.
char	tls_key [256]
	Shared TLS private key file path for secure network listeners.
char	tls_key_password [256]
	Shared TLS private key password.
char	webtransport_bind_address [256]
	Browser HTTP/3 listener address.
char	webtransport_origin [256]
	Allowed browser origin.
char	webtransport_path [256]
	HTTP/3 CONNECT path.
char	quic_bind_address [256]
	Concrete local QUIC listener address; empty disables QUIC.
char	tls_ca_file [256]
	Shared TLS client trust anchors; empty uses system trust.
bool	quic_visual_datagrams
	Prefer negotiated visual datagrams.
bool	quic_audio_datagrams
	Prefer negotiated QUIC datagrams for audio.
bool	discovery_quic
	Use QUIC for a disclosed discovery host endpoint.
char	webtransport_public_url [256]
	Public HTTPS WebTransport endpoint advertised through ACDS.
int	quic_port
	QUIC UDP port, or zero to use the TCP server port.
int	quic_fallback_port
	TCP fallback port, or zero to disable fallback.
int	max_clients
	Maximum concurrent clients (server only).
char	session_string [(38+1)]
bool	discovery
	Enable discovery session registration (default: false).
char	discovery_server [256]
	discovery server address (default: 127.0.0.1)
bool	mcp_server_restricted
	Restrict MCP capabilities for cloud deployment.
char	mcp_downloads_dir [256]
	Hosted download directory override.
char	mcp_downloads_url_prefix [256]
	Public HTTP origin for download links.
char	mcp_transport [256]
	MCP transport: stdio or http.
char	http_origin [256]
	Allowed HTTP Origin.
int	discovery_port
	discovery server port (default: 27225)
char	discovery_service_url [256]
	exclusive with discovery_port)
char	discovery_service_key [256]
	HTTPS URL).
bool	webrtc
	Enable WebRTC mode for discovery session (default: true, P2P WebRTC).
char	discovery_database_path [256]
	~/.ascii-chat/discovery.db)
bool	lan_discovery
	Enable LAN service discovery via mDNS (client only).
bool	no_mdns_advertise
	Disable mDNS service advertisement (server only).
int	compression_level
	zstd compression level (1-9)
bool	no_compress
	Disable compression entirely.
bool	encode_audio
	Enable Opus audio encoding.
int	reconnect_attempts
	Number of reconnection attempts (-1=infinite, 0=none).
int	webcam_index
	Webcam device index (0 = first).
bool	test_pattern
	Use test pattern instead of webcam.
int	test_pattern_index
	Synthetic pattern selector (0 or 1).
bool	no_audio_mixer
	Disable audio mixer (debug).
media_playlist_t	media_playlist
	Ordered CLI artifacts shared with live media input.
char	media_file [256]
	Media file path or "-" for stdin.
char	media_url [256]
	Network URL (HTTP/HTTPS/YouTube/RTSP) - takes priority over media_file.
bool	media_loop
	Loop media file playback.
bool	media_from_stdin
	Reading from stdin (detected from "--file -").
double	media_seek_timestamp
	Seek to timestamp in seconds before playback.
bool	pause
	Start playback paused (toggle with spacebar).
char	yt_dlp_options [512]
	"--cookies-from-browser=chrome --embed-subs")
int	color
	Color setting (COLOR_SETTING_AUTO/TRUE/FALSE).
terminal_color_mode_t	color_mode
	Color mode (auto/none/16/256/truecolor).
color_filter_t	color_filter
	Monochromatic color filter (none/black/white/green/etc).
char	color_scheme_name [64]
	Color scheme name (e.g., "pastel", "nord").
terminal_render_mode_t	render_mode
	Render mode (foreground/background/half-block).
bool	show_capabilities
	Show terminal capabilities and exit.
int	force_utf8
	UTF-8 support setting (auto/true/false).
int	stats_interval
	Periodic plain statistics on stdout; zero disables.
int	fps
	Target framerate (0 = auto, 1-144).
bool	fps_explicitly_set
	True if FPS was explicitly configured by the user.
bool	face_follow
	Automatically frame and follow the selected face.
bool	face_follow_debug
	Developer diagnostic face outline.
bool	flip_x
	Effective horizontal orientation.
bool	flip_x_explicit
	User selected an orientation for this process lifetime.
bool	media_input
	Active input is a file/URL rather than the webcam.
bool	flip_y
	Flip video vertically (Y-axis).
bool	audio_pitch_correct
bool	test_audio
	Replace microphone capture with a repeating audible test signal.
bool	audio_spectral_agc
bool	audio_spectral
bool	audio_spectral_mixer
	Explicit post-mix processing; disabled by default.
bool	audio_spectral_gate
bool	audio_multiband
bool	audio_adaptive_eq
int	audio_fft_size
bool	audio_enabled
	Enable audio streaming.
audio_source_t	audio_source
	Visualization source (all/call/mic/media).
audio_capture_source_t	audio_capture_source
	Local capture/media selection policy.
bool	waveform
	Replace the video image with a live audio waveform.
bool	fft
	Replace the video image with a live audio frequency spectrogram.
char	fft_scale [32]
	Amplitude scale for the FFT visualization.
int	microphone_channels
	Selected microphone channels: 1 (speech) or 2 (stereo).
int	microphone_channel
	First zero-based input channel; -1 downmixes all inputs.
int	microphone_index
	Microphone device index (-1 = default).
int	speakers_index
	Speakers device index (-1 = default).
float	microphone_sensitivity
	Microphone volume multiplier (0.0-1.0, default 1.0).
float	speakers_volume
	Speaker volume multiplier (0.0-1.0, default 1.0).
bool	audio_analysis_enabled
	Enable audio analysis (debug).
bool	audio_no_playback
	Disable speaker playback (debug).
bool	stabilize
	Reduce frame-to-frame character flicker.
bool	stabilize_explicit
	Runtime preference was explicitly changed.
ascii_renderer_t	renderer
	Character selection algorithm.
bool	stretch
	Allow aspect ratio distortion.
char	video_codec [64]
	Video codec (auto, hevc, h264, raw) - default: auto.
bool	quiet
	Quiet mode (suppress logs).
unsigned short int	verbose_level
	Verbosity level (stackable -V).
bool	snapshot_mode
	Snapshot mode (one frame and exit).
double	snapshot_delay
	Snapshot delay in seconds.
int	zalgo
	Combining-mark intensity (0 = disabled, 1-10 = enabled).
bool	matrix_rain
	Matrix digital rain effect (false = disabled).
bool	fps_counter
	Show FPS counter overlay in top-right corner.
bool	strip_ansi
	Strip ANSI escape sequences.
char	otel_log_level [256]
char	otel_endpoint [256]
char	otel_ca_file [256]
char	otel_enabled_telemetry [256]
double	otel_realtime_sample_rate
int	otel_realtime_max_per_second
int	otel_metrics_interval
int	otel_timeout
int	otel_queue_capacity
char	log_file [256]
	Log file path.
log_level_t	log_level
	Log level threshold.
char	grep_pattern [256]
	PCRE2 regex for log filtering.
bool	json
	Enable JSON logging (–json flag).
char	log_template [256]
	Custom log format string (formerly –log-format).
bool	log_format_console_only
	Apply log format only to console output.
bool	enable_keepawake
	Explicitly enable system sleep prevention.
bool	disable_keepawake
	Explicitly disable system sleep prevention (allow OS to sleep).
bool	encrypt_enabled
	Enable encryption.
char	encrypt_key [256]
	SSH/GPG key file path (first –key flag, kept for compatibility).
char	password [256]
	Password string.
char	encrypt_keyfile [256]
	Alternative key file path.
bool	no_encrypt
	Disable encryption (opt-out).
bool	no_auth
	Disable authentication layer (–no-auth).
char	server_key [256]
	Expected server public key (client).
char	client_keys [256]
	Allowed client keys (server).
char	identity_keys [32][256]
	All identity keys (populated when –key is used multiple times).
size_t	num_identity_keys
	Number of identity keys loaded (0 means single-key mode using encrypt_key).
bool	require_server_identity
	ACDS: require servers to provide signed Ed25519 identity.
bool	require_client_identity
	ACDS: require clients to provide signed Ed25519 identity.
bool	require_server_verify
	Server: only accept clients who verified via ACDS.
bool	require_client_verify
	Client: only connect to servers whose identity was verified by ACDS.
bool	discovery_expose_ip
	ACDS: explicitly allow public IP disclosure without verification (opt-in).
bool	discovery_insecure
	ACDS: skip server key verification (MITM-vulnerable, requires explicit opt-in).
bool	prefer_webrtc
	–prefer-webrtc: Try WebRTC before Direct TCP
bool	no_webrtc
	–no-webrtc: Disable WebRTC, use Direct TCP only
char	webrtc_bind_address [256]
	Optional numeric local address for WebRTC ICE sockets.
bool	webrtc_skip_stun
	–webrtc-skip-stun: Skip Stage 2 (STUN), go to TURN
bool	webrtc_relay_only
	–webrtc-relay-only: Require TURN relay candidates
bool	webrtc_disable_turn
	–webrtc-disable-turn: Disable Stage 3 (TURN), use STUN only
bool	webrtc_skip_host
	–webrtc-skip-host: Skip host candidates, force STUN/TURN only
int	webrtc_ice_timeout_ms
	–webrtc-ice-timeout: ICE gathering timeout in milliseconds (default: 10000)
int	webrtc_reconnect_attempts
	–webrtc-reconnect-attempts: Number of retry attempts (default: 3)
bool	enable_upnp
	Opt-in TCP/WebSocket and WebRTC UDP mapping via –port-forwarding.
char	stun_servers [256]
	ACDS: Comma-separated list of STUN server URLs.
char	turn_servers [256]
	ACDS: Comma-separated list of TURN server URLs.
char	turn_username [256]
	ACDS: Username for TURN authentication.
char	turn_credential [256]
	ACDS: Credential/password for TURN authentication.
char	turn_secret [256]
	ACDS: Shared secret for dynamic TURN credential generation (HMAC-SHA1).
palette_type_t	palette_type
	Selected palette type.
char	palette_custom [256]
	Custom palette characters.
bool	palette_custom_set
	True if custom palette was set.
bool	palette_explicit
	Palette explicitly selected.
bool	splash_screen
	Show splash screen (default: true = show, use –no-splash-screen to hide).
bool	splash_screen_explicitly_set
	True if splash screen was explicitly set by user.
bool	status_screen
	Show status screen (default: true = show, use –no-status-screen to hide).
bool	status_screen_explicitly_set
	True if status_screen was explicitly set by user.
bool	no_check_update
	Disable automatic update checks (default: false = checks enabled).
double	debug_errno_stacks_time
	Delay before the error report.
bool	debug_errno_stacks_time_explicit
	True if –errno-stacks was provided.
double	debug_sync_state_time
	Time parameter for –sync-state.
bool	debug_sync_state_time_explicit
	True if –sync-state was explicitly provided.
double	debug_backtrace_time
	Time parameter for –backtrace option.
bool	debug_backtrace_time_explicit
	True if –backtrace was explicitly provided.
double	debug_memory_report_interval
	Interval in seconds for periodic memory reports.
bool	debug_memory_report_interval_explicit
	True if –memory-report was explicitly provided.
char	render_file [256]
	Output file path (e.g. output.mp4).
bool	render_kitty
	Display a snapshot with Kitty graphics.
int	render_theme
	0=dark 1=light 2=auto
char	render_font [256]
	Font family name or .ttf path (empty = platform default).
double	render_font_size
	Font size in points (0 selects an automatic size).

Detailed Description

Immutable, RCU-published snapshot of the application's runtime configuration.

The fields cover mode selection, terminal and media rendering, audio, network and discovery endpoints, authentication and encryption policy, logging, and the explicit-value markers used while merging defaults. Readers borrow the current snapshot through options_get(); updates allocate and publish a replacement instead of mutating a snapshot that another thread may still be using.

Definition at line 979 of file options.h.

Field Documentation

◆ address

char options_state::address[256]

Server address (client) or bind address (server).

Definition at line 1007 of file options.h.

Referenced by ascii_otel_init(), client_main(), and options_t_new().

◆ address6

char options_state::address6[256]

IPv6 bind address (server only).

Definition at line 1008 of file options.h.

Referenced by ascii_otel_init(), and options_t_new().

◆ address_explicit

bool options_state::address_explicit

Native client destination overrides automatic LAN discovery.

Definition at line 1005 of file options.h.

◆ audio_adaptive_eq

bool options_state::audio_adaptive_eq

Definition at line 1118 of file options.h.

Referenced by client_audio_pipeline_config_for_source().

◆ audio_analysis_enabled

bool options_state::audio_analysis_enabled

Enable audio analysis (debug).

Definition at line 1132 of file options.h.

Data Fields

Detailed Description

Field Documentation

◆ address

◆ address6

◆ address_explicit

◆ audio_adaptive_eq

◆ audio_analysis_enabled

◆ audio_capture_source

◆ audio_enabled

◆ audio_fft_size

◆ audio_multiband

◆ audio_no_playback

◆ audio_pitch_correct

◆ audio_source

◆ audio_spectral

◆ audio_spectral_agc

◆ audio_spectral_gate

◆ audio_spectral_mixer

◆ auto_height

◆ auto_width

◆ client_keys

◆ color

◆ color_filter

◆ color_mode

◆ color_scheme_name

◆ compression_level

◆ config_file

◆ debug_backtrace_time

◆ debug_backtrace_time_explicit

◆ debug_errno_stacks_time

◆ debug_errno_stacks_time_explicit

◆ debug_memory_report_interval

◆ debug_memory_report_interval_explicit

◆ debug_sync_state_time

◆ debug_sync_state_time_explicit

◆ detected_mode

◆ disable_keepawake

◆ discovery

◆ discovery_database_path

◆ discovery_expose_ip

◆ discovery_insecure

◆ discovery_port

◆ discovery_quic

◆ discovery_server

◆ discovery_service_key

◆ discovery_service_url

◆ enable_keepawake

◆ enable_upnp

◆ encode_audio

◆ encrypt_enabled

◆ encrypt_key

◆ encrypt_keyfile

◆ face_follow

◆ face_follow_debug

◆ fft

◆ fft_scale

◆ flip_x

◆ flip_x_explicit

◆ flip_y

◆ force_utf8

◆ fps

◆ fps_counter

◆ fps_explicitly_set

◆ grep_pattern

◆ height

◆ help

◆ http_origin

◆ identity_keys

◆ json

◆ lan_discovery

◆ log_file

◆ log_format_console_only

◆ log_level

◆ log_template

◆ matrix_rain

◆ max_clients

◆ mcp_downloads_dir

◆ mcp_downloads_url_prefix

◆ mcp_server_restricted