include/ascii-chat/options/options.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stdio.h>
#include "../platform/terminal.h"
#include <ascii-chat/video/ascii/palette.h>
#include "../discovery/strings.h"
#include "explicit.h"
 
#define COLOR_MODE_AUTO TERM_COLOR_AUTO           
#define COLOR_MODE_NONE TERM_COLOR_NONE           
#define COLOR_MODE_16 TERM_COLOR_16               
#define COLOR_MODE_16_COLOR TERM_COLOR_16         
#define COLOR_MODE_256 TERM_COLOR_256             
#define COLOR_MODE_256_COLOR TERM_COLOR_256       
#define COLOR_MODE_TRUECOLOR TERM_COLOR_TRUECOLOR 
 
typedef enum {
  COLOR_SETTING_AUTO = 0,
  COLOR_SETTING_TRUE = 1,
  COLOR_SETTING_FALSE = -1
} color_setting_t;
 
typedef enum {
  UTF8_SETTING_AUTO = 0,
  UTF8_SETTING_TRUE = 1,
  UTF8_SETTING_FALSE = -1
} utf8_setting_t;
 
typedef enum {
  AUDIO_SOURCE_ALL = 0,
  AUDIO_SOURCE_CALL = 1,
  AUDIO_SOURCE_MIC = 2,
  AUDIO_SOURCE_MEDIA = 3,
  AUDIO_SOURCE_AUTO = AUDIO_SOURCE_ALL
} audio_source_t;
 
typedef enum {
  AUDIO_CAPTURE_SOURCE_AUTO = 0,
  AUDIO_CAPTURE_SOURCE_MIC = 1,
  AUDIO_CAPTURE_SOURCE_MEDIA = 2,
  AUDIO_CAPTURE_SOURCE_BOTH = 3,
  AUDIO_CAPTURE_SOURCE_REMOTE = 4
} audio_capture_source_t;
 
#define OPTIONS_BUFF_SIZE 256
 
#define MAX_IDENTITY_KEYS 32
 
// ============================================================================
// GENERAL CATEGORY - General-purpose options (from --help registry)
// ============================================================================
 
#define OPT_HELP_DEFAULT false
 
#define OPT_VERSION_DEFAULT false
 
#define OPT_SPLASH_DEFAULT true
 
#define OPT_SPLASH_SCREEN_EXPLICITLY_SET_DEFAULT false
 
#define OPT_STATUS_SCREEN_DEFAULT true
 
#define OPT_STATUS_SCREEN_EXPLICITLY_SET_DEFAULT false
 
#define OPT_ENABLE_KEEPAWAKE_DEFAULT false
 
#define OPT_DISABLE_KEEPAWAKE_DEFAULT false
 
#define OPT_NO_CHECK_UPDATE_DEFAULT false
 
// ============================================================================
// LOGGING CATEGORY - Binary-level logging and output control options
// ============================================================================
 
#define OPT_QUIET_DEFAULT false
 
#define OPT_VERBOSE_LEVEL_DEFAULT 0
 
#define OPT_LOG_LEVEL_DEFAULT LOG_INFO
 
#define OPT_GREP_PATTERN_DEFAULT ""
 
#define OPT_JSON_DEFAULT false
 
#define OPT_COLOR_SCHEME_NAME_DEFAULT "pastel"
 
#define OPT_LOG_TEMPLATE_DEFAULT_RELEASE                                                                               \
  "[%color(*, %H):%color(*, %M):%color(*, %S).%color(*, %ms)] [%color(*, %level_aligned)] "                            \
  "%colored_message"
 
#define OPT_LOG_TEMPLATE_DEFAULT_DEBUG                                                                                 \
  "[%color(*, %H):%color(*, %M):%color(*, %S).%color(*, %ms)] [%color(*, %level_aligned)] "                            \
  "[thread/%color(GREY, %tname)] %color(DEBUG, %file_relative):%color(GREY, %line)@%color(DEV, %func)(): "             \
  "%colored_message"
 
