ascii-chat/options_8h_source.html

#pragma once


#include <ascii-chat/video/anim/fft.h>


/* Storage capacities in elements; text buffers include the terminating NUL. */

#define OPTIONS_YT_DLP_OPTIONS_BUFFER_SIZE 512

#define OPTIONS_COLOR_SCHEME_NAME_BUFFER_SIZE 64

#define OPTIONS_VIDEO_CODEC_BUFFER_SIZE 64

#define OPTIONS_PALETTE_CUSTOM_BUFFER_SIZE 256


#include <stdbool.h>

#include <ascii-chat/media/playlist.h>

#include <stdio.h>

#include <libplatform/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


// ============================================================================

// 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


#ifdef CMAKE_BUILD_TYPE_DEBUG

#define OPT_OTEL_ENDPOINT_DEFAULT "http://127.0.0.1:24318"

#else

#define OPT_OTEL_ENDPOINT_DEFAULT ""

#endif


#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 0


#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


#define OPT_FLIP_X_DEFAULT true


#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_MCP_PORT_DEFAULT 27228


#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 false


#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 0.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 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;


static const double default_debug_errno_stacks_time_value = 0.0;

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;


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_MCP_SERVER,

  MODE_API_SERVER,

  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_MCP_SERVER = (1 << MODE_MCP_SERVER),

  OPTION_MODE_API_SERVER = (1 << MODE_API_SERVER),

  OPTION_MODE_BINARY = 0x100,

  OPTION_MODE_ALL = 0x7F | 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 enum { ASCII_RENDERER_LUMINANCE = 0, ASCII_RENDERER_GLYPH = 1 } ascii_renderer_t;

#define ASCII_RENDERER_DEFAULT ASCII_RENDERER_GLYPH


