Struct SyncCommand 

pub struct SyncCommand {
    pub channels: Vec<String>,
    pub out: PathBuf,
    pub lang: String,
    pub format: CliFormat,
    pub auto: bool,
    pub full: bool,
    pub since: Option<String>,
    pub concurrency: usize,
    pub refresh_metadata_older_than: Option<String>,
    pub dry_run: bool,
}

Syncs transcripts for all videos in one or more YouTube channels to the filesystem, incrementally (skips videos already synced).

Fields

channels: Vec<String>

One or more channel references: a UC… ID, a channel URL (/channel/UC…, /@handle, /c/Name, /user/Name), or a bare @handle.

out: PathBuf

Output directory. Transcripts are written under <out>/<channel-id>/<video-id>.<lang>.<format>.

lang: String

Preferred caption language (e.g. en, en-US). Prefix fallback is applied — en matches en-US.

format: CliFormat

Output format.

auto: bool

Allow falling through to auto-generated (ASR) captions when no manual track matches. Recommended for channel syncs — many uploads only have auto captions.

full: bool

Backfill the channel’s entire upload history via the InnerTube /browse endpoint. Without this, only the ~15 most recent uploads (the RSS feed) are considered.

since: Option<String>

Only sync videos published on or after this date (YYYY-MM-DD or an RFC 3339 timestamp). Reliable for the default (RSS) path, which carries per-video publish dates; best-effort under --full (the browse grid has no per-item dates, so this is ignored there).

concurrency: usize

Maximum number of transcripts to fetch concurrently.

refresh_metadata_older_than: Option<String>

Re-fetch metadata sidecars whose fetched_at is older than this cutoff. Accepts YYYY-MM-DD (midnight UTC), a full RFC 3339 timestamp, or a relative spec like "2 days ago" (units: minute, hour, day, week, month, year). Without this flag existing sidecars are never refreshed, but missing ones are always downloaded.

dry_run: bool

List what would be fetched without downloading or writing anything.

Implementations

impl SyncCommand

pub async fn execute(self) -> Result<()>

Runs the sync against the public YouTube origin.

Trait Implementations

impl Args for SyncCommand

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl CommandFactory for SyncCommand

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl FromArgMatches for SyncCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for SyncCommand

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.