#ifdef NDEBUG
#define OPT_LOG_TEMPLATE_DEFAULT OPT_LOG_TEMPLATE_DEFAULT_RELEASE
#else
#define OPT_LOG_TEMPLATE_DEFAULT OPT_LOG_TEMPLATE_DEFAULT_DEBUG
#endif
 
#define OPT_LOG_FORMAT_OUTPUT_DEFAULT LOG_OUTPUT_TEXT
 
#define OPT_LOG_FORMAT_CONSOLE_DEFAULT false
 
// ============================================================================
// TERMINAL CATEGORY - Terminal display options
// ============================================================================
 
#define OPT_WIDTH_DEFAULT 110
 
#define OPT_HEIGHT_DEFAULT 70
 
#define OPT_AUTO_WIDTH_DEFAULT true
 
#define OPT_AUTO_HEIGHT_DEFAULT true
 
#define OPT_COLOR_MODE_DEFAULT COLOR_MODE_AUTO
 
#define OPT_LIST_WEBCAMS_DEFAULT false
 
#define OPT_LIST_MICROPHONES_DEFAULT false
 
#define OPT_LIST_SPEAKERS_DEFAULT false
 
#define OPT_SHOW_CAPABILITIES_DEFAULT false
 
#define OPT_FORCE_UTF8_DEFAULT UTF8_SETTING_AUTO
 
#define OPT_STRIP_ANSI_DEFAULT false
 
#define OPT_COLOR_DEFAULT COLOR_SETTING_AUTO
 
// ============================================================================
// DISPLAY CATEGORY - Display and rendering options
// ============================================================================
 
#define OPT_COLOR_FILTER_DEFAULT COLOR_FILTER_NONE
 
#define OPT_RENDER_MODE_DEFAULT RENDER_MODE_FOREGROUND
 
#define OPT_PALETTE_TYPE_DEFAULT PALETTE_STANDARD
 
#define OPT_PALETTE_CUSTOM_SET_DEFAULT false
 
#define OPT_STRETCH_DEFAULT false
 
#define OPT_FPS_DEFAULT 60
 
#define OPT_SNAPSHOT_MODE_DEFAULT false
 
#if defined(__APPLE__)
#define OPT_SNAPSHOT_DELAY_DEFAULT 4.0f
#else
#define OPT_SNAPSHOT_DELAY_DEFAULT 3.0f
#endif
 
#define OPT_MATRIX_RAIN_DEFAULT false
 
#define OPT_FPS_COUNTER_DEFAULT false
 
#ifdef __APPLE__
#define OPT_FLIP_X_DEFAULT true
#else
#define OPT_FLIP_X_DEFAULT false
#endif
 
#define OPT_FLIP_Y_DEFAULT false
 
// ============================================================================
// WEBCAM CATEGORY - Webcam and capture device options
// ============================================================================
 
#define OPT_WEBCAM_INDEX_DEFAULT 0
 
#define OPT_TEST_PATTERN_DEFAULT false
 
#define OPT_NO_AUDIO_MIXER_DEFAULT false
 
// ============================================================================
// MEDIA CATEGORY - Media file streaming and playback options
// ============================================================================
 
#define OPT_MEDIA_LOOP_DEFAULT false
 
#define OPT_MEDIA_FROM_STDIN_DEFAULT false
 
#define OPT_MEDIA_SEEK_TIMESTAMP_DEFAULT 0.0
 
#define OPT_PAUSE_DEFAULT false
 
// ============================================================================
// NETWORK CATEGORY - Network connectivity and protocol options
// ============================================================================
 
#define OPT_ADDRESS_DEFAULT "localhost"
 
#define OPT_ADDRESS6_DEFAULT "::1"
 
#ifdef NDEBUG
#include "../network/acip/acds.h"
#define OPT_ENDPOINT_DISCOVERY_SERVICE ACDS_OFFICIAL_SERVER_HOSTNAME
#else
#define OPT_ENDPOINT_DISCOVERY_SERVICE "localhost"
#endif
 
#define OPT_PORT_DEFAULT "27224"
 
#define OPT_PORT_INT_DEFAULT 27224
 