typedef struct options_state {

  // ============================================================================

  // Mode Detection (auto-detected during options_init)

  // ============================================================================

  asciichat_mode_t detected_mode;

  int mode_arg_index;


  // ============================================================================

  // 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

  // ============================================================================

#ifndef __EMSCRIPTEN__

  bool address_explicit;

#endif

  char address[OPTIONS_BUFF_SIZE];

  char address6[OPTIONS_BUFF_SIZE];

  int port;

  int websocket_port;

  char tls_cert[OPTIONS_BUFF_SIZE];

  char tls_key[OPTIONS_BUFF_SIZE];

  char tls_key_password[OPTIONS_BUFF_SIZE];

  char webtransport_bind_address[OPTIONS_BUFF_SIZE];

  char webtransport_origin[OPTIONS_BUFF_SIZE];

  char webtransport_path[OPTIONS_BUFF_SIZE];

  char quic_bind_address[OPTIONS_BUFF_SIZE];

  char tls_ca_file[OPTIONS_BUFF_SIZE];

  bool quic_visual_datagrams;

  bool quic_audio_datagrams;

  bool discovery_quic;

  char webtransport_public_url[OPTIONS_BUFF_SIZE];

  int quic_port;

  int quic_fallback_port;

  int max_clients;

  char session_string[SESSION_STRING_BUFFER_SIZE];


  // ============================================================================

  // Discovery Service Options (server only)

  // ============================================================================

  bool discovery;

  char discovery_server[OPTIONS_BUFF_SIZE];

  // MCP HTTP transport

  bool mcp_server_restricted;

  char mcp_downloads_dir[OPTIONS_BUFF_SIZE];

  char mcp_downloads_url_prefix[OPTIONS_BUFF_SIZE];

  char mcp_transport[OPTIONS_BUFF_SIZE];

  char http_origin[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;

  int test_pattern_index;

  bool no_audio_mixer;


  // ============================================================================

  // Media File Streaming Options

  // ============================================================================

  media_playlist_t media_playlist;

  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[OPTIONS_YT_DLP_OPTIONS_BUFFER_SIZE];


  // ============================================================================

  // Display Options

  // ============================================================================

  int color;

  terminal_color_mode_t color_mode;

  color_filter_t color_filter;

  char color_scheme_name[OPTIONS_COLOR_SCHEME_NAME_BUFFER_SIZE];

  terminal_render_mode_t render_mode;

  bool show_capabilities;

  int force_utf8;

  int stats_interval;

  int fps;

  bool fps_explicitly_set;

  bool face_follow;

  bool face_follow_debug;

  bool flip_x;

  bool flip_x_explicit;

  bool media_input;

  bool flip_y;


  // ============================================================================

  // Audio Configuration

  // ============================================================================

  bool audio_pitch_correct;

  bool test_audio;

  bool audio_spectral_agc;

  bool audio_spectral;

  bool audio_spectral_mixer;

  bool audio_spectral_gate;

  bool audio_multiband;

  bool audio_adaptive_eq;

  int audio_fft_size;

  bool audio_enabled;

  audio_source_t audio_source;

  audio_capture_source_t audio_capture_source;

  bool waveform;

  bool fft;

  char fft_scale[32];

  int microphone_channels;

  int microphone_channel;

  int microphone_index;

  int speakers_index;

  float microphone_sensitivity;

  float speakers_volume;

  bool audio_analysis_enabled;

  bool audio_no_playback;


  // ============================================================================

  // Image Options

  // ============================================================================

  bool stabilize;

  bool stabilize_explicit;

  ascii_renderer_t renderer;

  bool stretch;

  char video_codec[OPTIONS_VIDEO_CODEC_BUFFER_SIZE];


  // ============================================================================

  // Output Options

  // ============================================================================

  bool quiet;

  unsigned short int verbose_level;

  bool snapshot_mode;

  double snapshot_delay;

  int zalgo;

  bool matrix_rain;

  bool fps_counter;

  bool strip_ansi;


  // OpenTelemetry export configuration.

  char otel_log_level[OPTIONS_BUFF_SIZE];

  char otel_endpoint[OPTIONS_BUFF_SIZE];

  char otel_ca_file[OPTIONS_BUFF_SIZE];

  char otel_enabled_telemetry[OPTIONS_BUFF_SIZE];

  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[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_SESSION_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;

  char webrtc_bind_address[OPTIONS_BUFF_SIZE];

  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[OPTIONS_PALETTE_CUSTOM_BUFFER_SIZE];

  bool palette_custom_set;

  bool palette_explicit;


  // ============================================================================

  // Splash Screen Options

  // ============================================================================

  bool splash_screen;

  bool splash_screen_explicitly_set;

  bool status_screen;

  bool status_screen_explicitly_set;

  bool no_check_update;


  // ============================================================================

  // Diagnostics options

  // ============================================================================

  double debug_errno_stacks_time;

  bool debug_errno_stacks_time_explicit;

  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;


  // ============================================================================

  // Render-to-file options

  // ============================================================================

  char render_file[OPTIONS_BUFF_SIZE];

#ifndef __EMSCRIPTEN__

  bool render_kitty;

#endif

  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);


const terminal_options_t *options_terminal_settings_ptr(void);


/*

 * Keep terminal settings out of the Windows DLL return-value ABI.  The

 * terminal_options_t record is larger than the register return size, so

 * returning it by value across asciichat.dll/libplatform.dll requires a

 * hidden return-buffer argument.  Expose a stable settings record instead,

 * and pass its address through the platform API.

 */

#define options_terminal_settings() options_terminal_settings_ptr()


#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


void options_resolve_flip_x(options_t *opts);

acds.h
ascii-chat Discovery Service (ACDS) Protocol Message Formats

strings.h

explicit.h
Check if an option was explicitly set via command-line.

fft.h

uint64_t
unsigned long long uint64_t
Definition common.h:63

asciichat_error_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:44

MAX_SESSION_KEYS
#define MAX_SESSION_KEYS
Definition common/limits.h:30

log_level_t
log_level_t
Logging levels enumeration.
Definition types.h:29

utf8_setting_t
utf8_setting_t
UTF-8 support setting (–utf8 flag values).
Definition options.h:262

audio_capture_source_t
audio_capture_source_t
Definition options.h:290

OPT_STRIP_ANSI_DEFAULT
#define OPT_STRIP_ANSI_DEFAULT
Default strip ANSI escape sequences flag.
Definition options.h:451

OPT_WEBRTC_SKIP_STUN_DEFAULT
#define OPT_WEBRTC_SKIP_STUN_DEFAULT
Default WebRTC skip STUN flag (false = use STUN).
Definition options.h:678

OPT_ACDS_EXPOSE_IP_DEFAULT
#define OPT_ACDS_EXPOSE_IP_DEFAULT
Default ACDS expose IP flag (false = private by default).
Definition options.h:600

OPTIONS_PALETTE_CUSTOM_BUFFER_SIZE
#define OPTIONS_PALETTE_CUSTOM_BUFFER_SIZE
Definition options.h:211

GRAY
unsigned short int GRAY[256]
Grayscale lookup table.
Definition options/common.c:392

options_get_help_text
const char * options_get_help_text(asciichat_mode_t mode, const char *option_name)
Get help text for an option in a specific mode.
Definition help_api.c:27

BLUE
unsigned short int BLUE[256]
Blue channel lookup table.
Definition options/common.c:391

OPT_COLOR_DEFAULT
#define OPT_COLOR_DEFAULT
Default color setting (COLOR_SETTING_AUTO = smart detection).
Definition options.h:454

OPT_NO_AUDIO_MIXER_DEFAULT
#define OPT_NO_AUDIO_MIXER_DEFAULT
Default no audio mixer flag (false = enable mixer).
Definition options.h:518

OPT_FLIP_Y_DEFAULT
#define OPT_FLIP_Y_DEFAULT
Default vertical flip state (false = no vertical flip).
Definition options.h:505

OPT_SHOW_CAPABILITIES_DEFAULT
#define OPT_SHOW_CAPABILITIES_DEFAULT
Default show terminal capabilities flag.
Definition options.h:445

OPT_NO_ENCRYPT_DEFAULT
#define OPT_NO_ENCRYPT_DEFAULT
Default no encrypt flag (false = allow encryption).
Definition options.h:739

OPT_QUIET_DEFAULT
#define OPT_QUIET_DEFAULT
Default quiet mode flag (false = logging enabled).
Definition options.h:348

asciichat_mode_t
asciichat_mode_t
Mode type for options parsing.
Definition options.h:919

options_set_int
asciichat_error_t options_set_int(const char *field_name, int value)
Check if an option was explicitly set via command-line.
Definition rcu.c:894

OPT_MICROPHONE_INDEX_DEFAULT
#define OPT_MICROPHONE_INDEX_DEFAULT
Default microphone device index (-1 means system default).
Definition options.h:711

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

OPT_ENCODE_AUDIO_DEFAULT
#define OPT_ENCODE_AUDIO_DEFAULT
Default audio encoding state (true = Opus encoding enabled).
Definition options.h:729

OPT_COLOR_MODE_DEFAULT
#define OPT_COLOR_MODE_DEFAULT
Default color mode (auto-detect terminal capabilities).
Definition options.h:433

OPT_PALETTE_TYPE_DEFAULT
#define OPT_PALETTE_TYPE_DEFAULT
Default palette type (standard ASCII art).
Definition options.h:467

OPT_RECONNECT_ATTEMPTS_DEFAULT
#define OPT_RECONNECT_ATTEMPTS_DEFAULT
Default reconnect attempts (-1 means auto/infinite).
Definition options.h:582

OPT_SPEAKERS_VOLUME_DEFAULT
#define OPT_SPEAKERS_VOLUME_DEFAULT
Default speakers volume (1.0 = normal volume).
Definition options.h:720

strtoint_safe
int strtoint_safe(const char *str)
Safely parse string to integer with validation.
Definition options/common.c:177

update_dimensions_to_terminal_size
void update_dimensions_to_terminal_size(options_t *opts)
Update dimensions to match current terminal size.
Definition options/common.c:650

OPT_NO_AUTH_DEFAULT
#define OPT_NO_AUTH_DEFAULT
Default no auth flag (false = allow authentication).
Definition options.h:742

OPT_WEBRTC_ICE_TIMEOUT_MS_DEFAULT
#define OPT_WEBRTC_ICE_TIMEOUT_MS_DEFAULT
Default WebRTC ICE gathering timeout in milliseconds (10 seconds).
Definition options.h:687

OPT_COMPRESSION_LEVEL_DEFAULT
#define OPT_COMPRESSION_LEVEL_DEFAULT
Default compression level (1-9).
Definition options.h:585

OPT_ENCRYPT_ENABLED_DEFAULT
#define OPT_ENCRYPT_ENABLED_DEFAULT
Default encrypt enabled flag (true = encryption required).
Definition options.h:736

OPT_REQUIRE_SERVER_IDENTITY_DEFAULT
#define OPT_REQUIRE_SERVER_IDENTITY_DEFAULT
Default require-server-identity setting for ACDS.
Definition options.h:606

OPT_ENABLE_KEEPAWAKE_DEFAULT
#define OPT_ENABLE_KEEPAWAKE_DEFAULT
Default keep-awake (prevent system sleep) flag (false = normal system sleep).
Definition options.h:335

OPT_RENDER_MODE_DEFAULT
#define OPT_RENDER_MODE_DEFAULT
Default render mode (foreground characters only).
Definition options.h:464

OPT_ACDS_PORT_INT_DEFAULT
#define OPT_ACDS_PORT_INT_DEFAULT
Default ACDS discovery service port (integer).
Definition options.h:594

OPT_AUDIO_ENABLED_DEFAULT
#define OPT_AUDIO_ENABLED_DEFAULT
Default audio enabled flag (true = audio enabled by default).
Definition options.h:703

OPT_MATRIX_RAIN_DEFAULT
#define OPT_MATRIX_RAIN_DEFAULT
Default Matrix rain effect flag (false = disabled).
Definition options.h:496

OPT_FORCE_UTF8_DEFAULT
#define OPT_FORCE_UTF8_DEFAULT
Default force UTF-8 support setting (auto-detect).
Definition options.h:448

weight_blue
const float weight_blue
Blue weight for luminance calculation.
Definition options/common.c:385

OPTIONS_YT_DLP_OPTIONS_BUFFER_SIZE
#define OPTIONS_YT_DLP_OPTIONS_BUFFER_SIZE
Definition options.h:208

OPTIONS_COLOR_SCHEME_NAME_BUFFER_SIZE
#define OPTIONS_COLOR_SCHEME_NAME_BUFFER_SIZE
Definition options.h:209

OPT_RENDER_FONT_SIZE_DEFAULT
#define OPT_RENDER_FONT_SIZE_DEFAULT
Definition options.h:775

OPT_WEBRTC_RECONNECT_ATTEMPTS_DEFAULT
#define OPT_WEBRTC_RECONNECT_ATTEMPTS_DEFAULT
Default WebRTC reconnection attempts (3 = try initial + 3 retries).
Definition options.h:690

OPT_SPLASH_DEFAULT
#define OPT_SPLASH_DEFAULT
Default splash screen flag (true = show splash, false = hide splash).
Definition options.h:323

OPT_RENDER_THEME_DEFAULT
#define OPT_RENDER_THEME_DEFAULT
Definition options.h:773

OPT_FPS_COUNTER_DEFAULT
#define OPT_FPS_COUNTER_DEFAULT
Default FPS counter overlay flag (false = disabled).
Definition options.h:499

OPT_AUDIO_ANALYSIS_ENABLED_DEFAULT
#define OPT_AUDIO_ANALYSIS_ENABLED_DEFAULT
Default audio analysis enabled flag.
Definition options.h:723

ascii_renderer_t
ascii_renderer_t
Consolidated options structure.
Definition options.h:966

options_terminal_settings_ptr
const terminal_options_t * options_terminal_settings_ptr(void)
Definition rcu.c:535

options_set_double
asciichat_error_t options_set_double(const char *field_name, double value)
Definition rcu.c:905

options_get
const options_t * options_get(void)
Get current options (lock-free read).
Definition rcu.c:511

weight_red
const float weight_red
Red weight for luminance calculation.
Definition options/common.c:383

OPT_ACDS_DEFAULT
#define OPT_ACDS_DEFAULT
Default ACDS registration flag (false = disabled).
Definition options.h:591

OPTIONS_BUFF_SIZE
#define OPTIONS_BUFF_SIZE
Buffer size for option string values.
Definition options.h:310

OPT_NO_COMPRESS_DEFAULT
#define OPT_NO_COMPRESS_DEFAULT
Default no compression flag (false = enable compression).
Definition options.h:588

options_init
asciichat_error_t options_init(int argc, char **argv)
Initialize options by parsing command-line arguments with unified mode detection.
Definition options.c:2417

audio_source_t
audio_source_t
Audio source selected for visualization.
Definition options.h:276

option_mode_bitmask_t
option_mode_bitmask_t
Option mode bitmask.
Definition options.h:936

OPT_AUDIO_NO_PLAYBACK_DEFAULT
#define OPT_AUDIO_NO_PLAYBACK_DEFAULT
Default audio playback flag (false = enable playback).
Definition options.h:726

OPT_PAUSE_DEFAULT
#define OPT_PAUSE_DEFAULT
Default pause media flag (false = play immediately).
Definition options.h:534

OPTIONS_VIDEO_CODEC_BUFFER_SIZE
#define OPTIONS_VIDEO_CODEC_BUFFER_SIZE
Definition options.h:210

OPT_AUDIO_SOURCE_DEFAULT
#define OPT_AUDIO_SOURCE_DEFAULT
Visualize all available sources by default.
Definition options.h:706

options_set_string
asciichat_error_t options_set_string(const char *field_name, const char *value)
Definition rcu.c:908

options_set_bool
asciichat_error_t options_set_bool(const char *field_name, bool value)
Definition rcu.c:902

OPT_COLOR_FILTER_DEFAULT
#define OPT_COLOR_FILTER_DEFAULT
Default color filter (none - no filtering).
Definition options.h:461

OPT_WEBCAM_INDEX_DEFAULT
#define OPT_WEBCAM_INDEX_DEFAULT
Default webcam device index.
Definition options.h:512

usage
void usage(FILE *stream, asciichat_mode_t mode)
Print usage information for a specific mode.
Definition options/common.c:701

OPT_HEIGHT_DEFAULT
#define OPT_HEIGHT_DEFAULT
Default terminal height in characters.
Definition options.h:424

GREEN
unsigned short int GREEN[256]
Green channel lookup table.
Definition options/common.c:390

OPT_SNAPSHOT_MODE_DEFAULT
#define OPT_SNAPSHOT_MODE_DEFAULT
Default snapshot mode flag (false = continuous).
Definition options.h:479

OPT_MEDIA_LOOP_DEFAULT
#define OPT_MEDIA_LOOP_DEFAULT
Default loop media flag (false = play once).
Definition options.h:525

OPT_NO_CHECK_UPDATE_DEFAULT
#define OPT_NO_CHECK_UPDATE_DEFAULT
Default no-check-update flag (false = check for updates enabled).
Definition options.h:341

OPT_STRETCH_DEFAULT
#define OPT_STRETCH_DEFAULT
Default allow aspect ratio distortion flag.
Definition options.h:473

OPT_STATUS_SCREEN_DEFAULT
#define OPT_STATUS_SCREEN_DEFAULT
Default status screen flag (true = show status, false = hide status).
Definition options.h:329

OPT_LAN_DISCOVERY_DEFAULT
#define OPT_LAN_DISCOVERY_DEFAULT
Default LAN discovery flag (false = discovery disabled).
Definition options.h:612

OPT_JSON_DEFAULT
#define OPT_JSON_DEFAULT
Default JSON logging flag (false = text output).
Definition options.h:367

OPT_ACDS_INSECURE_DEFAULT
#define OPT_ACDS_INSECURE_DEFAULT
Default ACDS insecure mode flag (false = verify server).
Definition options.h:603

has_action_flag
bool has_action_flag(void)
Check if an action flag was detected.
Definition options.c:122

OPT_FPS_DEFAULT
#define OPT_FPS_DEFAULT
Default FPS (frames per second).
Definition options.h:476

OPT_WEBRTC_DEFAULT
#define OPT_WEBRTC_DEFAULT
Default WebRTC mode flag (true = P2P WebRTC, false = direct TCP).
Definition options.h:669

OPT_REQUIRE_CLIENT_IDENTITY_DEFAULT
#define OPT_REQUIRE_CLIENT_IDENTITY_DEFAULT
Default require-client-identity setting for ACDS.
Definition options.h:609

color_setting_t
color_setting_t
For options state, this is the live record that ties detected_mode, mode_arg_index,...
Definition options.h:243

OPT_DISABLE_KEEPAWAKE_DEFAULT
#define OPT_DISABLE_KEEPAWAKE_DEFAULT
Default disable keep-awake flag (false = allow system sleep prevention).
Definition options.h:338

OPT_ENABLE_UPNP_DEFAULT
#define OPT_ENABLE_UPNP_DEFAULT
Default enable UPnP flag (false = UPnP disabled).
Definition options.h:618

OPT_WEBRTC_SKIP_HOST_DEFAULT
#define OPT_WEBRTC_SKIP_HOST_DEFAULT
Default WebRTC skip host candidates flag (false = use host candidates).
Definition options.h:684

OPT_LOG_FORMAT_CONSOLE_DEFAULT
#define OPT_LOG_FORMAT_CONSOLE_DEFAULT
Default log format console only flag (false = use default format everywhere).
Definition options.h:398

OPT_SNAPSHOT_DELAY_DEFAULT
#define OPT_SNAPSHOT_DELAY_DEFAULT
Default snapshot delay in seconds.
Definition options.h:492

weight_green
const float weight_green
Green weight for luminance calculation.
Definition options/common.c:384

OPT_LOG_LEVEL_DEFAULT
#define OPT_LOG_LEVEL_DEFAULT
Default log level (LOG_INFO).
Definition options.h:361

OPT_MICROPHONE_SENSITIVITY_DEFAULT
#define OPT_MICROPHONE_SENSITIVITY_DEFAULT
Default microphone sensitivity (1.0 = normal volume).
Definition options.h:717

OPT_FLIP_X_DEFAULT
#define OPT_FLIP_X_DEFAULT
Webcam input is mirrored unless an orientation is explicitly selected.
Definition options.h:502

OPT_PORT_INT_DEFAULT
#define OPT_PORT_INT_DEFAULT
Default TCP port for client/server communication (integer).
Definition options.h:567

RED
unsigned short int RED[256]
Red channel lookup table.
Definition options/common.c:389

OPT_MAX_CLIENTS_DEFAULT
#define OPT_MAX_CLIENTS_DEFAULT
Default maximum concurrent clients (server only).
Definition options.h:579

OPT_PREFER_WEBRTC_DEFAULT
#define OPT_PREFER_WEBRTC_DEFAULT
Default prefer WebRTC flag (false = try direct TCP first).
Definition options.h:672

options_t_new
options_t options_t_new(void)
Initialize options by parsing command-line arguments.
Definition options.c:547

OPT_WEBRTC_DISABLE_TURN_DEFAULT
#define OPT_WEBRTC_DISABLE_TURN_DEFAULT
Default WebRTC disable TURN flag (false = use TURN).
Definition options.h:681

OPT_NO_WEBRTC_DEFAULT
#define OPT_NO_WEBRTC_DEFAULT
Default no WebRTC flag (false = WebRTC enabled).
Definition options.h:675

OPT_AUDIO_CAPTURE_SOURCE_DEFAULT
#define OPT_AUDIO_CAPTURE_SOURCE_DEFAULT
Preserve automatic local audio capture selection by default.
Definition options.h:708

OPT_SPEAKERS_INDEX_DEFAULT
#define OPT_SPEAKERS_INDEX_DEFAULT
Default speakers device index (-1 means system default).
Definition options.h:714

update_dimensions_for_full_height
void update_dimensions_for_full_height(options_t *opts)
Update dimensions to use full terminal height while maintaining aspect ratio.
Definition options/common.c:620

OPT_WEBSOCKET_PORT_SERVER_DEFAULT
#define OPT_WEBSOCKET_PORT_SERVER_DEFAULT
Default WebSocket port for server mode (integer).
Definition options.h:570

OPT_MEDIA_SEEK_TIMESTAMP_DEFAULT
#define OPT_MEDIA_SEEK_TIMESTAMP_DEFAULT
Default media seek timestamp (start from beginning).
Definition options.h:531

OPT_WIDTH_DEFAULT
#define OPT_WIDTH_DEFAULT
Default terminal width in characters.
Definition options.h:413

UTF8_SETTING_AUTO
@ UTF8_SETTING_AUTO
Smart detection (default): UTF-8 if terminal supports it.
Definition options.h:264

UTF8_SETTING_FALSE
@ UTF8_SETTING_FALSE
Force UTF-8 OFF: disable UTF-8 support.
Definition options.h:268

UTF8_SETTING_TRUE
@ UTF8_SETTING_TRUE
Force UTF-8 ON: always use UTF-8 regardless of terminal capability.
Definition options.h:266

AUDIO_CAPTURE_SOURCE_BOTH
@ AUDIO_CAPTURE_SOURCE_BOTH
Definition options.h:294

AUDIO_CAPTURE_SOURCE_REMOTE
@ AUDIO_CAPTURE_SOURCE_REMOTE
Definition options.h:295

AUDIO_CAPTURE_SOURCE_MEDIA
@ AUDIO_CAPTURE_SOURCE_MEDIA
Definition options.h:293

AUDIO_CAPTURE_SOURCE_MIC
@ AUDIO_CAPTURE_SOURCE_MIC
Definition options.h:292

AUDIO_CAPTURE_SOURCE_AUTO
@ AUDIO_CAPTURE_SOURCE_AUTO
Definition options.h:291

MODE_CLIENT
@ MODE_CLIENT
Client mode - network client options.
Definition options.h:921

MODE_MCP_SERVER
@ MODE_MCP_SERVER
Model Context Protocol rendering server.
Definition options.h:925

MODE_DISCOVERY_SERVICE
@ MODE_DISCOVERY_SERVICE
Discovery server mode - session management and WebRTC signaling.
Definition options.h:923

MODE_API_SERVER
@ MODE_API_SERVER
Image-to-ASCII HTTP API server.
Definition options.h:926

MODE_INVALID
@ MODE_INVALID
Invalid mode.
Definition options.h:927

MODE_SERVER
@ MODE_SERVER
Server mode - network server options.
Definition options.h:920

MODE_MIRROR
@ MODE_MIRROR
Mirror mode - local webcam viewing (no network).
Definition options.h:922

MODE_DISCOVERY
@ MODE_DISCOVERY
Discovery mode - participant that can dynamically become host.
Definition options.h:924

ASCII_RENDERER_GLYPH
@ ASCII_RENDERER_GLYPH
Definition options.h:966

ASCII_RENDERER_LUMINANCE
@ ASCII_RENDERER_LUMINANCE
Definition options.h:966

AUDIO_SOURCE_MIC
@ AUDIO_SOURCE_MIC
Definition options.h:282

AUDIO_SOURCE_CALL
@ AUDIO_SOURCE_CALL
Definition options.h:280

AUDIO_SOURCE_MEDIA
@ AUDIO_SOURCE_MEDIA
Definition options.h:284

AUDIO_SOURCE_ALL
@ AUDIO_SOURCE_ALL
Definition options.h:278

AUDIO_SOURCE_AUTO
@ AUDIO_SOURCE_AUTO
Definition options.h:286

OPTION_MODE_ALL
@ OPTION_MODE_ALL
All modes + binary.
Definition options.h:946

OPTION_MODE_BINARY
@ OPTION_MODE_BINARY
Binary-level options (parsed before mode detection).
Definition options.h:945

OPTION_MODE_CLIENT
@ OPTION_MODE_CLIENT
Client mode (bit 1).
Definition options.h:939

OPTION_MODE_API_SERVER
@ OPTION_MODE_API_SERVER
Definition options.h:944

OPTION_MODE_DISCOVERY
@ OPTION_MODE_DISCOVERY
Discovery mode (bit 4).
Definition options.h:942

OPTION_MODE_SERVER
@ OPTION_MODE_SERVER
Server mode (bit 0).
Definition options.h:938

OPTION_MODE_MIRROR
@ OPTION_MODE_MIRROR
Mirror mode (bit 2).
Definition options.h:940

OPTION_MODE_NONE
@ OPTION_MODE_NONE
No modes (invalid).
Definition options.h:937

OPTION_MODE_MCP_SERVER
@ OPTION_MODE_MCP_SERVER
Definition options.h:943

OPTION_MODE_DISCOVERY_SVC
@ OPTION_MODE_DISCOVERY_SVC
Discovery server mode (bit 3).
Definition options.h:941

COLOR_SETTING_TRUE
@ COLOR_SETTING_TRUE
Force colors ON: always colorize regardless of TTY/piping/CLAUDECODE.
Definition options.h:247

COLOR_SETTING_FALSE
@ COLOR_SETTING_FALSE
Force colors OFF: disable all colors and logging colors.
Definition options.h:249

COLOR_SETTING_AUTO
@ COLOR_SETTING_AUTO
Smart detection (default): colors if TTY and not CLAUDECODE and not piping.
Definition options.h:245

palette_type_t
palette_type_t
Built-in palette type enumeration.
Definition palette.h:90

options_resolve_flip_x
void options_resolve_flip_x(options_t *opts)
Definition options.c:2575

palette.h
ASCII Palette Management for Video-to-ASCII Conversion.

g_snapshot_first_frame_rendered
bool g_snapshot_first_frame_rendered
Definition src/common/session/render.c:54

playlist.h

g_snapshot_first_frame_rendered_ns
uint64_t g_snapshot_first_frame_rendered_ns
Definition src/common/session/render.c:55

g_snapshot_first_capture_ns
uint64_t g_snapshot_first_capture_ns
Definition src/common/session/render.c:56

g_snapshot_actual_duration_ms
uint64_t g_snapshot_actual_duration_ms
Definition src/common/session/render.c:57

SESSION_STRING_BUFFER_SIZE
#define SESSION_STRING_BUFFER_SIZE
Definition strings/main.c:29

media_playlist_t
Definition playlist.h:9

options_state
Immutable, RCU-published snapshot of the application's runtime configuration.
Definition options.h:979

options_state::otel_ca_file
char otel_ca_file[256]
Definition options.h:1159

options_state::snapshot_mode
bool snapshot_mode
Snapshot mode (one frame and exit).
Definition options.h:1149

options_state::otel_realtime_max_per_second
int otel_realtime_max_per_second
Definition options.h:1162

options_state::zalgo
int zalgo
Combining-mark intensity (0 = disabled, 1-10 = enabled).
Definition options.h:1151

options_state::splash_screen_explicitly_set
bool splash_screen_explicitly_set
True if splash screen was explicitly set by user.
Definition options.h:1238

options_state::speakers_volume
float speakers_volume
Speaker volume multiplier (0.0-1.0, default 1.0).
Definition options.h:1131

options_state::discovery_port
int discovery_port
discovery server port (default: 27225)
Definition options.h:1040

options_state::media_url
char media_url[256]
Network URL (HTTP/HTTPS/YouTube/RTSP) - takes priority over media_file.
Definition options.h:1080

options_state::render_kitty
bool render_kitty
Display a snapshot with Kitty graphics.
Definition options.h:1260

options_state::otel_realtime_sample_rate
double otel_realtime_sample_rate
Definition options.h:1161

options_state::flip_x_explicit
bool flip_x_explicit
User selected an orientation for this process lifetime.
Definition options.h:1104

options_state::num_identity_keys
size_t num_identity_keys
Number of identity keys loaded (0 means single-key mode using encrypt_key).
Definition options.h:1191

options_state::audio_spectral_agc
bool audio_spectral_agc
Definition options.h:1113

options_state::webtransport_path
char webtransport_path[256]
HTTP/3 CONNECT path.
Definition options.h:1016

options_state::test_pattern_index
int test_pattern_index
Synthetic pattern selector (0 or 1).
Definition options.h:1072

options_state::webrtc
bool webrtc
Enable WebRTC mode for discovery session (default: true, P2P WebRTC).
Definition options.h:1045

options_state::discovery_quic
bool discovery_quic
Use QUIC for a disclosed discovery host endpoint.
Definition options.h:1021

options_state::audio_capture_source
audio_capture_source_t audio_capture_source
Local capture/media selection policy.
Definition options.h:1122

options_state::encrypt_enabled
bool encrypt_enabled
Enable encryption.
Definition options.h:1178

options_state::otel_metrics_interval
int otel_metrics_interval
Definition options.h:1163

options_state::color_mode
terminal_color_mode_t color_mode
Color mode (auto/none/16/256/truecolor).
Definition options.h:1092

options_state::audio_spectral_gate
bool audio_spectral_gate
Definition options.h:1116

options_state::quic_bind_address
char quic_bind_address[256]
Concrete local QUIC listener address; empty disables QUIC.
Definition options.h:1017

options_state::discovery_expose_ip
bool discovery_expose_ip
ACDS: explicitly allow public IP disclosure without verification (opt-in).
Definition options.h:1200

options_state::turn_servers
char turn_servers[256]
ACDS: Comma-separated list of TURN server URLs.
Definition options.h:1221

options_state::force_utf8
int force_utf8
UTF-8 support setting (auto/true/false).
Definition options.h:1097

options_state::webrtc_ice_timeout_ms
int webrtc_ice_timeout_ms
–webrtc-ice-timeout: ICE gathering timeout in milliseconds (default: 10000)
Definition options.h:1213

options_state::debug_backtrace_time_explicit
bool debug_backtrace_time_explicit
True if –backtrace was explicitly provided.
Definition options.h:1251

options_state::discovery
bool discovery
Enable discovery session registration (default: false).
Definition options.h:1032

options_state::render_font
char render_font[256]
Font family name or .ttf path (empty = platform default).
Definition options.h:1263

options_state::audio_adaptive_eq
bool audio_adaptive_eq
Definition options.h:1118

options_state::debug_memory_report_interval
double debug_memory_report_interval
Interval in seconds for periodic memory reports.
Definition options.h:1252

options_state::discovery_service_url
char discovery_service_url[256]
exclusive with discovery_port)
Definition options.h:1041

options_state::webrtc_relay_only
bool webrtc_relay_only
–webrtc-relay-only: Require TURN relay candidates
Definition options.h:1210

options_state::disable_keepawake
bool disable_keepawake
Explicitly disable system sleep prevention (allow OS to sleep).
Definition options.h:1173

options_state::mcp_downloads_url_prefix
char mcp_downloads_url_prefix[256]
Public HTTP origin for download links.
Definition options.h:1037

options_state::otel_queue_capacity
int otel_queue_capacity
Definition options.h:1165

options_state::test_audio
bool test_audio
Replace microphone capture with a repeating audible test signal.
Definition options.h:1112

options_state::microphone_channel
int microphone_channel
First zero-based input channel; -1 downmixes all inputs.
Definition options.h:1127

options_state::debug_sync_state_time_explicit
bool debug_sync_state_time_explicit
True if –sync-state was explicitly provided.
Definition options.h:1249

options_state::otel_timeout
int otel_timeout
Definition options.h:1164

options_state::log_template
char log_template[256]
Custom log format string (formerly –log-format).
Definition options.h:1170

options_state::microphone_sensitivity
float microphone_sensitivity
Microphone volume multiplier (0.0-1.0, default 1.0).
Definition options.h:1130

options_state::microphone_channels
int microphone_channels
Selected microphone channels: 1 (speech) or 2 (stereo).
Definition options.h:1126

options_state::compression_level
int compression_level
zstd compression level (1-9)
Definition options.h:1058

options_state::fps_explicitly_set
bool fps_explicitly_set
True if FPS was explicitly configured by the user.
Definition options.h:1100

options_state::fft
bool fft
Replace the video image with a live audio frequency spectrogram.
Definition options.h:1124

options_state::media_playlist
media_playlist_t media_playlist
Ordered CLI artifacts shared with live media input.
Definition options.h:1078

options_state::enable_keepawake
bool enable_keepawake
Explicitly enable system sleep prevention.
Definition options.h:1172

options_state::debug_sync_state_time
double debug_sync_state_time
Time parameter for –sync-state.
Definition options.h:1248

options_state::webrtc_bind_address
char webrtc_bind_address[256]
Optional numeric local address for WebRTC ICE sockets.
Definition options.h:1208

options_state::otel_endpoint
char otel_endpoint[256]
Definition options.h:1158

options_state::show_capabilities
bool show_capabilities
Show terminal capabilities and exit.
Definition options.h:1096

options_state::no_mdns_advertise
bool no_mdns_advertise
Disable mDNS service advertisement (server only).
Definition options.h:1053

options_state::fps_counter
bool fps_counter
Show FPS counter overlay in top-right corner.
Definition options.h:1153

options_state::password
char password[256]
Password string.
Definition options.h:1180

options_state::microphone_index
int microphone_index
Microphone device index (-1 = default).
Definition options.h:1128

options_state::config_file
char config_file[256]
Config file path (–config).
Definition options.h:991

options_state::detected_mode
asciichat_mode_t detected_mode
Mode detected from command-line arguments.
Definition options.h:983

options_state::strip_ansi
bool strip_ansi
Strip ANSI escape sequences.
Definition options.h:1154

options_state::audio_analysis_enabled
bool audio_analysis_enabled
Enable audio analysis (debug).
Definition options.h:1132

options_state::websocket_port
int websocket_port
WebSocket server port (server/discovery-service only).
Definition options.h:1010

options_state::audio_pitch_correct
bool audio_pitch_correct
Definition options.h:1111

options_state::palette_explicit
bool palette_explicit
Palette explicitly selected.
Definition options.h:1232

options_state::pause
bool pause
Start playback paused (toggle with spacebar).
Definition options.h:1084

options_state::audio_source
audio_source_t audio_source
Visualization source (all/call/mic/media).
Definition options.h:1121

options_state::json
bool json
Enable JSON logging (–json flag).
Definition options.h:1169

options_state::stun_servers
char stun_servers[256]
ACDS: Comma-separated list of STUN server URLs.
Definition options.h:1220

options_state::height
int height
Terminal height in characters (int for OPTION_TYPE_INT compat).
Definition options.h:997

options_state::webtransport_bind_address
char webtransport_bind_address[256]
Browser HTTP/3 listener address.
Definition options.h:1014

options_state::enable_upnp
bool enable_upnp
Opt-in TCP/WebSocket and WebRTC UDP mapping via –port-forwarding.
Definition options.h:1219

options_state::debug_errno_stacks_time_explicit
bool debug_errno_stacks_time_explicit
True if –errno-stacks was provided.
Definition options.h:1247

options_state::face_follow
bool face_follow
Automatically frame and follow the selected face.
Definition options.h:1101

options_state::webrtc_skip_stun
bool webrtc_skip_stun
–webrtc-skip-stun: Skip Stage 2 (STUN), go to TURN
Definition options.h:1209

options_state::debug_memory_report_interval_explicit
bool debug_memory_report_interval_explicit
True if –memory-report was explicitly provided.
Definition options.h:1253

options_state::log_format_console_only
bool log_format_console_only
Apply log format only to console output.
Definition options.h:1171

options_state::lan_discovery
bool lan_discovery
Enable LAN service discovery via mDNS (client only).
Definition options.h:1052

options_state::debug_errno_stacks_time
double debug_errno_stacks_time
Delay before the error report.
Definition options.h:1246

options_state::session_string
char session_string[(38+1)]
Definition options.h:1026

options_state::identity_keys
char identity_keys[32][256]
All identity keys (populated when –key is used multiple times).
Definition options.h:1190

options_state::stats_interval
int stats_interval
Periodic plain statistics on stdout; zero disables.
Definition options.h:1098

options_state::tls_key
char tls_key[256]
Shared TLS private key file path for secure network listeners.
Definition options.h:1012

options_state::audio_enabled
bool audio_enabled
Enable audio streaming.
Definition options.h:1120

options_state::tls_ca_file
char tls_ca_file[256]
Shared TLS client trust anchors; empty uses system trust.
Definition options.h:1018

options_state::no_encrypt
bool no_encrypt
Disable encryption (opt-out).
Definition options.h:1182

options_state::no_webrtc
bool no_webrtc
–no-webrtc: Disable WebRTC, use Direct TCP only
Definition options.h:1207

options_state::audio_multiband
bool audio_multiband
Definition options.h:1117

options_state::matrix_rain
bool matrix_rain
Matrix digital rain effect (false = disabled).
Definition options.h:1152

options_state::webrtc_disable_turn
bool webrtc_disable_turn
–webrtc-disable-turn: Disable Stage 3 (TURN), use STUN only
Definition options.h:1211

options_state::tls_key_password
char tls_key_password[256]
Shared TLS private key password.
Definition options.h:1013

options_state::quic_fallback_port
int quic_fallback_port
TCP fallback port, or zero to disable fallback.
Definition options.h:1024

options_state::audio_no_playback
bool audio_no_playback
Disable speaker playback (debug).
Definition options.h:1133

options_state::face_follow_debug
bool face_follow_debug
Developer diagnostic face outline.
Definition options.h:1102

options_state::mcp_transport
char mcp_transport[256]
MCP transport: stdio or http.
Definition options.h:1038

options_state::auto_height
bool auto_height
Auto-detect height from terminal.
Definition options.h:999

options_state::log_level
log_level_t log_level
Log level threshold.
Definition options.h:1167

options_state::render_file
char render_file[256]
Output file path (e.g. output.mp4).
Definition options.h:1258

options_state::turn_credential
char turn_credential[256]
ACDS: Credential/password for TURN authentication.
Definition options.h:1223

options_state::require_server_identity
bool require_server_identity
ACDS: require servers to provide signed Ed25519 identity.
Definition options.h:1196

options_state::audio_fft_size
int audio_fft_size
Definition options.h:1119

options_state::palette_custom
char palette_custom[256]
Custom palette characters.
Definition options.h:1230

options_state::status_screen
bool status_screen
Show status screen (default: true = show, use –no-status-screen to hide).
Definition options.h:1239

options_state::otel_log_level
char otel_log_level[256]
Definition options.h:1157

options_state::max_clients
int max_clients
Maximum concurrent clients (server only).
Definition options.h:1025

options_state::palette_custom_set
bool palette_custom_set
True if custom palette was set.
Definition options.h:1231

options_state::no_auth
bool no_auth
Disable authentication layer (–no-auth).
Definition options.h:1183

options_state::render_mode
terminal_render_mode_t render_mode
Render mode (foreground/background/half-block).
Definition options.h:1095

options_state::splash_screen
bool splash_screen
Show splash screen (default: true = show, use –no-splash-screen to hide).
Definition options.h:1237

options_state::discovery_database_path
char discovery_database_path[256]
~/.ascii-chat/discovery.db)
Definition options.h:1046

