oximedia-cli 0.1.7

Command-line interface for OxiMedia
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

//! Subtitle/caption-domain sub-enum definitions used by `Commands`.
//!
//! Currently houses [`CaptionsCommand`]. The `Subtitle` and `Timecode`
//! variants on the top-level `Commands` enum delegate to sub-enums that
//! live alongside their handler modules (`subtitle_cmd::SubtitleCommand`,
//! `timecode_cmd::TimecodeCommand`) so they are not re-defined here.

use clap::Subcommand;
use std::path::PathBuf;

/// Captions subcommands.
#[derive(Subcommand)]
pub(crate) enum CaptionsCommand {
    /// Generate captions from audio
    Generate {
        /// Input audio/video file
        #[arg(short, long)]
        input: PathBuf,

        /// Output caption file
        #[arg(short, long)]
        output: PathBuf,

        /// Output format: srt, vtt, ass, ttml, scc
        #[arg(long, default_value = "srt")]
        format: String,

        /// Language code (e.g. en, ja)
        #[arg(long, default_value = "en")]
        language: String,

        /// Path to the ONNX caption encoder model weights.
        /// Required when the `caption-gen` feature is enabled.
        #[arg(long)]
        model: Option<PathBuf>,

        /// Path to a JSON vocabulary file (maps token ID strings to words).
        /// Required together with `--model`.
        #[arg(long)]
        vocab: Option<PathBuf>,
    },

    /// Synchronize captions to audio
    Sync {
        /// Input caption file
        #[arg(short, long)]
        input: PathBuf,

        /// Reference audio/video file
        #[arg(long)]
        reference: PathBuf,

        /// Output synced caption file
        #[arg(short, long)]
        output: PathBuf,

        /// Maximum time shift in milliseconds
        #[arg(long, default_value = "5000")]
        max_shift_ms: i64,
    },

    /// Convert between caption formats
    Convert {
        /// Input caption file
        #[arg(short, long)]
        input: PathBuf,

        /// Output file
        #[arg(short, long)]
        output: PathBuf,

        /// Source format (auto-detected if not specified)
        #[arg(long)]
        from_format: Option<String>,

        /// Target format: srt, vtt, ass, ttml, scc
        #[arg(long)]
        to_format: String,
    },

    /// Burn captions into video
    Burn {
        /// Input video file
        #[arg(long)]
        video: PathBuf,

        /// Input caption file
        #[arg(long)]
        captions: PathBuf,

        /// Output video file
        #[arg(short, long)]
        output: PathBuf,

        /// Font size
        #[arg(long, default_value = "24")]
        font_size: u32,

        /// Font color (hex)
        #[arg(long, default_value = "FFFFFF")]
        font_color: String,
    },

    /// Extract captions from media
    Extract {
        /// Input media file
        #[arg(short, long)]
        input: PathBuf,

        /// Output caption file
        #[arg(short, long)]
        output: PathBuf,

        /// Output format
        #[arg(long, default_value = "srt")]
        format: String,

        /// Track index to extract
        #[arg(long, default_value = "0")]
        track: usize,
    },

    /// Validate caption file against standards
    Validate {
        /// Input caption file
        #[arg(short, long)]
        input: PathBuf,

        /// Standard: fcc, wcag, cea608, cea708, ebu
        #[arg(long, default_value = "fcc")]
        standard: String,

        /// Save report to file
        #[arg(long)]
        report: Option<PathBuf>,
    },
}