#define OPT_WEBSOCKET_PORT_SERVER_DEFAULT 27226
 
#define OPT_WEBSOCKET_PORT_ACDS_DEFAULT 27227
 
#define OPT_MAX_CLIENTS_DEFAULT 9
 
#define OPT_RECONNECT_ATTEMPTS_DEFAULT (-1)
 
#define OPT_COMPRESSION_LEVEL_DEFAULT 3
 
#define OPT_NO_COMPRESS_DEFAULT false
 
#define OPT_ACDS_DEFAULT false
 
#define OPT_ACDS_PORT_INT_DEFAULT 27225
 
#define OPT_ACDS_PORT_DEFAULT "27225"
 
#define OPT_ACDS_EXPOSE_IP_DEFAULT false
 
#define OPT_ACDS_INSECURE_DEFAULT false
 
#define OPT_REQUIRE_SERVER_IDENTITY_DEFAULT false
 
#define OPT_REQUIRE_CLIENT_IDENTITY_DEFAULT false
 
#define OPT_LAN_DISCOVERY_DEFAULT false
 
#define OPT_NO_MDNS_ADVERTISE_DEFAULT false
 
#define OPT_ENABLE_UPNP_DEFAULT false
 
#define OPT_ENDPOINT_STUN_PRIMARY "stun:stun.ascii-chat.com:3478"
 
#define OPT_ENDPOINT_STUN_FALLBACK "stun:stun.l.google.com:19302"
 
#define OPT_ENDPOINT_STUN_SERVERS_DEFAULT OPT_ENDPOINT_STUN_PRIMARY "," OPT_ENDPOINT_STUN_FALLBACK
 
#define OPT_ENDPOINT_TURN_PRIMARY "turn:turn.ascii-chat.com:3478"
 
#define OPT_ENDPOINT_TURN_SERVERS_DEFAULT OPT_ENDPOINT_TURN_PRIMARY
 
#define OPT_STUN_SERVER_HOST_PRIMARY "stun.ascii-chat.com"
 
#define OPT_STUN_SERVER_PORT_PRIMARY 3478
 
#define OPT_STUN_SERVER_HOST_FALLBACK "stun.l.google.com"
 
#define OPT_STUN_SERVER_PORT_FALLBACK 19302
 
#define OPT_TURN_SERVER_HOST "turn.ascii-chat.com"
 
#define OPT_TURN_SERVER_PORT 3478
 
#define OPT_STUN_SERVERS_DEFAULT OPT_ENDPOINT_STUN_SERVERS_DEFAULT
 
#define OPT_TURN_SERVERS_DEFAULT OPT_ENDPOINT_TURN_SERVERS_DEFAULT
 
#define OPT_WEBRTC_DEFAULT true
 
#define OPT_PREFER_WEBRTC_DEFAULT false
 
#define OPT_NO_WEBRTC_DEFAULT false
 
#define OPT_WEBRTC_SKIP_STUN_DEFAULT false
 
#define OPT_WEBRTC_DISABLE_TURN_DEFAULT false
 
#define OPT_WEBRTC_SKIP_HOST_DEFAULT false
 
#define OPT_WEBRTC_ICE_TIMEOUT_MS_DEFAULT 10000
 
#define OPT_WEBRTC_RECONNECT_ATTEMPTS_DEFAULT 3
 
#define OPT_TURN_USERNAME_DEFAULT ""
 
#define OPT_TURN_CREDENTIAL_DEFAULT ""
 
// ============================================================================
// AUDIO CATEGORY - Audio capture, playback and processing options
// ============================================================================
 
#define OPT_AUDIO_ENABLED_DEFAULT true
 
#define OPT_AUDIO_SOURCE_DEFAULT AUDIO_SOURCE_ALL
#define OPT_AUDIO_CAPTURE_SOURCE_DEFAULT AUDIO_CAPTURE_SOURCE_AUTO
 
#define OPT_MICROPHONE_INDEX_DEFAULT (-1)
 
#define OPT_SPEAKERS_INDEX_DEFAULT (-1)
 