options_state::server_key
char server_key[256]
Expected server public key (client).
Definition options.h:1184

options_state::media_input
bool media_input
Active input is a file/URL rather than the webcam.
Definition options.h:1105

options_state::no_audio_mixer
bool no_audio_mixer
Disable audio mixer (debug).
Definition options.h:1073

options_state::audio_spectral_mixer
bool audio_spectral_mixer
Explicit post-mix processing; disabled by default.
Definition options.h:1115

options_state::encrypt_keyfile
char encrypt_keyfile[256]
Alternative key file path.
Definition options.h:1181

options_state::http_origin
char http_origin[256]
Allowed HTTP Origin.
Definition options.h:1039

options_state::webrtc_skip_host
bool webrtc_skip_host
–webrtc-skip-host: Skip host candidates, force STUN/TURN only
Definition options.h:1212

options_state::tls_cert
char tls_cert[256]
Shared TLS certificate file path for secure network listeners.
Definition options.h:1011

options_state::version
bool version
Show version information.
Definition options.h:990

options_state::webcam_index
int webcam_index
Webcam device index (0 = first).
Definition options.h:1070

options_state::status_screen_explicitly_set
bool status_screen_explicitly_set
True if status_screen was explicitly set by user.
Definition options.h:1240

options_state::mcp_server_restricted
bool mcp_server_restricted
Restrict MCP capabilities for cloud deployment.
Definition options.h:1035

