media.c

Go to the documentation of this file.

 
#include <ascii-chat/options/registry/common.h>
#include <ascii-chat/options/registry/metadata.h>
 
#include <ascii-chat/options/parsers.h>
#include <ascii-chat/platform/memory.h>
 
// ============================================================================
// Validators
// ============================================================================
 
static bool validate_render_font_size(const void *opts_struct, char **error_msg) {
  (void)opts_struct;
  const options_t *opts = (const options_t *)opts_struct;
  if (opts->render_font_size <= 0.0) {
    if (error_msg)
      *error_msg = platform_strdup("--render-font-size must be > 0");
    return false;
  }
  return true;
}
 
// ============================================================================
// MEDIA CATEGORY - Media file and stream options
// ============================================================================
const registry_entry_t g_media_entries[] = {
    // Media File Streaming Options
    {"file",
     'f',
     OPTION_TYPE_STRING,
     offsetof(options_t, media_file),
     "",
     0,
     "Stream from media file or stdin (use '-' for stdin). Supported formats: see man ffmpeg-formats; codecs: see man "
     "ffmpeg-codecs.",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_FILE",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {0},
     NULL},
    {"url",
     'u',
     OPTION_TYPE_STRING,
     offsetof(options_t, media_url),
     "",
     0,
     "Stream from network URL. Direct HTTP/HTTPS/RTSP streams use FFmpeg; complex sites (YouTube, TikTok, etc.) use "
     "yt-dlp. Supported formats: see man ffmpeg-formats; codecs: see man ffmpeg-codecs; sites: yt-dlp "
     "https://github.com/yt-dlp/yt-dlp/blob/master/README.md#supported-sites.",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_URL",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {0},
     NULL},
    {"loop",
     'l',
     OPTION_TYPE_BOOL,
     offsetof(options_t, media_loop),
     &default_media_loop_value,
     sizeof(bool),
     "Loop media file playback (not supported for --url).",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_LOOP",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {0},
     NULL},
    {"pause",
     '\0',
     OPTION_TYPE_BOOL,
     offsetof(options_t, pause),
     &default_pause_value,
     sizeof(bool),
     "Start playback paused (toggle with spacebar, requires --file or --url).",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_PAUSE",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {0},
     NULL},
    {"seek",
     's',
     OPTION_TYPE_CALLBACK,
     offsetof(options_t, media_seek_timestamp),
     &default_media_seek_value,
     sizeof(double),
     "Seek to timestamp before playback (format: seconds, MM:SS, or HH:MM:SS.ms).",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_SEEK",
     NULL,
     parse_timestamp,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {.examples = g_seek_examples, .input_type = OPTION_INPUT_STRING},
     NULL},
    {"yt-dlp-options",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, yt_dlp_options),
     NULL,
     sizeof(((options_t *)0)->yt_dlp_options),
     "Arbitrary yt-dlp options passed to the extraction subprocess for URL resolution. "
     "Examples: --no-warnings or --proxy socks5://127.0.0.1:1080 or --cookies-from-browser=firefox.",
     "MEDIA",
     NULL,
     false,
     "ASCII_CHAT_YT_DLP_OPTIONS",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY,
     {0},
     NULL},
    {"video-codec",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, video_codec),
     "hevc",
     sizeof(((options_t *)0)->video_codec),
     "Video codec for streaming (raw, hevc). raw=uncompressed RGB, hevc=H.265 compression. Default: hevc.",
     "MEDIA",
     "CODEC",
     false,
     "ASCII_CHAT_VIDEO_CODEC",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_CLIENT | OPTION_MODE_MIRROR,
     {0},
     NULL},
 
#define RENDER_FILE_MODES (OPTION_MODE_CLIENT | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY)
 
    {"render-file",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, render_file),
     "",
     sizeof(((options_t *)0)->render_file),
     "Render ASCII frames to stdout or video/image file. Use '-' for stdout; extension determines format: "
     ".mp4, .mov, .webm, .avi, .gif, .png, .jpg.",
     "MEDIA",
     "PATH",
     false,
     "ASCII_CHAT_RENDER_FILE",
     NULL,
     NULL,
     false,
     false,
     RENDER_FILE_MODES,
     {0},
     NULL},
 
    {"render-theme",
     '\0',
     OPTION_TYPE_CALLBACK,
     offsetof(options_t, render_theme),
     &default_render_theme_value,
     sizeof(int),
     "Terminal color scheme for rendered output: dark, light, auto.",
     "MEDIA",
     "THEME",
     false,
     "ASCII_CHAT_RENDER_THEME",
     NULL,
     parse_render_theme,
     false,
     false,
     RENDER_FILE_MODES,
     {.enum_values = g_render_theme_values, .enum_descriptions = g_render_theme_descs, .input_type = OPTION_INPUT_ENUM},
     NULL},
 
    {"render-font",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, render_font),
     "",
     sizeof(((options_t *)0)->render_font),
     "Font for render-file output: bundled names (matrix or default), system font names, or absolute .ttf/.otf path. "
     "Default: default (bundled DejaVu Sans Mono). "
     "Examples: matrix, default, JetBrains Mono, Nerd Font Mono, /path/to/font.ttf.",
     "MEDIA",
     "FONT",
     false,
     "ASCII_CHAT_RENDER_FONT",
     NULL,
     NULL,
     false,
     false,
     RENDER_FILE_MODES,
     {0},
     NULL},
 
    {"render-font-size",
     '\0',
     OPTION_TYPE_DOUBLE,
     offsetof(options_t, render_font_size),
     &default_render_font_size_value,
     sizeof(double),
     "Font size in points for render-file output (default: 12.0, must be > 0, fractional sizes supported e.g. 10.5).",
     "MEDIA",
     "SIZE",
     false,
     "ASCII_CHAT_RENDER_FONT_SIZE",
     validate_render_font_size,
     NULL,
     false,
     false,
     RENDER_FILE_MODES,
     {.input_type = OPTION_INPUT_NUMERIC},
     NULL},
 
    REGISTRY_TERMINATOR()};