#define OPT_MICROPHONE_SENSITIVITY_DEFAULT 1.0
 
#define OPT_SPEAKERS_VOLUME_DEFAULT 1.0
 
#define OPT_AUDIO_ANALYSIS_ENABLED_DEFAULT false
 
#define OPT_AUDIO_NO_PLAYBACK_DEFAULT false
 
#define OPT_ENCODE_AUDIO_DEFAULT true
 
// ============================================================================
// SECURITY CATEGORY - Encryption and authentication options
// ============================================================================
 
#define OPT_ENCRYPT_ENABLED_DEFAULT true
 
#define OPT_NO_ENCRYPT_DEFAULT false
 
#define OPT_NO_AUTH_DEFAULT false
 
#define OPT_REQUIRE_SERVER_VERIFY_DEFAULT false
 
#define OPT_REQUIRE_CLIENT_VERIFY_DEFAULT false
 
// ============================================================================
// CONFIGURATION CATEGORY - Application configuration options
// ============================================================================
 
// (Configuration options are typically handled separately via --config etc.)
 
// ============================================================================
// DATABASE CATEGORY - Database and persistent storage options
// ============================================================================
 
// (Database options are typically handled separately via --database etc.)
 
// ============================================================================
// String Default Values
// ============================================================================
 
#define OPT_STRING_EMPTY_DEFAULT ""
 
// ============================================================================
// Render-to-file Options
// ============================================================================
#define OPT_RENDER_FILE_DEFAULT ""
#define OPT_RENDER_THEME_DEFAULT 0 // 0=dark, 1=light, 2=auto
#define OPT_RENDER_FONT_DEFAULT ""
#define OPT_RENDER_FONT_SIZE_DEFAULT 12.0
 
// ============================================================================
// Static Default Value Variables
// ============================================================================
// These are referenced from the registry and provide const void * pointers
// for non-string default values. Defined alongside OPT_*_DEFAULT for clarity.
 
static const int default_log_level_value = OPT_LOG_LEVEL_DEFAULT;
static const bool default_quiet_value = OPT_QUIET_DEFAULT;
static const bool default_json_value = OPT_JSON_DEFAULT;
static const bool default_enable_keepawake_value = OPT_ENABLE_KEEPAWAKE_DEFAULT;
static const bool default_disable_keepawake_value = OPT_DISABLE_KEEPAWAKE_DEFAULT;
static const int default_width_value = OPT_WIDTH_DEFAULT;
static const int default_height_value = OPT_HEIGHT_DEFAULT;
static const int default_port_value = OPT_PORT_INT_DEFAULT;
static const int default_websocket_port_value = OPT_WEBSOCKET_PORT_SERVER_DEFAULT;
static const int default_webcam_index_value = OPT_WEBCAM_INDEX_DEFAULT;
static const bool default_flip_x_value = OPT_FLIP_X_DEFAULT;
static const bool default_flip_y_value = OPT_FLIP_Y_DEFAULT;
static const bool default_test_pattern_value = OPT_TEST_PATTERN_DEFAULT;
static const int default_color_value = OPT_COLOR_DEFAULT;
static const int default_color_mode_value = OPT_COLOR_MODE_DEFAULT;
static const int default_color_filter_value = OPT_COLOR_FILTER_DEFAULT;
static const int default_render_mode_value = OPT_RENDER_MODE_DEFAULT;
static const int default_palette_type_value = OPT_PALETTE_TYPE_DEFAULT;
static const bool default_show_capabilities_value = OPT_SHOW_CAPABILITIES_DEFAULT;
static const int default_force_utf8_value = OPT_FORCE_UTF8_DEFAULT;
static const bool default_stretch_value = OPT_STRETCH_DEFAULT;
static const bool default_strip_ansi_value = OPT_STRIP_ANSI_DEFAULT;
static const bool default_snapshot_mode_value = OPT_SNAPSHOT_MODE_DEFAULT;
static const double default_snapshot_delay_value = OPT_SNAPSHOT_DELAY_DEFAULT;
static const bool default_matrix_rain_value = OPT_MATRIX_RAIN_DEFAULT;
static const bool default_waveform_value = false;
static const bool default_fft_value = false;
static const bool default_fps_counter_value = OPT_FPS_COUNTER_DEFAULT;
static const int default_fps_value = OPT_FPS_DEFAULT;
static const int default_compression_level_value = OPT_COMPRESSION_LEVEL_DEFAULT;
static const bool default_no_compress_value = OPT_NO_COMPRESS_DEFAULT;
static const bool default_encrypt_enabled_value = OPT_ENCRYPT_ENABLED_DEFAULT;
static const bool default_no_encrypt_value = OPT_NO_ENCRYPT_DEFAULT;
static const bool default_no_auth_value = OPT_NO_AUTH_DEFAULT;
static const int default_max_clients_value = OPT_MAX_CLIENTS_DEFAULT;
static const int default_reconnect_attempts_value = OPT_RECONNECT_ATTEMPTS_DEFAULT;
static const int default_discovery_port_value = OPT_ACDS_PORT_INT_DEFAULT;
static const bool default_discovery_value = OPT_ACDS_DEFAULT;
static const bool default_webrtc_value = OPT_WEBRTC_DEFAULT;
static const bool default_enable_upnp_value = OPT_ENABLE_UPNP_DEFAULT;
static const bool default_lan_discovery_value = OPT_LAN_DISCOVERY_DEFAULT;
static const bool default_prefer_webrtc_value = OPT_PREFER_WEBRTC_DEFAULT;
static const bool default_no_webrtc_value = OPT_NO_WEBRTC_DEFAULT;
static const bool default_webrtc_skip_stun_value = OPT_WEBRTC_SKIP_STUN_DEFAULT;
static const bool default_webrtc_relay_only_value = false;
static const bool default_webrtc_disable_turn_value = OPT_WEBRTC_DISABLE_TURN_DEFAULT;
static const bool default_webrtc_skip_host_value = OPT_WEBRTC_SKIP_HOST_DEFAULT;
 