options_state::stabilize
bool stabilize
Reduce frame-to-frame character flicker.
Definition options.h:1138

options_state::no_compress
bool no_compress
Disable compression entirely.
Definition options.h:1059

options_state::webrtc_reconnect_attempts
int webrtc_reconnect_attempts
–webrtc-reconnect-attempts: Number of retry attempts (default: 3)
Definition options.h:1214

options_state::address6
char address6[256]
IPv6 bind address (server only).
Definition options.h:1008

options_state::speakers_index
int speakers_index
Speakers device index (-1 = default).
Definition options.h:1129

options_state::quic_port
int quic_port
QUIC UDP port, or zero to use the TCP server port.
Definition options.h:1023

options_state::color_filter
color_filter_t color_filter
Monochromatic color filter (none/black/white/green/etc).
Definition options.h:1093

options_state::help
bool help
Show help message.
Definition options.h:989

options_state::prefer_webrtc
bool prefer_webrtc
–prefer-webrtc: Try WebRTC before Direct TCP
Definition options.h:1206

options_state::quiet
bool quiet
Quiet mode (suppress logs).
Definition options.h:1147

options_state::snapshot_delay
double snapshot_delay
Snapshot delay in seconds.
Definition options.h:1150

options_state::mcp_downloads_dir
char mcp_downloads_dir[256]
Hosted download directory override.
Definition options.h:1036