static const int default_webrtc_ice_timeout_ms_value = OPT_WEBRTC_ICE_TIMEOUT_MS_DEFAULT;
 
static const int default_webrtc_reconnect_attempts_value = OPT_WEBRTC_RECONNECT_ATTEMPTS_DEFAULT;
static const bool default_media_loop_value = OPT_MEDIA_LOOP_DEFAULT;
static const bool default_pause_value = OPT_PAUSE_DEFAULT;
static const double default_media_seek_value = OPT_MEDIA_SEEK_TIMESTAMP_DEFAULT;
static const bool default_audio_enabled_value = OPT_AUDIO_ENABLED_DEFAULT;
static const audio_source_t default_audio_source_value = OPT_AUDIO_SOURCE_DEFAULT;
static const audio_capture_source_t default_audio_capture_source_value = OPT_AUDIO_CAPTURE_SOURCE_DEFAULT;
static const int default_microphone_index_value = OPT_MICROPHONE_INDEX_DEFAULT;
static const int default_speakers_index_value = OPT_SPEAKERS_INDEX_DEFAULT;
static const double default_microphone_sensitivity_value = OPT_MICROPHONE_SENSITIVITY_DEFAULT;
static const double default_speakers_volume_value = OPT_SPEAKERS_VOLUME_DEFAULT;
static const bool default_audio_analysis_value = OPT_AUDIO_ANALYSIS_ENABLED_DEFAULT;
static const bool default_no_audio_playback_value = OPT_AUDIO_NO_PLAYBACK_DEFAULT;
static const bool default_encode_audio_value = OPT_ENCODE_AUDIO_DEFAULT;
static const bool default_no_encode_audio_value = !OPT_ENCODE_AUDIO_DEFAULT;
static const bool default_no_audio_mixer_value = OPT_NO_AUDIO_MIXER_DEFAULT;
static const bool default_discovery_expose_ip_value = OPT_ACDS_EXPOSE_IP_DEFAULT;
static const bool default_discovery_insecure_value = OPT_ACDS_INSECURE_DEFAULT;
static const bool default_require_server_identity_value = OPT_REQUIRE_SERVER_IDENTITY_DEFAULT;
static const bool default_require_client_identity_value = OPT_REQUIRE_CLIENT_IDENTITY_DEFAULT;
static const bool default_splash_value = OPT_SPLASH_DEFAULT;
static const bool default_splash_false = false; // For --no-splash-screen option
static const bool default_status_screen_value = OPT_STATUS_SCREEN_DEFAULT;
static const bool default_no_check_update_value = OPT_NO_CHECK_UPDATE_DEFAULT;
static const bool default_log_format_console_only_value = OPT_LOG_FORMAT_CONSOLE_DEFAULT;
 
#ifndef NDEBUG
static const double default_debug_sync_state_time_value = 0.0;
static const bool default_debug_sync_state_time_explicit_value = false;
static const double default_debug_backtrace_time_value = 0.0;
static const bool default_debug_backtrace_time_explicit_value = false;
static const double default_debug_memory_report_interval_value = 0.0;
static const bool default_debug_memory_report_interval_explicit_value = false;
#endif
 
static const int default_render_theme_value = OPT_RENDER_THEME_DEFAULT;
static const double default_render_font_size_value = OPT_RENDER_FONT_SIZE_DEFAULT;
 
int strtoint_safe(const char *str);
 
typedef enum {
  MODE_SERVER,            
  MODE_CLIENT,            
  MODE_MIRROR,            
  MODE_DISCOVERY_SERVICE, 
  MODE_DISCOVERY,         
  MODE_INVALID            
} asciichat_mode_t;
 
typedef enum {
  OPTION_MODE_NONE = 0,                                      
  OPTION_MODE_SERVER = (1 << MODE_SERVER),                   
  OPTION_MODE_CLIENT = (1 << MODE_CLIENT),                   
  OPTION_MODE_MIRROR = (1 << MODE_MIRROR),                   
  OPTION_MODE_DISCOVERY_SVC = (1 << MODE_DISCOVERY_SERVICE), 
  OPTION_MODE_DISCOVERY = (1 << MODE_DISCOVERY),             
  OPTION_MODE_BINARY = 0x100,                                
  OPTION_MODE_ALL = 0x1F | 0x100                             
} option_mode_bitmask_t;
 
#define OPTION_MODE_SERVER_LIKE (OPTION_MODE_SERVER | OPTION_MODE_DISCOVERY_SVC)
#define OPTION_MODE_CLIENT_LIKE (OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY)
#define OPTION_MODE_NETWORKED                                                                                          \
  (OPTION_MODE_SERVER | OPTION_MODE_CLIENT | OPTION_MODE_DISCOVERY_SVC | OPTION_MODE_DISCOVERY)
 