options_state::stabilize_explicit
bool stabilize_explicit
Runtime preference was explicitly changed.
Definition options.h:1139

options_state::audio_spectral
bool audio_spectral
Definition options.h:1114

options_state::fps
int fps
Target framerate (0 = auto, 1-144).
Definition options.h:1099

options_state::stretch
bool stretch
Allow aspect ratio distortion.
Definition options.h:1141

options_state::address_explicit
bool address_explicit
Native client destination overrides automatic LAN discovery.
Definition options.h:1005

options_state::renderer
ascii_renderer_t renderer
Character selection algorithm.
Definition options.h:1140

options_state::waveform
bool waveform
Replace the video image with a live audio waveform.
Definition options.h:1123

options_state::quic_visual_datagrams
bool quic_visual_datagrams
Prefer negotiated visual datagrams.
Definition options.h:1019

options_state::reconnect_attempts
int reconnect_attempts
Number of reconnection attempts (-1=infinite, 0=none).
Definition options.h:1065

options_state::test_pattern
bool test_pattern
Use test pattern instead of webcam.
Definition options.h:1071

options_state::quic_audio_datagrams
bool quic_audio_datagrams
Prefer negotiated QUIC datagrams for audio.
Definition options.h:1020

options_state::fft_scale
char fft_scale[32]
Amplitude scale for the FFT visualization.
Definition options.h:1125