typedef struct options_state {
  // ============================================================================
  // Mode Detection (auto-detected during options_init)
  // ============================================================================
  asciichat_mode_t detected_mode; 
 
  // ============================================================================
  // Binary-Level Options (parsed first, before mode selection)
  // ============================================================================
  bool help;                           
  bool version;                        
  char config_file[OPTIONS_BUFF_SIZE]; 
 
  // ============================================================================
  // Terminal Dimensions
  // ============================================================================
  int width;        
  int height;       
  bool auto_width;  
  bool auto_height; 
 
  // ============================================================================
  // Network Options
  // ============================================================================
  char address[OPTIONS_BUFF_SIZE];            
  char address6[OPTIONS_BUFF_SIZE];           
  int port;                                   
  int websocket_port;                         
  char websocket_tls_cert[OPTIONS_BUFF_SIZE]; 
  char websocket_tls_key[OPTIONS_BUFF_SIZE];  
  char websocket_tls_key_password[OPTIONS_BUFF_SIZE]; 
  int max_clients;                                    
  char session_string[SESSION_STRING_BUFFER_SIZE]; 
 
  // ============================================================================
  // Discovery Service Options (server only)
  // ============================================================================
  bool discovery;                                
  char discovery_server[OPTIONS_BUFF_SIZE];      
  int discovery_port;                            
  char discovery_service_url[OPTIONS_BUFF_SIZE]; 
  char discovery_service_key[OPTIONS_BUFF_SIZE]; 
  bool webrtc; 
  char discovery_database_path[OPTIONS_BUFF_SIZE]; 
 
  // ============================================================================
  // LAN Discovery Options
  // ============================================================================
  bool lan_discovery;     
  bool no_mdns_advertise; 
 
  // ============================================================================
  // Network Performance Options
  // ============================================================================
  int compression_level; 
  bool no_compress;      
  bool encode_audio;     
 
  // ============================================================================
  // Client Reconnection Options
  // ============================================================================
  int reconnect_attempts; 
 
  // ============================================================================
  // Webcam Options
  // ============================================================================
  int webcam_index;    
  bool test_pattern;   
  bool no_audio_mixer; 
 
  // ============================================================================
  // Media File Streaming Options
  // ============================================================================
  char media_file[OPTIONS_BUFF_SIZE]; 
  char media_url[OPTIONS_BUFF_SIZE];  
  bool media_loop;                    
  bool media_from_stdin;              
  double media_seek_timestamp;        
  bool pause;                         
  char yt_dlp_options[512];           
 
  // ============================================================================
  // Display Options
  // ============================================================================
  int color;                        
  terminal_color_mode_t color_mode; 
  color_filter_t color_filter;      
  char color_scheme_name[64];       
  render_mode_t render_mode;        
  bool show_capabilities;           
  int force_utf8;                   
  int fps;                          
  bool fps_explicitly_set;          
  bool flip_x;                      
  bool flip_y;                      
 
  // ============================================================================
  // Audio Configuration
  // ============================================================================
  bool audio_enabled;           
  audio_source_t audio_source;  
  audio_capture_source_t audio_capture_source; 
  bool waveform; 
  bool fft;      
  int microphone_index;         
  int speakers_index;           
  float microphone_sensitivity; 
  float speakers_volume;        
  bool audio_analysis_enabled;  
  bool audio_no_playback;       
 
  // ============================================================================
  // Image Options
  // ============================================================================
  bool stretch;         
  char video_codec[64]; 
 
  // ============================================================================
  // Output Options
  // ============================================================================
  bool quiet;                           
  unsigned short int verbose_level;     
  bool snapshot_mode;                   
  double snapshot_delay;                
  bool matrix_rain;                     
  bool fps_counter;                     
  bool strip_ansi;                      
  char log_file[OPTIONS_BUFF_SIZE];     
  log_level_t log_level;                
  char grep_pattern[OPTIONS_BUFF_SIZE]; 
  bool json;                            
  char log_template[OPTIONS_BUFF_SIZE]; 
  bool log_format_console_only;         
  bool enable_keepawake;                
  bool disable_keepawake;               
 
  // ============================================================================
  // Encryption Options
  // ============================================================================
  bool encrypt_enabled;                    
  char encrypt_key[OPTIONS_BUFF_SIZE];     
  char password[OPTIONS_BUFF_SIZE];        
  char encrypt_keyfile[OPTIONS_BUFF_SIZE]; 
  bool no_encrypt;                         
  bool no_auth;                            
  char server_key[OPTIONS_BUFF_SIZE];      
  char client_keys[OPTIONS_BUFF_SIZE];     
 
  // Multi-key support: When multiple --key flags are provided, all keys are stored here
  // encrypt_key is duplicated in identity_keys[0] for backward compatibility
  char identity_keys[MAX_IDENTITY_KEYS]
                    [OPTIONS_BUFF_SIZE]; 
  size_t num_identity_keys;              
 
  // ============================================================================
  // Identity Verification Options (ACDS + Crypto Handshake)
  // ============================================================================
  bool require_server_identity; 
  bool require_client_identity; 
  bool require_server_verify;   
  bool require_client_verify;   
  bool discovery_expose_ip;     
  bool discovery_insecure;      
 
  // ============================================================================
  // WebRTC Connection Strategy Options (client-side fallback control)
  // ============================================================================
  bool prefer_webrtc;            
  bool no_webrtc;                
  bool webrtc_skip_stun;         
  bool webrtc_relay_only;        
  bool webrtc_disable_turn;      
  bool webrtc_skip_host;         
  int webrtc_ice_timeout_ms;     
  int webrtc_reconnect_attempts; 
 
  // ============================================================================
  // WebRTC Connectivity Options (ACDS mode only)
  // ============================================================================
  bool enable_upnp;                        
  char stun_servers[OPTIONS_BUFF_SIZE];    
  char turn_servers[OPTIONS_BUFF_SIZE];    
  char turn_username[OPTIONS_BUFF_SIZE];   
  char turn_credential[OPTIONS_BUFF_SIZE]; 
  char turn_secret[OPTIONS_BUFF_SIZE];     
 
  // ============================================================================
  // Palette Configuration
  // ============================================================================
  palette_type_t palette_type; 
  char palette_custom[256];    
  bool palette_custom_set;     
 
  // ============================================================================
  // Splash Screen Options
  // ============================================================================
  bool splash_screen;                
  bool splash_screen_explicitly_set; 
  bool status_screen;                
  bool status_screen_explicitly_set; 
  bool no_check_update;              
 
  // ============================================================================
  // Debug Options (Debug builds only)
  // ============================================================================
#ifndef NDEBUG
  double debug_sync_state_time;               
  bool debug_sync_state_time_explicit;        
  double debug_backtrace_time;                
  bool debug_backtrace_time_explicit;         
  double debug_memory_report_interval;        
  bool debug_memory_report_interval_explicit; 
#endif
 
  // ============================================================================
  // Render-to-file options
  // ============================================================================
  char render_file[OPTIONS_BUFF_SIZE]; 
  int render_theme;                    
  char render_font[OPTIONS_BUFF_SIZE]; 
  double render_font_size;             
 
  // Note: Luminance weights (weight_red, weight_green, weight_blue) and
  // lookup tables (RED[], GREEN[], BLUE[], GRAY[]) are kept as globals
  // since they're precomputed constants, not user-configurable options.
} options_t;
 