options_state::port
int port
Server port number.
Definition options.h:1009

options_state::video_codec
char video_codec[64]
Video codec (auto, hevc, h264, raw) - default: auto.
Definition options.h:1142

options_state::media_from_stdin
bool media_from_stdin
Reading from stdin (detected from "--file -").
Definition options.h:1082

options_state::yt_dlp_options
char yt_dlp_options[512]
"--cookies-from-browser=chrome --embed-subs")
Definition options.h:1085

options_state::require_client_verify
bool require_client_verify
Client: only connect to servers whose identity was verified by ACDS.
Definition options.h:1199

options_state::discovery_server
char discovery_server[256]
discovery server address (default: 127.0.0.1)
Definition options.h:1033

options_state::debug_backtrace_time
double debug_backtrace_time
Time parameter for –backtrace option.
Definition options.h:1250

options_state::width
int width
Terminal width in characters (int for OPTION_TYPE_INT compat).
Definition options.h:996

options_state::mode_arg_index
int mode_arg_index
Explicit mode token in original argv, or -1 for implicit discovery/session strings.
Definition options.h:984

options_state::require_server_verify
bool require_server_verify
Server: only accept clients who verified via ACDS.
Definition options.h:1198

options_state::palette_type
palette_type_t palette_type
Selected palette type.
Definition options.h:1229

options_state::flip_y
bool flip_y
Flip video vertically (Y-axis).
Definition options.h:1106

options_state::color_scheme_name
char color_scheme_name[64]
Color scheme name (e.g., "pastel", "nord").
Definition options.h:1094

options_state::turn_secret
char turn_secret[256]
ACDS: Shared secret for dynamic TURN credential generation (HMAC-SHA1).
Definition options.h:1224

options_state::media_loop
bool media_loop
Loop media file playback.
Definition options.h:1081

options_state::discovery_service_key
char discovery_service_key[256]
HTTPS URL).
Definition options.h:1043

options_state::require_client_identity
bool require_client_identity
ACDS: require clients to provide signed Ed25519 identity.
Definition options.h:1197

options_state::webtransport_public_url
char webtransport_public_url[256]
Public HTTPS WebTransport endpoint advertised through ACDS.
Definition options.h:1022

options_state::discovery_insecure
bool discovery_insecure
ACDS: skip server key verification (MITM-vulnerable, requires explicit opt-in).
Definition options.h:1201

options_state::no_check_update
bool no_check_update
Disable automatic update checks (default: false = checks enabled).
Definition options.h:1241

options_state::encode_audio
bool encode_audio
Enable Opus audio encoding.
Definition options.h:1060

options_state::render_theme
int render_theme
0=dark 1=light 2=auto
Definition options.h:1262