// ============================================================================
// RCU-based thread-safe options access
// ============================================================================
 
const options_t *options_get(void);
 
#define GET_OPTION(field)                                                                                              \
  ({                                                                                                                   \
    const options_t *_opts = options_get();                                                                            \
    if (!_opts) {                                                                                                      \
      log_warn("GET_OPTION(" #field ") called but options not initialized");                                           \
    }                                                                                                                  \
    static typeof(((options_t *)0)->field) _default = {0};                                                             \
    (_opts ? (_opts->field) : _default);                                                                               \
  })
 
asciichat_error_t options_set_int(const char *field_name, int value);
asciichat_error_t options_set_bool(const char *field_name, bool value);
asciichat_error_t options_set_string(const char *field_name, const char *value);
asciichat_error_t options_set_double(const char *field_name, double value);
 
const char *options_get_help_text(asciichat_mode_t mode, const char *option_name);
 
extern const float weight_red;
 
extern const float weight_green;
 
extern const float weight_blue;
 
extern unsigned short int RED[];
 
extern unsigned short int GREEN[];
 
extern unsigned short int BLUE[];
 
extern unsigned short int GRAY[];
 
bool has_action_flag(void);
 
options_t options_t_new(void);
 
asciichat_error_t options_init(int argc, char **argv);
 
void usage(FILE *stream, asciichat_mode_t mode);
 
void update_dimensions_to_terminal_size(options_t *opts);
 
void update_dimensions_for_full_height(options_t *opts);
 
extern bool g_snapshot_first_frame_rendered;
extern uint64_t g_snapshot_first_frame_rendered_ns; // Timestamp when first frame was rendered (nanoseconds)
extern uint64_t g_snapshot_first_capture_ns;        // Timestamp when first frame was captured (nanoseconds)
extern uint64_t g_snapshot_actual_duration_ms;      // Actual wall-clock duration in ms when snapshot timeout reached