options_state::encrypt_key
char encrypt_key[256]
SSH/GPG key file path (first –key flag, kept for compatibility).
Definition options.h:1179

options_state::media_file
char media_file[256]
Media file path or "-" for stdin.
Definition options.h:1079

options_state::otel_enabled_telemetry
char otel_enabled_telemetry[256]
Definition options.h:1160

options_state::color
int color
Color setting (COLOR_SETTING_AUTO/TRUE/FALSE).
Definition options.h:1091

options_state::turn_username
char turn_username[256]
ACDS: Username for TURN authentication.
Definition options.h:1222

options_state::log_file
char log_file[256]
Log file path.
Definition options.h:1166

options_state::verbose_level
unsigned short int verbose_level
Verbosity level (stackable -V).
Definition options.h:1148

options_state::address
char address[256]
Server address (client) or bind address (server).
Definition options.h:1007

options_state::webtransport_origin
char webtransport_origin[256]
Allowed browser origin.
Definition options.h:1015

options_state::flip_x
bool flip_x
Effective horizontal orientation.
Definition options.h:1103

options_state::grep_pattern
char grep_pattern[256]
PCRE2 regex for log filtering.
Definition options.h:1168

options_state::auto_width
bool auto_width
Auto-detect width from terminal.
Definition options.h:998

options_state::client_keys
char client_keys[256]
Allowed client keys (server).
Definition options.h:1185

options_state::render_font_size
double render_font_size
Font size in points (0 selects an automatic size).
Definition options.h:1264

options_state::media_seek_timestamp
double media_seek_timestamp
Seek to timestamp in seconds before playback.
Definition options.h:1083