ytdlp

func (*Command) AbortOnError ¶

func (c *Command) AbortOnError() *Command

Abort downloading of further videos if an error occurs

Additional information:

• See Command.UnsetAbortOnError, for unsetting the flag.
• AbortOnError maps to cli flags: --abort-on-error/--no-ignore-errors.
• From option group: "General"

func (*Command) AbortOnUnavailableFragments ¶

func (c *Command) AbortOnUnavailableFragments() *Command

Abort download if a fragment is unavailable

Additional information:

• See Command.UnsetAbortOnUnavailableFragments, for unsetting the flag.
• AbortOnUnavailableFragments maps to cli flags: --abort-on-unavailable-fragments/--no-skip-unavailable-fragments.
• From option group: "Download"

func (*Command) AddHeaders ¶

func (c *Command) AddHeaders(fieldvalue string) *Command

Specify a custom HTTP header and its value, separated by a colon ":". You can use this option multiple times

Additional information:

• See Command.UnsetAddHeaders, for unsetting the flag.
• AddHeaders maps to cli flags: --add-headers=FIELD:VALUE.
• From option group: "Workarounds"

func (*Command) AgeLimit ¶

func (c *Command) AgeLimit(years int) *Command

Download only videos suitable for the given age

Additional information:

• See Command.UnsetAgeLimit, for unsetting the flag.
• AgeLimit maps to cli flags: --age-limit=YEARS.
• From option group: "Video Selection"

func (*Command) AllowDynamicMPD ¶

func (c *Command) AllowDynamicMPD() *Command

Process dynamic DASH manifests (default)

Additional information:

• See Command.UnsetAllowDynamicMPD, for unsetting the flag.
• AllowDynamicMPD maps to cli flags: --allow-dynamic-mpd/--no-ignore-dynamic-mpd.
• From option group: "Extractor"

func (*Command) ApListMSO ¶

func (c *Command) ApListMSO() *Command

List all supported multiple-system operators

Additional information:

• See Command.UnsetApListMSO, for unsetting the flag.
• ApListMSO maps to cli flags: --ap-list-mso.
• From option group: "Authentication"

func (*Command) ApMSO ¶

func (c *Command) ApMSO(mso string) *Command

Adobe Pass multiple-system operator (TV provider) identifier, use --ap-list-mso for a list of available MSOs

Additional information:

• See Command.UnsetApMSO, for unsetting the flag.
• ApMSO maps to cli flags: --ap-mso=MSO.
• From option group: "Authentication"

func (*Command) ApPassword ¶

func (c *Command) ApPassword(password string) *Command

Multiple-system operator account password. If this option is left out, yt-dlp will ask interactively

Additional information:

• See Command.UnsetApPassword, for unsetting the flag.
• ApPassword maps to cli flags: --ap-password=PASSWORD.
• From option group: "Authentication"

func (*Command) ApUsername ¶

func (c *Command) ApUsername(username string) *Command

Multiple-system operator account login

Additional information:

• See Command.UnsetApUsername, for unsetting the flag.
• ApUsername maps to cli flags: --ap-username=USERNAME.
• From option group: "Authentication"

func (*Command) AudioFormat ¶

func (c *Command) AudioFormat(format string) *Command

Format to convert the audio to when -x is used. (currently supported: best (default), aac, alac, flac, m4a, mp3, opus, vorbis, wav). You can specify multiple rules using similar syntax as --remux-video

Additional information:

• See Command.UnsetAudioFormat, for unsetting the flag.
• AudioFormat maps to cli flags: --audio-format=FORMAT.
• From option group: "Post-Processing"

func (*Command) AudioMultistreams ¶

func (c *Command) AudioMultistreams() *Command

Allow multiple audio streams to be merged into a single file

References:

• Format Selection: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#format-selection

Additional information:

• See Command.UnsetAudioMultistreams, for unsetting the flag.
• AudioMultistreams maps to cli flags: --audio-multistreams.
• From option group: "Video Format"

func (*Command) AudioQuality ¶

func (c *Command) AudioQuality(quality string) *Command

Specify ffmpeg audio quality to use when converting the audio with -x. Insert a value between 0 (best) and 10 (worst) for VBR or a specific bitrate like 128K (default 5)

Additional information:

• See Command.UnsetAudioQuality, for unsetting the flag.
• AudioQuality maps to cli flags: --audio-quality=QUALITY.
• From option group: "Post-Processing"

func (*Command) BatchFile ¶

func (c *Command) BatchFile(file string) *Command

File containing URLs to download ("-" for stdin), one URL per line. Lines starting with "#", ";" or "]" are considered as comments and ignored

Additional information:

• See Command.UnsetBatchFile, for unsetting the flag.
• BatchFile maps to cli flags: -a/--batch-file=FILE.
• From option group: "Filesystem"

func (*Command) BidiWorkaround ¶

func (c *Command) BidiWorkaround() *Command

Work around terminals that lack bidirectional text support. Requires bidiv or fribidi executable in PATH

Additional information:

• See Command.UnsetBidiWorkaround, for unsetting the flag.
• BidiWorkaround maps to cli flags: --bidi-workaround.
• From option group: "Workarounds"

func (*Command) BreakMatchFilters ¶

func (c *Command) BreakMatchFilters(filter string) *Command

Same as "--match-filters" but stops the download process when a video is rejected

Additional information:

• See Command.UnsetBreakMatchFilters, for unsetting the flag.
• BreakMatchFilters maps to cli flags: --break-match-filters=FILTER.
• From option group: "Video Selection"

func (*Command) BreakOnExisting ¶

func (c *Command) BreakOnExisting() *Command

Stop the download process when encountering a file that is in the archive supplied with the --download-archive option

Additional information:

• See Command.UnsetBreakOnExisting, for unsetting the flag.
• BreakOnExisting maps to cli flags: --break-on-existing.
• From option group: "Video Selection"

func (*Command) BreakPerInput ¶

func (c *Command) BreakPerInput() *Command

Alters --max-downloads, --break-on-existing, --break-match-filters, and autonumber to reset per input URL

Additional information:

• See Command.UnsetBreakPerInput, for unsetting the flag.
• BreakPerInput maps to cli flags: --break-per-input.
• From option group: "Video Selection"

func (*Command) BufferSize ¶

func (c *Command) BufferSize(size string) *Command

Size of download buffer, e.g. 1024 or 16K (default is 1024)

Additional information:

• See Command.UnsetBufferSize, for unsetting the flag.
• BufferSize maps to cli flags: --buffer-size=SIZE.
• From option group: "Download"

func (*Command) BuildCommand ¶

func (c *Command) BuildCommand(ctx context.Context, args ...string) *exec.Cmd

BuildCommand builds the command to be executed. args passed here are any additional arguments to be passed to yt-dlp (commonly URLs or similar). This should not be used directly unless you want to reference the arguments passed to yt-dlp.

func (*Command) CacheDir ¶

func (c *Command) CacheDir(dir string) *Command

Location in the filesystem where yt-dlp can store some downloaded information (such as client ids and signatures) permanently. By default ${XDG_CACHE_HOME}/yt-dlp

Additional information:

• See Command.UnsetCacheDir, for unsetting the flag.
• CacheDir maps to cli flags: --cache-dir=DIR.
• From option group: "Filesystem"

func (*Command) CheckAllFormats ¶

func (c *Command) CheckAllFormats() *Command

Check all formats for whether they are actually downloadable

Additional information:

• See Command.UnsetCheckAllFormats, for unsetting the flag.
• CheckAllFormats maps to cli flags: --check-all-formats.
• From option group: "Video Format"

func (*Command) CheckFormats ¶

func (c *Command) CheckFormats() *Command

Make sure formats are selected only from those that are actually downloadable

Additional information:

• See Command.UnsetCheckFormats, for unsetting the flag.
• CheckFormats maps to cli flags: --check-formats.
• From option group: "Video Format"

func (*Command) CleanInfoJSON ¶

func (c *Command) CleanInfoJSON() *Command

Remove some internal metadata such as filenames from the infojson (default)

Additional information:

• See Command.UnsetCleanInfoJSON, for unsetting the flag.
• CleanInfoJSON maps to cli flags: --clean-info-json/--clean-infojson.
• From option group: "Filesystem"

func (*Command) ClientCertificate ¶

func (c *Command) ClientCertificate(certfile string) *Command

Path to client certificate file in PEM format. May include the private key

Additional information:

• See Command.UnsetClientCertificate, for unsetting the flag.
• ClientCertificate maps to cli flags: --client-certificate=CERTFILE.
• From option group: "Authentication"

func (*Command) ClientCertificateKey ¶

func (c *Command) ClientCertificateKey(keyfile string) *Command

Path to private key file for client certificate

Additional information:

• See Command.UnsetClientCertificateKey, for unsetting the flag.
• ClientCertificateKey maps to cli flags: --client-certificate-key=KEYFILE.
• From option group: "Authentication"

func (*Command) ClientCertificatePassword ¶

func (c *Command) ClientCertificatePassword(password string) *Command

Password for client certificate private key, if encrypted. If not provided, and the key is encrypted, yt-dlp will ask interactively

Additional information:

• See Command.UnsetClientCertificatePassword, for unsetting the flag.
• ClientCertificatePassword maps to cli flags: --client-certificate-password=PASSWORD.
• From option group: "Authentication"

func (*Command) Clone ¶

func (c *Command) Clone() *Command

Clone returns a copy of the command, with all flags, env vars, executable, working directory, etc copied over.

func (*Command) Color ¶

func (c *Command) Color(policy string) *Command

Whether to emit color codes in output, optionally prefixed by the STREAM (stdout or stderr) to apply the setting to. Can be one of "always", "auto" (default), "never", or "no_color" (use non color terminal sequences). Use "auto-tty" or "no_color-tty" to decide based on terminal support only. Can be used multiple times

Additional information:

• See Command.UnsetColor, for unsetting the flag.
• Color maps to cli flags: --color=[STREAM:]POLICY.
• From option group: "General"

func (*Command) CompatOptions ¶

func (c *Command) CompatOptions(opts string) *Command

Options that can help keep compatibility with youtube-dl or youtube-dlc configurations by reverting some of the changes made in yt-dlp. See "Differences in default behavior" for details

References:

• Compatibility Options: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#differences-in-default-behavior

Additional information:

• See Command.UnsetCompatOptions, for unsetting the flag.
• CompatOptions maps to cli flags: --compat-options=OPTS.
• From option group: "General"

func (*Command) ConcatPlaylist ¶

func (c *Command) ConcatPlaylist(policy ConcatPlaylistOption) *Command

Concatenate videos in a playlist. One of "never", "always", or "multi_video" (default; only when the videos form a single show). All the video files must have the same codecs and number of streams to be concatenable. The "pl_video:" prefix can be used with "--paths" and "--output" to set the output filename for the concatenated files. See "OUTPUT TEMPLATE" for details

References:

• Output Template: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#output-template

Additional information:

• See Command.UnsetConcatPlaylist, for unsetting the flag.
• ConcatPlaylist maps to cli flags: --concat-playlist=POLICY.
• From option group: "Post-Processing"

func (*Command) ConcurrentFragments ¶

func (c *Command) ConcurrentFragments(n int) *Command

Number of fragments of a dash/hlsnative video that should be downloaded concurrently (default is 1)

Additional information:

• See Command.UnsetConcurrentFragments, for unsetting the flag.
• ConcurrentFragments maps to cli flags: -N/--concurrent-fragments=N.
• From option group: "Download"

func (*Command) ConfigLocations ¶

func (c *Command) ConfigLocations(path string) *Command

Location of the main configuration file; either the path to the config or its containing directory ("-" for stdin). Can be used multiple times and inside other configuration files

Additional information:

• See Command.UnsetConfigLocations, for unsetting the flag.
• ConfigLocations maps to cli flags: --config-locations=PATH.
• From option group: "General"

func (*Command) ConsoleTitle ¶

func (c *Command) ConsoleTitle() *Command

Display progress in console titlebar

Additional information:

• See Command.UnsetConsoleTitle, for unsetting the flag.
• ConsoleTitle maps to cli flags: --console-title.
• From option group: "Verbosity Simulation"

func (*Command) Continue ¶

func (c *Command) Continue() *Command

Resume partially downloaded files/fragments (default)

Additional information:

• See Command.UnsetContinue, for unsetting the flag.
• Continue maps to cli flags: -c/--continue.
• From option group: "Filesystem"

func (*Command) ConvertSubs ¶

func (c *Command) ConvertSubs(format string) *Command

Convert the subtitles to another format (currently supported: ass, lrc, srt, vtt). Use "--convert-subs none" to disable conversion (default)

Additional information:

• See Command.UnsetConvertSubs, for unsetting the flag.
• ConvertSubs maps to cli flags: --convert-subs/--convert-sub/--convert-subtitles=FORMAT.
• From option group: "Post-Processing"

func (*Command) ConvertThumbnails ¶

func (c *Command) ConvertThumbnails(format string) *Command

Convert the thumbnails to another format (currently supported: jpg, png, webp). You can specify multiple rules using similar syntax as "--remux-video". Use "--convert-thumbnails none" to disable conversion (default)

Additional information:

• See Command.UnsetConvertThumbnails, for unsetting the flag.
• ConvertThumbnails maps to cli flags: --convert-thumbnails=FORMAT.
• From option group: "Post-Processing"

func (*Command) Cookies ¶

func (c *Command) Cookies(file string) *Command

Netscape formatted file to read cookies from and dump cookie jar in

Additional information:

• See Command.UnsetCookies, for unsetting the flag.
• Cookies maps to cli flags: --cookies=FILE.
• From option group: "Filesystem"

func (*Command) CookiesFromBrowser ¶

func (c *Command) CookiesFromBrowser(browser string) *Command

The name of the browser to load cookies from. Currently supported browsers are: brave, chrome, chromium, edge, firefox, opera, safari, vivaldi, whale. Optionally, the KEYRING used for decrypting Chromium cookies on Linux, the name/path of the PROFILE to load cookies from, and the CONTAINER name (if Firefox) ("none" for no container) can be given with their respective separators. By default, all containers of the most recently accessed profile are used. Currently supported keyrings are: basictext, gnomekeyring, kwallet, kwallet5, kwallet6

Additional information:

• See Command.UnsetCookiesFromBrowser, for unsetting the flag.
• CookiesFromBrowser maps to cli flags: --cookies-from-browser=BROWSER[+KEYRING][:PROFILE][::CONTAINER].
• From option group: "Filesystem"

func (*Command) Date ¶

func (c *Command) Date(date string) *Command

Download only videos uploaded on this date. The date can be "YYYYMMDD" or in the format [now|today|yesterday][-N[day|week|month|year]]. E.g. "--date today-2weeks" downloads only videos uploaded on the same day two weeks ago

Additional information:

• See Command.UnsetDate, for unsetting the flag.
• Date maps to cli flags: --date=DATE.
• From option group: "Video Selection"

func (*Command) DateAfter ¶

func (c *Command) DateAfter(date string) *Command

Download only videos uploaded on or after this date. The date formats accepted are the same as --date

Additional information:

• See Command.UnsetDateAfter, for unsetting the flag.
• DateAfter maps to cli flags: --dateafter=DATE.
• From option group: "Video Selection"

func (*Command) DateBefore ¶

func (c *Command) DateBefore(date string) *Command

Download only videos uploaded on or before this date. The date formats accepted are the same as --date

Additional information:

• See Command.UnsetDateBefore, for unsetting the flag.
• DateBefore maps to cli flags: --datebefore=DATE.
• From option group: "Video Selection"

func (*Command) DefaultSearch ¶

func (c *Command) DefaultSearch(prefix string) *Command

Use this prefix for unqualified URLs. E.g. "gvsearch2:python" downloads two videos from google videos for the search term "python". Use the value "auto" to let yt-dlp guess ("auto_warning" to emit a warning when guessing). "error" just throws an error. The default value "fixup_error" repairs broken URLs, but emits an error if this is not possible instead of searching

Additional information:

• See Command.UnsetDefaultSearch, for unsetting the flag.
• DefaultSearch maps to cli flags: --default-search=PREFIX.
• From option group: "General"

func (*Command) DownloadArchive ¶

func (c *Command) DownloadArchive(file string) *Command

Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it

Additional information:

• See Command.UnsetDownloadArchive, for unsetting the flag.
• DownloadArchive maps to cli flags: --download-archive=FILE.
• From option group: "Video Selection"

func (*Command) DownloadSections ¶

func (c *Command) DownloadSections(regex string) *Command

Download only chapters that match the regular expression. A "*" prefix denotes time-range instead of chapter. Negative timestamps are calculated from the end. "*from-url" can be used to download between the "start_time" and "end_time" extracted from the URL. Needs ffmpeg. This option can be used multiple times to download multiple sections, e.g. --download-sections "*10:15-inf" --download-sections "intro"

Additional information:

• See Command.UnsetDownloadSections, for unsetting the flag.
• DownloadSections maps to cli flags: --download-sections=REGEX.
• From option group: "Download"

func (*Command) Downloader ¶

func (c *Command) Downloader(name string) *Command

Name or path of the external downloader to use (optionally) prefixed by the protocols (http, ftp, m3u8, dash, rstp, rtmp, mms) to use it for. Currently supports native, aria2c, axel, curl, ffmpeg, httpie, wget. You can use this option multiple times to set different downloaders for different protocols. E.g. --downloader aria2c --downloader "dash,m3u8:native" will use aria2c for http/ftp downloads, and the native downloader for dash/m3u8 downloads

Additional information:

• See Command.UnsetDownloader, for unsetting the flag.
• Downloader maps to cli flags: --downloader/--external-downloader=[PROTO:]NAME.
• From option group: "Download"

func (*Command) DownloaderArgs ¶

func (c *Command) DownloaderArgs(nameargs string) *Command

Give these arguments to the external downloader. Specify the downloader name and the arguments separated by a colon ":". For ffmpeg, arguments can be passed to different positions using the same syntax as --postprocessor-args. You can use this option multiple times to give different arguments to different downloaders

Additional information:

• See Command.UnsetDownloaderArgs, for unsetting the flag.
• DownloaderArgs maps to cli flags: --downloader-args/--external-downloader-args=NAME:ARGS.
• From option group: "Download"

func (*Command) DumpJSON ¶

func (c *Command) DumpJSON() *Command

Quiet, but print JSON information for each video. Simulate unless --no-simulate is used. See "OUTPUT TEMPLATE" for a description of available keys

References:

• Output Template: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#output-template

Additional information:

• See Command.UnsetDumpJSON, for unsetting the flag.
• DumpJSON maps to cli flags: -j/--dump-json.
• From option group: "Verbosity Simulation"

func (*Command) DumpPages ¶

func (c *Command) DumpPages() *Command

Print downloaded pages encoded using base64 to debug problems (very verbose)

Additional information:

• See Command.UnsetDumpPages, for unsetting the flag.
• DumpPages maps to cli flags: --dump-pages.
• From option group: "Verbosity Simulation"

func (*Command) DumpSingleJSON ¶

func (c *Command) DumpSingleJSON() *Command

Quiet, but print JSON information for each URL or infojson passed. Simulate unless --no-simulate is used. If the URL refers to a playlist, the whole playlist information is dumped in a single line

Additional information:

• See Command.UnsetDumpSingleJSON, for unsetting the flag.
• DumpSingleJSON maps to cli flags: -J/--dump-single-json.
• From option group: "Verbosity Simulation"

func (*Command) EmbedChapters ¶

func (c *Command) EmbedChapters() *Command

Add chapter markers to the video file

Additional information:

• See Command.UnsetEmbedChapters, for unsetting the flag.
• EmbedChapters maps to cli flags: --embed-chapters/--add-chapters.
• From option group: "Post-Processing"

func (*Command) EmbedInfoJSON ¶

func (c *Command) EmbedInfoJSON() *Command

Embed the infojson as an attachment to mkv/mka video files

Additional information:

• See Command.UnsetEmbedInfoJSON, for unsetting the flag.
• EmbedInfoJSON maps to cli flags: --embed-info-json.
• From option group: "Post-Processing"

func (*Command) EmbedMetadata ¶

func (c *Command) EmbedMetadata() *Command

Embed metadata to the video file. Also embeds chapters/infojson if present unless --no-embed-chapters/--no-embed-info-json are used

Additional information:

• See Command.UnsetEmbedMetadata, for unsetting the flag.
• EmbedMetadata maps to cli flags: --embed-metadata/--add-metadata.
• From option group: "Post-Processing"

func (*Command) EmbedSubs ¶

func (c *Command) EmbedSubs() *Command

Embed subtitles in the video (only for mp4, webm and mkv videos)

Additional information:

• See Command.UnsetEmbedSubs, for unsetting the flag.
• EmbedSubs maps to cli flags: --embed-subs.
• From option group: "Post-Processing"

func (*Command) EmbedThumbnail ¶

func (c *Command) EmbedThumbnail() *Command

Embed thumbnail in the video as cover art

Additional information:

• See Command.UnsetEmbedThumbnail, for unsetting the flag.
• EmbedThumbnail maps to cli flags: --embed-thumbnail.
• From option group: "Post-Processing"

func (*Command) EnableFileURLs ¶

func (c *Command) EnableFileURLs() *Command

Enable file:// URLs. This is disabled by default for security reasons.

Additional information:

• See Command.UnsetEnableFileURLs, for unsetting the flag.
• EnableFileURLs maps to cli flags: --enable-file-urls.
• From option group: "Network"

func (*Command) Encoding ¶

func (c *Command) Encoding(encoding string) *Command

Force the specified encoding (experimental)

Additional information:

• See Command.UnsetEncoding, for unsetting the flag.
• Encoding maps to cli flags: --encoding=ENCODING.
• From option group: "Workarounds"

func (*Command) Exec ¶

func (c *Command) Exec(cmd string) *Command

Execute a command, optionally prefixed with when to execute it, separated by a ":". Supported values of "WHEN" are the same as that of --use-postprocessor (default: after_move). The same syntax as the output template can be used to pass any field as arguments to the command. If no fields are passed, %(filepath,_filename|)q is appended to the end of the command. This option can be used multiple times

Additional information:

• See Command.UnsetExec, for unsetting the flag.
• Exec maps to cli flags: --exec=[WHEN:]CMD.
• From option group: "Post-Processing"

func (*Command) ExtractAudio ¶

func (c *Command) ExtractAudio() *Command

Convert video files to audio-only files (requires ffmpeg and ffprobe)

Additional information:

• See Command.UnsetExtractAudio, for unsetting the flag.
• ExtractAudio maps to cli flags: -x/--extract-audio.
• From option group: "Post-Processing"

func (*Command) ExtractorArgs ¶

func (c *Command) ExtractorArgs(ieKeyargs string) *Command

Pass ARGS arguments to the IE_KEY extractor. See "EXTRACTOR ARGUMENTS" for details. You can use this option multiple times to give arguments for different extractors

References:

• Extractor Arguments: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#extractor-arguments

Additional information:

• See Command.UnsetExtractorArgs, for unsetting the flag.
• ExtractorArgs maps to cli flags: --extractor-args=IE_KEY:ARGS.
• From option group: "Extractor"

func (*Command) ExtractorDescriptions ¶

func (c *Command) ExtractorDescriptions(ctx context.Context) (*Result, error)

Output descriptions of all supported extractors and exit

Additional information:

• ExtractorDescriptions maps to cli flags: --extractor-descriptions.
• From option group: "General"

func (*Command) ExtractorRetries ¶

func (c *Command) ExtractorRetries(retries string) *Command

Number of retries for known extractor errors (default is 3), or "infinite"

Additional information:

• See Command.UnsetExtractorRetries, for unsetting the flag.
• ExtractorRetries maps to cli flags: --extractor-retries=RETRIES.
• From option group: "Extractor"

func (*Command) FFmpegLocation ¶

func (c *Command) FFmpegLocation(path string) *Command

Location of the ffmpeg binary; either the path to the binary or its containing directory

Additional information:

• See Command.UnsetFFmpegLocation, for unsetting the flag.
• FFmpegLocation maps to cli flags: --ffmpeg-location=PATH.
• From option group: "Post-Processing"

func (*Command) FileAccessRetries ¶

func (c *Command) FileAccessRetries(retries string) *Command

Number of times to retry on file access error (default is 3), or "infinite"

Additional information:

• See Command.UnsetFileAccessRetries, for unsetting the flag.
• FileAccessRetries maps to cli flags: --file-access-retries=RETRIES.
• From option group: "Download"

func (*Command) Fixup ¶

func (c *Command) Fixup(policy FixupOption) *Command

Automatically correct known faults of the file. One of never (do nothing), warn (only emit a warning), detect_or_warn (the default; fix the file if we can, warn otherwise), force (try fixing even if the file already exists)

Additional information:

• See Command.UnsetFixup, for unsetting the flag.
• Fixup maps to cli flags: --fixup=POLICY.
• From option group: "Post-Processing"

func (*Command) FlatPlaylist ¶

func (c *Command) FlatPlaylist() *Command

Do not extract a playlist's URL result entries; some entry metadata may be missing and downloading may be bypassed

Additional information:

• See Command.UnsetFlatPlaylist, for unsetting the flag.
• FlatPlaylist maps to cli flags: --flat-playlist.
• From option group: "General"

func (*Command) ForceIPv4 ¶

func (c *Command) ForceIPv4() *Command

Make all connections via IPv4

Additional information:

• See Command.UnsetForceIPv4, for unsetting the flag.
• ForceIPv4 maps to cli flags: -4/--force-ipv4.
• From option group: "Network"

func (*Command) ForceIPv6 ¶

func (c *Command) ForceIPv6() *Command

Make all connections via IPv6

Additional information:

• See Command.UnsetForceIPv6, for unsetting the flag.
• ForceIPv6 maps to cli flags: -6/--force-ipv6.
• From option group: "Network"

func (*Command) ForceKeyframesAtCuts ¶

func (c *Command) ForceKeyframesAtCuts() *Command

Force keyframes at cuts when downloading/splitting/removing sections. This is slow due to needing a re-encode, but the resulting video may have fewer artifacts around the cuts

Additional information:

• See Command.UnsetForceKeyframesAtCuts, for unsetting the flag.
• ForceKeyframesAtCuts maps to cli flags: --force-keyframes-at-cuts.
• From option group: "Post-Processing"

func (*Command) ForceOverwrites ¶

func (c *Command) ForceOverwrites() *Command

Overwrite all video and metadata files. This option includes --no-continue

Additional information:

• See Command.UnsetForceOverwrites, for unsetting the flag.
• ForceOverwrites maps to cli flags: --force-overwrites/--yes-overwrites.
• From option group: "Filesystem"

func (*Command) ForceWriteArchive ¶

func (c *Command) ForceWriteArchive() *Command

Force download archive entries to be written as far as no errors occur, even if -s or another simulation option is used

Additional information:

• See Command.UnsetForceWriteArchive, for unsetting the flag.
• ForceWriteArchive maps to cli flags: --force-write-archive/--force-write-download-archive/--force-download-archive.
• From option group: "Verbosity Simulation"

func (*Command) Format ¶

func (c *Command) Format(format string) *Command

Video format code, see "FORMAT SELECTION" for more details

References:

• Format Selection: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#format-selection
• Filter Formatting: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#filtering-formats
• Format Selection Examples: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#format-selection-examples

Additional information:

• See Command.UnsetFormat, for unsetting the flag.
• Format maps to cli flags: -f/--format=FORMAT.
• From option group: "Video Format"

func (*Command) FormatSort ¶

func (c *Command) FormatSort(sortorder string) *Command

Sort the formats by the fields given, see "Sorting Formats" for more details

References:

• Sorting Formats: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#sorting-formats
• Format Selection Examples: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#format-selection-examples

Additional information:

• See Command.UnsetFormatSort, for unsetting the flag.
• FormatSort maps to cli flags: -S/--format-sort=SORTORDER.
• From option group: "Video Format"

func (*Command) FormatSortForce ¶

func (c *Command) FormatSortForce() *Command

Force user specified sort order to have precedence over all fields, see "Sorting Formats" for more details

References:

• Sorting Formats: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#sorting-formats

Additional information:

• See Command.UnsetFormatSortForce, for unsetting the flag.
• FormatSortForce maps to cli flags: --format-sort-force/--S-force=FORMAT.
• From option group: "Video Format"

func (*Command) FragmentRetries ¶

func (c *Command) FragmentRetries(retries string) *Command

Number of retries for a fragment (default is 10), or "infinite" (DASH, hlsnative and ISM)

Additional information:

• See Command.UnsetFragmentRetries, for unsetting the flag.
• FragmentRetries maps to cli flags: --fragment-retries=RETRIES.
• From option group: "Download"

func (*Command) GeoVerificationProxy ¶

func (c *Command) GeoVerificationProxy(url string) *Command

Use this proxy to verify the IP address for some geo-restricted sites. The default proxy specified by --proxy (or none, if the option is not present) is used for the actual downloading

Additional information:

• See Command.UnsetGeoVerificationProxy, for unsetting the flag.
• GeoVerificationProxy maps to cli flags: --geo-verification-proxy=URL.
• From option group: "Geo-restriction"

func (*Command) GetFlagConfig ¶

func (c *Command) GetFlagConfig() *FlagConfig

GetFlagConfig returns a copy of the flag config.

func (*Command) HLSSplitDiscontinuity ¶

func (c *Command) HLSSplitDiscontinuity() *Command

Split HLS playlists to different formats at discontinuities such as ad breaks

Additional information:

• See Command.UnsetHLSSplitDiscontinuity, for unsetting the flag.
• HLSSplitDiscontinuity maps to cli flags: --hls-split-discontinuity.
• From option group: "Extractor"

func (*Command) HLSUseMPEGTS ¶

func (c *Command) HLSUseMPEGTS() *Command

Use the mpegts container for HLS videos; allowing some players to play the video while downloading, and reducing the chance of file corruption if download is interrupted. This is enabled by default for live streams

Additional information:

• See Command.UnsetHLSUseMPEGTS, for unsetting the flag.
• HLSUseMPEGTS maps to cli flags: --hls-use-mpegts.
• From option group: "Download"

func (*Command) HTTPChunkSize ¶

func (c *Command) HTTPChunkSize(size string) *Command

Size of a chunk for chunk-based HTTP downloading, e.g. 10485760 or 10M (default is disabled). May be useful for bypassing bandwidth throttling imposed by a webserver (experimental)

Additional information:

• See Command.UnsetHTTPChunkSize, for unsetting the flag.
• HTTPChunkSize maps to cli flags: --http-chunk-size=SIZE.
• From option group: "Download"

func (*Command) IgnoreConfig ¶

func (c *Command) IgnoreConfig() *Command

Don't load any more configuration files except those given to --config-locations. For backward compatibility, if this option is found inside the system configuration file, the user configuration is not loaded.

Additional information:

• See Command.UnsetIgnoreConfig, for unsetting the flag.
• IgnoreConfig maps to cli flags: --ignore-config/--no-config.
• From option group: "General"

func (*Command) IgnoreDynamicMPD ¶

func (c *Command) IgnoreDynamicMPD() *Command

Do not process dynamic DASH manifests

Additional information:

• See Command.UnsetIgnoreDynamicMPD, for unsetting the flag.
• IgnoreDynamicMPD maps to cli flags: --ignore-dynamic-mpd/--no-allow-dynamic-mpd.
• From option group: "Extractor"

func (*Command) IgnoreErrors ¶

func (c *Command) IgnoreErrors() *Command

Ignore download and postprocessing errors. The download will be considered successful even if the postprocessing fails

Additional information:

• See Command.UnsetIgnoreErrors, for unsetting the flag.
• IgnoreErrors maps to cli flags: -i/--ignore-errors.
• From option group: "General"

func (*Command) IgnoreNoFormatsError ¶

func (c *Command) IgnoreNoFormatsError() *Command

Ignore "No video formats" error. Useful for extracting metadata even if the videos are not actually available for download (experimental)

Additional information:

• See Command.UnsetIgnoreNoFormatsError, for unsetting the flag.
• IgnoreNoFormatsError maps to cli flags: --ignore-no-formats-error.
• From option group: "Verbosity Simulation"

func (*Command) Impersonate ¶

func (c *Command) Impersonate(client string) *Command

Client to impersonate for requests. E.g. chrome, chrome-110, chrome:windows-10. Pass --impersonate="" to impersonate any client. Note that forcing impersonation for all requests may have a detrimental impact on download speed and stability

Additional information:

• See Command.UnsetImpersonate, for unsetting the flag.
• Impersonate maps to cli flags: --impersonate=CLIENT[:OS].
• From option group: "Network"

func (*Command) JsRuntimes ¶

func (c *Command) JsRuntimes(runtime string) *Command

Additional JavaScript runtime to enable, with an optional location for the runtime (either the path to the binary or its containing directory). This option can be used multiple times to enable multiple runtimes. Supported runtimes are (in order of priority, from highest to lowest): deno, node, quickjs, bun. Only "deno" is enabled by default. The highest priority runtime that is both enabled and available will be used. In order to use a lower priority runtime when "deno" is available, --no-js-runtimes needs to be passed before enabling other runtimes

Additional information:

• See Command.UnsetJsRuntimes, for unsetting the flag.
• JsRuntimes maps to cli flags: --js-runtimes=RUNTIME[:PATH].
• From option group: "General"

func (*Command) KeepFragments ¶

func (c *Command) KeepFragments() *Command

Keep downloaded fragments on disk after downloading is finished

Additional information:

• See Command.UnsetKeepFragments, for unsetting the flag.
• KeepFragments maps to cli flags: --keep-fragments.
• From option group: "Download"

func (*Command) KeepVideo ¶

func (c *Command) KeepVideo() *Command

Keep the intermediate video file on disk after post-processing

Additional information:

• See Command.UnsetKeepVideo, for unsetting the flag.
• KeepVideo maps to cli flags: -k/--keep-video.
• From option group: "Post-Processing"

func (*Command) LazyPlaylist ¶

func (c *Command) LazyPlaylist() *Command

Process entries in the playlist as they are received. This disables n_entries, --playlist-random and --playlist-reverse

Additional information:

• See Command.UnsetLazyPlaylist, for unsetting the flag.
• LazyPlaylist maps to cli flags: --lazy-playlist.
• From option group: "Download"

func (*Command) LegacyServerConnect ¶

func (c *Command) LegacyServerConnect() *Command

Explicitly allow HTTPS connection to servers that do not support RFC 5746 secure renegotiation

Additional information:

• See Command.UnsetLegacyServerConnect, for unsetting the flag.
• LegacyServerConnect maps to cli flags: --legacy-server-connect.
• From option group: "Workarounds"

func (*Command) LimitRate ¶

func (c *Command) LimitRate(rate string) *Command

Maximum download rate in bytes per second, e.g. 50K or 4.2M

Additional information:

• See Command.UnsetLimitRate, for unsetting the flag.
• LimitRate maps to cli flags: -r/--limit-rate/--rate-limit=RATE.
• From option group: "Download"

func (*Command) ListExtractors ¶

func (c *Command) ListExtractors(ctx context.Context) (*Result, error)

List all supported extractors and exit

Additional information:

• ListExtractors maps to cli flags: --list-extractors.
• From option group: "General"

func (*Command) ListImpersonateTargets ¶

func (c *Command) ListImpersonateTargets() *Command

List available clients to impersonate.

Additional information:

• See Command.UnsetListImpersonateTargets, for unsetting the flag.
• ListImpersonateTargets maps to cli flags: --list-impersonate-targets.
• From option group: "Network"

func (*Command) ListSubs ¶

func (c *Command) ListSubs() *Command

List available subtitles of each video. Simulate unless --no-simulate is used

Additional information:

• See Command.UnsetListSubs, for unsetting the flag.
• ListSubs maps to cli flags: --list-subs.
• From option group: "Subtitle"

func (*Command) LiveFromStart ¶

func (c *Command) LiveFromStart() *Command

Download livestreams from the start. Currently experimental and only supported for YouTube and Twitch

Additional information:

• See Command.UnsetLiveFromStart, for unsetting the flag.
• LiveFromStart maps to cli flags: --live-from-start.
• From option group: "General"

func (*Command) LoadInfoJSON ¶

func (c *Command) LoadInfoJSON(file string) *Command

JSON file containing the video information (created with the "--write-info-json" option)

Additional information:

• See Command.UnsetLoadInfoJSON, for unsetting the flag.
• LoadInfoJSON maps to cli flags: --load-info-json=FILE.
• From option group: "Filesystem"

func (*Command) MarkWatched ¶

func (c *Command) MarkWatched() *Command

Mark videos watched (even with --simulate)

Additional information:

• See Command.UnsetMarkWatched, for unsetting the flag.
• MarkWatched maps to cli flags: --mark-watched.
• From option group: "General"

func (*Command) MatchFilters ¶

func (c *Command) MatchFilters(filter string) *Command

Generic video filter. Any "OUTPUT TEMPLATE" field can be compared with a number or a string using the operators defined in "Filtering Formats". You can also simply specify a field to match if the field is present, use "!field" to check if the field is not present, and "&" to check multiple conditions. Use a "\" to escape "&" or quotes if needed. If used multiple times, the filter matches if at least one of the conditions is met. E.g. --match-filters !is_live --match-filters "like_count>?100 & description~='(?i)\bcats \& dogs\b'" matches only videos that are not live OR those that have a like count more than 100 (or the like field is not available) and also has a description that contains the phrase "cats & dogs" (caseless). Use "--match-filters -" to interactively ask whether to download each video

Additional information:

• See Command.UnsetMatchFilters, for unsetting the flag.
• MatchFilters maps to cli flags: --match-filters=FILTER.
• From option group: "Video Selection"

func (*Command) MaxDownloads ¶

func (c *Command) MaxDownloads(number int) *Command

Abort after downloading NUMBER files

Additional information:

• See Command.UnsetMaxDownloads, for unsetting the flag.
• MaxDownloads maps to cli flags: --max-downloads=NUMBER.
• From option group: "Video Selection"

func (*Command) MaxFileSize ¶

func (c *Command) MaxFileSize(size string) *Command

Abort download if filesize is larger than SIZE, e.g. 50k or 44.6M

Additional information:

• See Command.UnsetMaxFileSize, for unsetting the flag.
• MaxFileSize maps to cli flags: --max-filesize=SIZE.
• From option group: "Video Selection"

func (*Command) MaxSleepInterval ¶

func (c *Command) MaxSleepInterval(seconds float64) *Command

Maximum number of seconds to sleep. Can only be used along with --min-sleep-interval

Additional information:

• See Command.UnsetMaxSleepInterval, for unsetting the flag.
• MaxSleepInterval maps to cli flags: --max-sleep-interval=SECONDS.
• From option group: "Workarounds"

func (*Command) MergeOutputFormat ¶

func (c *Command) MergeOutputFormat(format string) *Command

Containers that may be used when merging formats, separated by "/", e.g. "mp4/mkv". Ignored if no merge is required. (currently supported: avi, flv, mkv, mov, mp4, webm)

Additional information:

• See Command.UnsetMergeOutputFormat, for unsetting the flag.
• MergeOutputFormat maps to cli flags: --merge-output-format=FORMAT.
• From option group: "Video Format"

func (*Command) MinFileSize ¶

func (c *Command) MinFileSize(size string) *Command

Abort download if filesize is smaller than SIZE, e.g. 50k or 44.6M

Additional information:

• See Command.UnsetMinFileSize, for unsetting the flag.
• MinFileSize maps to cli flags: --min-filesize=SIZE.
• From option group: "Video Selection"

func (*Command) Mtime ¶

func (c *Command) Mtime() *Command

Use the Last-modified header to set the file modification time

Additional information:

• See Command.UnsetMtime, for unsetting the flag.
• Mtime maps to cli flags: --mtime.
• From option group: "Filesystem"

func (*Command) Netrc ¶

func (c *Command) Netrc() *Command

Use .netrc authentication data

Additional information:

• See Command.UnsetNetrc, for unsetting the flag.
• Netrc maps to cli flags: -n/--netrc.
• From option group: "Authentication"

func (*Command) NetrcCmd ¶

func (c *Command) NetrcCmd(netrcCmd string) *Command

Command to execute to get the credentials for an extractor.

Additional information:

• See Command.UnsetNetrcCmd, for unsetting the flag.
• NetrcCmd maps to cli flags: --netrc-cmd=NETRC_CMD.
• From option group: "Authentication"

func (*Command) NetrcLocation ¶

func (c *Command) NetrcLocation(path string) *Command

Location of .netrc authentication data; either the path or its containing directory. Defaults to ~/.netrc

Additional information:

• See Command.UnsetNetrcLocation, for unsetting the flag.
• NetrcLocation maps to cli flags: --netrc-location=PATH.
• From option group: "Authentication"

func (*Command) Newline ¶

func (c *Command) Newline() *Command

Output progress bar as new lines

Additional information:

• See Command.UnsetNewline, for unsetting the flag.
• Newline maps to cli flags: --newline.
• From option group: "Verbosity Simulation"

func (*Command) NoAbortOnError ¶

func (c *Command) NoAbortOnError() *Command

Continue with next video on download errors; e.g. to skip unavailable videos in a playlist (default)

Additional information:

• See Command.UnsetAbortOnError, for unsetting the flag.
• NoAbortOnError maps to cli flags: --no-abort-on-error.
• From option group: "General"

func (*Command) NoAudioMultistreams ¶

func (c *Command) NoAudioMultistreams() *Command

Only one audio stream is downloaded for each output file (default)

Additional information:

• See Command.UnsetAudioMultistreams, for unsetting the flag.
• NoAudioMultistreams maps to cli flags: --no-audio-multistreams.
• From option group: "Video Format"

func (*Command) NoBatchFile ¶

func (c *Command) NoBatchFile() *Command

Do not read URLs from batch file (default)

Additional information:

• See Command.UnsetBatchFile, for unsetting the flag.
• NoBatchFile maps to cli flags: --no-batch-file.
• From option group: "Filesystem"

func (*Command) NoBreakMatchFilters ¶

func (c *Command) NoBreakMatchFilters() *Command

Do not use any --break-match-filters (default)

Additional information:

• See Command.UnsetBreakMatchFilters, for unsetting the flag.
• NoBreakMatchFilters maps to cli flags: --no-break-match-filters.
• From option group: "Video Selection"

func (*Command) NoBreakOnExisting ¶

func (c *Command) NoBreakOnExisting() *Command

Do not stop the download process when encountering a file that is in the archive (default)

Additional information:

• See Command.UnsetBreakOnExisting, for unsetting the flag.
• NoBreakOnExisting maps to cli flags: --no-break-on-existing.
• From option group: "Video Selection"

func (*Command) NoBreakPerInput ¶

func (c *Command) NoBreakPerInput() *Command

--break-on-existing and similar options terminates the entire download queue

Additional information:

• See Command.UnsetBreakPerInput, for unsetting the flag.
• NoBreakPerInput maps to cli flags: --no-break-per-input.
• From option group: "Video Selection"

func (*Command) NoCacheDir ¶

func (c *Command) NoCacheDir() *Command

Disable filesystem caching

Additional information:

• See Command.UnsetCacheDir, for unsetting the flag.
• NoCacheDir maps to cli flags: --no-cache-dir.
• From option group: "Filesystem"

func (*Command) NoCheckCertificates ¶

func (c *Command) NoCheckCertificates() *Command

Suppress HTTPS certificate validation

Additional information:

• See Command.UnsetCheckCertificates, for unsetting the flag.
• NoCheckCertificates maps to cli flags: --no-check-certificates.
• From option group: "Workarounds"

func (*Command) NoCheckFormats ¶

func (c *Command) NoCheckFormats() *Command

Do not check that the formats are actually downloadable

Additional information:

• See Command.UnsetCheckFormats, for unsetting the flag.
• NoCheckFormats maps to cli flags: --no-check-formats.
• From option group: "Video Format"

func (*Command) NoCleanInfoJSON ¶

func (c *Command) NoCleanInfoJSON() *Command

Write all fields to the infojson

Additional information:

• See Command.UnsetCleanInfoJSON, for unsetting the flag.
• NoCleanInfoJSON maps to cli flags: --no-clean-info-json/--no-clean-infojson.
• From option group: "Filesystem"

func (*Command) NoConfigLocations ¶

func (c *Command) NoConfigLocations() *Command

Do not load any custom configuration files (default). When given inside a configuration file, ignore all previous --config-locations defined in the current file

Additional information:

• See Command.UnsetConfigLocations, for unsetting the flag.
• NoConfigLocations maps to cli flags: --no-config-locations.
• From option group: "General"

func (*Command) NoContinue ¶

func (c *Command) NoContinue() *Command

Do not resume partially downloaded fragments. If the file is not fragmented, restart download of the entire file

Additional information:

• See Command.UnsetContinue, for unsetting the flag.
• NoContinue maps to cli flags: --no-continue.
• From option group: "Filesystem"

func (*Command) NoCookies ¶

func (c *Command) NoCookies() *Command

Do not read/dump cookies from/to file (default)

Additional information:

• See Command.UnsetCookies, for unsetting the flag.
• NoCookies maps to cli flags: --no-cookies=FILE.
• From option group: "Filesystem"

func (*Command) NoCookiesFromBrowser ¶

func (c *Command) NoCookiesFromBrowser() *Command

Do not load cookies from browser (default)

Additional information:

• See Command.UnsetCookiesFromBrowser, for unsetting the flag.
• NoCookiesFromBrowser maps to cli flags: --no-cookies-from-browser.
• From option group: "Filesystem"

func (*Command) NoDownloadArchive ¶

func (c *Command) NoDownloadArchive() *Command

Do not use archive file (default)

Additional information:

• See Command.UnsetDownloadArchive, for unsetting the flag.
• NoDownloadArchive maps to cli flags: --no-download-archive.
• From option group: "Video Selection"

func (*Command) NoEmbedChapters ¶

func (c *Command) NoEmbedChapters() *Command

Do not add chapter markers (default)

Additional information:

• See Command.UnsetEmbedChapters, for unsetting the flag.
• NoEmbedChapters maps to cli flags: --no-embed-chapters/--no-add-chapters.
• From option group: "Post-Processing"

func (*Command) NoEmbedInfoJSON ¶

func (c *Command) NoEmbedInfoJSON() *Command

Do not embed the infojson as an attachment to the video file

Additional information:

• See Command.UnsetEmbedInfoJSON, for unsetting the flag.
• NoEmbedInfoJSON maps to cli flags: --no-embed-info-json.
• From option group: "Post-Processing"

func (*Command) NoEmbedMetadata ¶

func (c *Command) NoEmbedMetadata() *Command

Do not add metadata to file (default)

Additional information:

• See Command.UnsetEmbedMetadata, for unsetting the flag.
• NoEmbedMetadata maps to cli flags: --no-embed-metadata/--no-add-metadata.
• From option group: "Post-Processing"

func (*Command) NoEmbedSubs ¶

func (c *Command) NoEmbedSubs() *Command

Do not embed subtitles (default)

Additional information:

• See Command.UnsetEmbedSubs, for unsetting the flag.
• NoEmbedSubs maps to cli flags: --no-embed-subs.
• From option group: "Post-Processing"

func (*Command) NoEmbedThumbnail ¶

func (c *Command) NoEmbedThumbnail() *Command

Do not embed thumbnail (default)

Additional information:

• See Command.UnsetEmbedThumbnail, for unsetting the flag.
• NoEmbedThumbnail maps to cli flags: --no-embed-thumbnail.
• From option group: "Post-Processing"

func (*Command) NoExec ¶

func (c *Command) NoExec() *Command

Remove any previously defined --exec

Additional information:

• See Command.UnsetExec, for unsetting the flag.
• NoExec maps to cli flags: --no-exec.
• From option group: "Post-Processing"

func (*Command) NoFlatPlaylist ¶

func (c *Command) NoFlatPlaylist() *Command

Fully extract the videos of a playlist (default)

Additional information:

• See Command.UnsetFlatPlaylist, for unsetting the flag.
• NoFlatPlaylist maps to cli flags: --no-flat-playlist.
• From option group: "General"

func (*Command) NoForceKeyframesAtCuts ¶

func (c *Command) NoForceKeyframesAtCuts() *Command

Do not force keyframes around the chapters when cutting/splitting (default)

Additional information:

• See Command.UnsetForceKeyframesAtCuts, for unsetting the flag.
• NoForceKeyframesAtCuts maps to cli flags: --no-force-keyframes-at-cuts.
• From option group: "Post-Processing"

func (*Command) NoForceOverwrites ¶

func (c *Command) NoForceOverwrites() *Command

Do not overwrite the video, but overwrite related files (default)

Additional information:

• See Command.UnsetForceOverwrites, for unsetting the flag.
• NoForceOverwrites maps to cli flags: --no-force-overwrites.
• From option group: "Filesystem"

func (*Command) NoFormatSortForce ¶

func (c *Command) NoFormatSortForce() *Command

Some fields have precedence over the user specified sort order (default)

Additional information:

• See Command.UnsetFormatSortForce, for unsetting the flag.
• NoFormatSortForce maps to cli flags: --no-format-sort-force=FORMAT.
• From option group: "Video Format"

func (*Command) NoHLSSplitDiscontinuity ¶

func (c *Command) NoHLSSplitDiscontinuity() *Command

Do not split HLS playlists into different formats at discontinuities such as ad breaks (default)

Additional information:

• See Command.UnsetHLSSplitDiscontinuity, for unsetting the flag.
• NoHLSSplitDiscontinuity maps to cli flags: --no-hls-split-discontinuity.
• From option group: "Extractor"

func (*Command) NoHLSUseMPEGTS ¶

func (c *Command) NoHLSUseMPEGTS() *Command

Do not use the mpegts container for HLS videos. This is default when not downloading live streams

Additional information:

• See Command.UnsetHLSUseMPEGTS, for unsetting the flag.
• NoHLSUseMPEGTS maps to cli flags: --no-hls-use-mpegts.
• From option group: "Download"

func (*Command) NoIgnoreNoFormatsError ¶

func (c *Command) NoIgnoreNoFormatsError() *Command

Throw error when no downloadable video formats are found (default)

Additional information:

• See Command.UnsetIgnoreNoFormatsError, for unsetting the flag.
• NoIgnoreNoFormatsError maps to cli flags: --no-ignore-no-formats-error.
• From option group: "Verbosity Simulation"

func (*Command) NoJsRuntimes ¶

func (c *Command) NoJsRuntimes() *Command

Clear JavaScript runtimes to enable, including defaults and those provided by previous --js-runtimes

Additional information:

• See Command.UnsetJsRuntimes, for unsetting the flag.
• NoJsRuntimes maps to cli flags: --no-js-runtimes.
• From option group: "General"

func (*Command) NoKeepFragments ¶

func (c *Command) NoKeepFragments() *Command

Delete downloaded fragments after downloading is finished (default)

Additional information:

• See Command.UnsetKeepFragments, for unsetting the flag.
• NoKeepFragments maps to cli flags: --no-keep-fragments.
• From option group: "Download"

func (*Command) NoKeepVideo ¶

func (c *Command) NoKeepVideo() *Command

Delete the intermediate video file after post-processing (default)

Additional information:

• See Command.UnsetKeepVideo, for unsetting the flag.
• NoKeepVideo maps to cli flags: --no-keep-video.
• From option group: "Post-Processing"

func (*Command) NoLazyPlaylist ¶

func (c *Command) NoLazyPlaylist() *Command

Process videos in the playlist only after the entire playlist is parsed (default)

Additional information:

• See Command.UnsetLazyPlaylist, for unsetting the flag.
• NoLazyPlaylist maps to cli flags: --no-lazy-playlist.
• From option group: "Download"

func (*Command) NoLiveFromStart ¶

func (c *Command) NoLiveFromStart() *Command

Download livestreams from the current time (default)

Additional information:

• See Command.UnsetLiveFromStart, for unsetting the flag.
• NoLiveFromStart maps to cli flags: --no-live-from-start.
• From option group: "General"

func (*Command) NoMarkWatched ¶

func (c *Command) NoMarkWatched() *Command

Do not mark videos watched (default)

Additional information:

• See Command.UnsetMarkWatched, for unsetting the flag.
• NoMarkWatched maps to cli flags: --no-mark-watched.
• From option group: "General"

func (*Command) NoMatchFilters ¶

func (c *Command) NoMatchFilters() *Command

Do not use any --match-filters (default)

Additional information:

• See Command.UnsetMatchFilters, for unsetting the flag.
• NoMatchFilters maps to cli flags: --no-match-filters.
• From option group: "Video Selection"

func (*Command) NoMtime ¶

func (c *Command) NoMtime() *Command

Do not use the Last-modified header to set the file modification time (default)

Additional information:

• See Command.UnsetMtime, for unsetting the flag.
• NoMtime maps to cli flags: --no-mtime.
• From option group: "Filesystem"

func (*Command) NoOverwrites ¶

func (c *Command) NoOverwrites() *Command

Do not overwrite any files

Additional information:

• See Command.UnsetOverwrites, for unsetting the flag.
• NoOverwrites maps to cli flags: -w/--no-overwrites.
• From option group: "Filesystem"

func (*Command) NoPart ¶

func (c *Command) NoPart() *Command

Do not use .part files - write directly into output file

Additional information:

• See Command.UnsetPart, for unsetting the flag.
• NoPart maps to cli flags: --no-part.
• From option group: "Filesystem"

func (*Command) NoPlaylist ¶

func (c *Command) NoPlaylist() *Command

Download only the video, if the URL refers to a video and a playlist

Additional information:

• See Command.UnsetPlaylist, for unsetting the flag.
• NoPlaylist maps to cli flags: --no-playlist.
• From option group: "Video Selection"

func (*Command) NoPluginDirs ¶

func (c *Command) NoPluginDirs() *Command

Clear plugin directories to search, including defaults and those provided by previous --plugin-dirs

Additional information:

• See Command.UnsetPluginDirs, for unsetting the flag.
• NoPluginDirs maps to cli flags: --no-plugin-dirs.
• From option group: "General"

func (*Command) NoPostOverwrites ¶

func (c *Command) NoPostOverwrites() *Command

Do not overwrite post-processed files

Additional information:

• See Command.UnsetPostOverwrites, for unsetting the flag.
• NoPostOverwrites maps to cli flags: --no-post-overwrites.
• From option group: "Post-Processing"

func (*Command) NoPreferFreeFormats ¶

func (c *Command) NoPreferFreeFormats() *Command

Don't give any special preference to free containers (default)

Additional information:

• See Command.UnsetPreferFreeFormats, for unsetting the flag.
• NoPreferFreeFormats maps to cli flags: --no-prefer-free-formats.
• From option group: "Video Format"

func (*Command) NoProgress ¶

func (c *Command) NoProgress() *Command

Do not print progress bar

Additional information:

• See Command.UnsetProgress, for unsetting the flag.
• NoProgress maps to cli flags: --no-progress.
• From option group: "Verbosity Simulation"

func (*Command) NoQuiet ¶

func (c *Command) NoQuiet() *Command

Deactivate quiet mode. (Default)

Additional information:

• See Command.UnsetQuiet, for unsetting the flag.
• NoQuiet maps to cli flags: --no-quiet.
• From option group: "Verbosity Simulation"

func (*Command) NoRemoteComponents ¶

func (c *Command) NoRemoteComponents() *Command

Disallow fetching of all remote components, including any previously allowed by --remote-components or defaults.

Additional information:

• See Command.UnsetRemoteComponents, for unsetting the flag.
• NoRemoteComponents maps to cli flags: --no-remote-components.
• From option group: "General"

func (*Command) NoRemoveChapters ¶

func (c *Command) NoRemoveChapters() *Command

Do not remove any chapters from the file (default)

Additional information:

• See Command.UnsetRemoveChapters, for unsetting the flag.
• NoRemoveChapters maps to cli flags: --no-remove-chapters.
• From option group: "Post-Processing"

func (*Command) NoResizeBuffer ¶

func (c *Command) NoResizeBuffer() *Command

Do not automatically adjust the buffer size

Additional information:

• See Command.UnsetResizeBuffer, for unsetting the flag.
• NoResizeBuffer maps to cli flags: --no-resize-buffer.
• From option group: "Download"

func (*Command) NoRestrictFilenames ¶

func (c *Command) NoRestrictFilenames() *Command

Allow Unicode characters, "&" and spaces in filenames (default)

Additional information:

• See Command.UnsetRestrictFilenames, for unsetting the flag.
• NoRestrictFilenames maps to cli flags: --no-restrict-filenames.
• From option group: "Filesystem"

func (*Command) NoSimulate ¶

func (c *Command) NoSimulate() *Command

Download the video even if printing/listing options are used

Additional information:

• See Command.UnsetSimulate, for unsetting the flag.
• NoSimulate maps to cli flags: --no-simulate.
• From option group: "Verbosity Simulation"

func (*Command) NoSplitChapters ¶

func (c *Command) NoSplitChapters() *Command

Do not split video based on chapters (default)

Additional information:

• See Command.UnsetSplitChapters, for unsetting the flag.
• NoSplitChapters maps to cli flags: --no-split-chapters/--no-split-tracks.
• From option group: "Post-Processing"

func (*Command) NoSponsorblock ¶

func (c *Command) NoSponsorblock() *Command

Disable both --sponsorblock-mark and --sponsorblock-remove

Additional information:

• See Command.UnsetSponsorblock, for unsetting the flag.
• NoSponsorblock maps to cli flags: --no-sponsorblock.
• From option group: "SponsorBlock"

func (*Command) NoUpdate ¶

func (c *Command) NoUpdate() *Command

Do not check for updates (default)

Additional information:

• See Command.UnsetUpdate, for unsetting the flag.
• NoUpdate maps to cli flags: --no-update.
• From option group: "General"

func (*Command) NoVideoMultistreams ¶

func (c *Command) NoVideoMultistreams() *Command

Only one video stream is downloaded for each output file (default)

Additional information:

• See Command.UnsetVideoMultistreams, for unsetting the flag.
• NoVideoMultistreams maps to cli flags: --no-video-multistreams.
• From option group: "Video Format"

func (*Command) NoWaitForVideo ¶

func (c *Command) NoWaitForVideo() *Command

Do not wait for scheduled streams (default)

Additional information:

• See Command.UnsetWaitForVideo, for unsetting the flag.
• NoWaitForVideo maps to cli flags: --no-wait-for-video.
• From option group: "General"

func (*Command) NoWarnings ¶

func (c *Command) NoWarnings() *Command

Ignore warnings

Additional information:

• See Command.UnsetWarnings, for unsetting the flag.
• NoWarnings maps to cli flags: --no-warnings.
• From option group: "Verbosity Simulation"

func (*Command) NoWindowsFilenames ¶

func (c *Command) NoWindowsFilenames() *Command

Sanitize filenames only minimally

Additional information:

• See Command.UnsetWindowsFilenames, for unsetting the flag.
• NoWindowsFilenames maps to cli flags: --no-windows-filenames.
• From option group: "Filesystem"

func (*Command) NoWriteAutoSubs ¶

func (c *Command) NoWriteAutoSubs() *Command

Do not write auto-generated subtitles (default)

Additional information:

• See Command.UnsetWriteAutoSubs, for unsetting the flag.
• NoWriteAutoSubs maps to cli flags: --no-write-auto-subs/--no-write-automatic-subs.
• From option group: "Subtitle"

func (*Command) NoWriteComments ¶

func (c *Command) NoWriteComments() *Command

Do not retrieve video comments unless the extraction is known to be quick

Additional information:

• See Command.UnsetWriteComments, for unsetting the flag.
• NoWriteComments maps to cli flags: --no-write-comments/--no-get-comments.
• From option group: "Filesystem"

func (*Command) NoWriteDescription ¶

func (c *Command) NoWriteDescription() *Command

Do not write video description (default)

Additional information:

• See Command.UnsetWriteDescription, for unsetting the flag.
• NoWriteDescription maps to cli flags: --no-write-description.
• From option group: "Filesystem"

func (*Command) NoWriteInfoJSON ¶

func (c *Command) NoWriteInfoJSON() *Command

Do not write video metadata (default)

Additional information:

• See Command.UnsetWriteInfoJSON, for unsetting the flag.
• NoWriteInfoJSON maps to cli flags: --no-write-info-json.
• From option group: "Filesystem"

func (*Command) NoWritePlaylistMetafiles ¶

func (c *Command) NoWritePlaylistMetafiles() *Command

Do not write playlist metadata when using --write-info-json, --write-description etc.

Additional information:

• See Command.UnsetWritePlaylistMetafiles, for unsetting the flag.
• NoWritePlaylistMetafiles maps to cli flags: --no-write-playlist-metafiles.
• From option group: "Filesystem"

func (*Command) NoWriteSubs ¶

func (c *Command) NoWriteSubs() *Command

Do not write subtitle file (default)

Additional information:

• See Command.UnsetWriteSubs, for unsetting the flag.
• NoWriteSubs maps to cli flags: --no-write-subs/--no-write-srt.
• From option group: "Subtitle"

func (*Command) NoWriteThumbnail ¶

func (c *Command) NoWriteThumbnail() *Command

Do not write thumbnail image to disk (default)

Additional information:

• See Command.UnsetWriteThumbnail, for unsetting the flag.
• NoWriteThumbnail maps to cli flags: --no-write-thumbnail.
• From option group: "Thumbnail"

func (*Command) Output ¶

func (c *Command) Output(template string) *Command

Output filename template; see "OUTPUT TEMPLATE" for details

References:

• Output Template: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#output-template

Additional information:

• See Command.UnsetOutput, for unsetting the flag.
• Output maps to cli flags: -o/--output=[TYPES:]TEMPLATE.
• From option group: "Filesystem"

func (*Command) OutputNaPlaceholder ¶

func (c *Command) OutputNaPlaceholder(text string) *Command

Placeholder for unavailable fields in --output (default: "NA")

Additional information:

• See Command.UnsetOutputNaPlaceholder, for unsetting the flag.
• OutputNaPlaceholder maps to cli flags: --output-na-placeholder=TEXT.
• From option group: "Filesystem"

func (*Command) ParseMetadata ¶

func (c *Command) ParseMetadata(fromto string) *Command

Parse additional metadata like title/artist from other fields; see "MODIFYING METADATA" for details. Supported values of "WHEN" are the same as that of --use-postprocessor (default: pre_process)

References:

• Modifying Metadata: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#modifying-metadata
• Modifying Metadata Examples: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#modifying-metadata-examples

Additional information:

• See Command.UnsetParseMetadata, for unsetting the flag.
• ParseMetadata maps to cli flags: --parse-metadata=[WHEN:]FROM:TO.
• From option group: "Post-Processing"

func (*Command) Part ¶

func (c *Command) Part() *Command

Use .part files instead of writing directly into output file (default)

Additional information:

• See Command.UnsetPart, for unsetting the flag.
• Part maps to cli flags: --part.
• From option group: "Filesystem"

func (*Command) Password ¶

func (c *Command) Password(password string) *Command

Account password. If this option is left out, yt-dlp will ask interactively

Additional information:

• See Command.UnsetPassword, for unsetting the flag.
• Password maps to cli flags: -p/--password=PASSWORD.
• From option group: "Authentication"

func (*Command) Paths ¶

func (c *Command) Paths(path string) *Command

The paths where the files should be downloaded. Specify the type of file and the path separated by a colon ":". All the same TYPES as --output are supported. Additionally, you can also provide "home" (default) and "temp" paths. All intermediary files are first downloaded to the temp path and then the final files are moved over to the home path after download is finished. This option is ignored if --output is an absolute path

Additional information:

• See Command.UnsetPaths, for unsetting the flag.
• Paths maps to cli flags: -P/--paths=[TYPES:]PATH.
• From option group: "Filesystem"

func (*Command) PlaylistItems ¶

func (c *Command) PlaylistItems(itemSpec string) *Command

Comma-separated playlist_index of the items to download. You can specify a range using "[START]:[STOP][:STEP]". For backward compatibility, START-STOP is also supported. Use negative indices to count from the right and negative STEP to download in reverse order. E.g. "-I 1:3,7,-5::2" used on a playlist of size 15 will download the items at index 1,2,3,7,11,13,15

Additional information:

• See Command.UnsetPlaylistItems, for unsetting the flag.
• PlaylistItems maps to cli flags: -I/--playlist-items=ITEM_SPEC.
• From option group: "Video Selection"

func (*Command) PlaylistRandom ¶

func (c *Command) PlaylistRandom() *Command

Download playlist videos in random order

Additional information:

• See Command.UnsetPlaylistRandom, for unsetting the flag.
• PlaylistRandom maps to cli flags: --playlist-random.
• From option group: "Download"

func (*Command) PluginDirs ¶

func (c *Command) PluginDirs(dir string) *Command

Path to an additional directory to search for plugins. This option can be used multiple times to add multiple directories. Use "default" to search the default plugin directories (default)

Additional information:

• See Command.UnsetPluginDirs, for unsetting the flag.
• PluginDirs maps to cli flags: --plugin-dirs=DIR.
• From option group: "General"

func (*Command) PostOverwrites ¶

func (c *Command) PostOverwrites() *Command

Overwrite post-processed files (default)

Additional information:

• See Command.UnsetPostOverwrites, for unsetting the flag.
• PostOverwrites maps to cli flags: --post-overwrites.
• From option group: "Post-Processing"

func (*Command) PostProcessorArgs ¶

func (c *Command) PostProcessorArgs(nameargs string) *Command

Give these arguments to the postprocessors. Specify the postprocessor/executable name and the arguments separated by a colon ":" to give the argument to the specified postprocessor/executable. Supported PP are: Merger, ModifyChapters, SplitChapters, ExtractAudio, VideoRemuxer, VideoConvertor, Metadata, EmbedSubtitle, EmbedThumbnail, SubtitlesConvertor, ThumbnailsConvertor, FixupStretched, FixupM4a, FixupM3u8, FixupTimestamp and FixupDuration. The supported executables are: AtomicParsley, FFmpeg and FFprobe. You can also specify "PP+EXE:ARGS" to give the arguments to the specified executable only when being used by the specified postprocessor. Additionally, for ffmpeg/ffprobe, "_i"/"_o" can be appended to the prefix optionally followed by a number to pass the argument before the specified input/output file, e.g. --ppa "Merger+ffmpeg_i1:-v quiet". You can use this option multiple times to give different arguments to different postprocessors.

Additional information:

• See Command.UnsetPostProcessorArgs, for unsetting the flag.
• PostProcessorArgs maps to cli flags: --postprocessor-args/--ppa=NAME:ARGS.
• From option group: "Post-Processing"

func (*Command) PreferFreeFormats ¶

func (c *Command) PreferFreeFormats() *Command

Prefer video formats with free containers over non-free ones of the same quality. Use with "-S ext" to strictly prefer free containers irrespective of quality

Additional information:

• See Command.UnsetPreferFreeFormats, for unsetting the flag.
• PreferFreeFormats maps to cli flags: --prefer-free-formats.
• From option group: "Video Format"

func (*Command) PreferInsecure ¶

func (c *Command) PreferInsecure() *Command

Use an unencrypted connection to retrieve information about the video (Currently supported only for YouTube)

Additional information:

• See Command.UnsetPreferInsecure, for unsetting the flag.
• PreferInsecure maps to cli flags: --prefer-insecure/--prefer-unsecure.
• From option group: "Workarounds"

func (*Command) PresetAlias ¶

func (c *Command) PresetAlias(preset string) *Command

Applies a predefined set of options. e.g. --preset-alias mp3. The following presets are available: mp3, aac, mp4, mkv, sleep. See the "Preset Aliases" section at the end for more info. This option can be used multiple times

Additional information:

• See Command.UnsetPresetAlias, for unsetting the flag.
• PresetAlias maps to cli flags: -t/--preset-alias=PRESET.
• From option group: "General"

func (*Command) Print ¶

func (c *Command) Print(template string) *Command

Field name or output template to print to screen, optionally prefixed with when to print it, separated by a ":". Supported values of "WHEN" are the same as that of --use-postprocessor (default: video). Implies --quiet. Implies --simulate unless --no-simulate or later stages of WHEN are used. This option can be used multiple times

Additional information:

• See Command.UnsetPrint, for unsetting the flag.
• Print maps to cli flags: -O/--print=[WHEN:]TEMPLATE.
• From option group: "Verbosity Simulation"

func (*Command) PrintJSON ¶

func (c *Command) PrintJSON() *Command

PrintJSON sets the "print-json" flag (no description specified).

Additional information:

• See Command.UnsetPrintJSON, for unsetting the flag.
• PrintJSON maps to cli flags: --print-json (hidden).
• From option group: "Verbosity Simulation"

func (*Command) PrintToFile ¶

func (c *Command) PrintToFile(template, file string) *Command

Append given template to the file. The values of WHEN and TEMPLATE are the same as that of --print. FILE uses the same syntax as the output template. This option can be used multiple times

Additional information:

• See Command.UnsetPrintToFile, for unsetting the flag.
• PrintToFile maps to cli flags: --print-to-file=[WHEN:]TEMPLATE FILE.
• From option group: "Verbosity Simulation"

func (*Command) PrintTraffic ¶

func (c *Command) PrintTraffic() *Command

Display sent and read HTTP traffic

Additional information:

• See Command.UnsetPrintTraffic, for unsetting the flag.
• PrintTraffic maps to cli flags: --print-traffic.
• From option group: "Verbosity Simulation"

func (*Command) Progress ¶

func (c *Command) Progress() *Command

Show progress bar, even if in quiet mode

Additional information:

• See Command.UnsetProgress, for unsetting the flag.
• Progress maps to cli flags: --progress.
• From option group: "Verbosity Simulation"

func (*Command) ProgressDelta ¶

func (c *Command) ProgressDelta(seconds float64) *Command

Time between progress output (default: 0)

Additional information:

• See Command.UnsetProgressDelta, for unsetting the flag.
• ProgressDelta maps to cli flags: --progress-delta=SECONDS.
• From option group: "Verbosity Simulation"

func (*Command) ProgressFunc ¶

func (c *Command) ProgressFunc(frequency time.Duration, fn ProgressCallbackFunc) *Command

ProgressFunc can be used to register a callback function that will be called when yt-dlp sends progress updates. The callback function will be called with any information that yt-dlp is able to provide, including sending separate updates for each file, playlist, etc that may be downloaded.

• See Command.UnsetProgressFunc, for unsetting the progress function.

func (*Command) ProgressTemplate ¶

func (c *Command) ProgressTemplate(template string) *Command

Template for progress outputs, optionally prefixed with one of "download:" (default), "download-title:" (the console title), "postprocess:", or "postprocess-title:". The video's fields are accessible under the "info" key and the progress attributes are accessible under "progress" key. E.g. --console-title --progress-template "download-title:%(info.id)s-%(progress.eta)s"

Additional information:

• See Command.UnsetProgressTemplate, for unsetting the flag.
• ProgressTemplate maps to cli flags: --progress-template=[TYPES:]TEMPLATE.
• From option group: "Verbosity Simulation"

func (*Command) Proxy ¶

func (c *Command) Proxy(url string) *Command

Use the specified HTTP/HTTPS/SOCKS proxy. To enable SOCKS proxy, specify a proper scheme, e.g. socks5://user:pass@127.0.0.1:1080/. Pass in an empty string (--proxy "") for direct connection

Additional information:

• See Command.UnsetProxy, for unsetting the flag.
• Proxy maps to cli flags: --proxy=URL.
• From option group: "Network"

func (*Command) Quiet ¶

func (c *Command) Quiet() *Command

Activate quiet mode. If used with --verbose, print the log to stderr

Additional information:

• See Command.UnsetQuiet, for unsetting the flag.
• Quiet maps to cli flags: -q/--quiet.
• From option group: "Verbosity Simulation"

func (*Command) RecodeVideo ¶

func (c *Command) RecodeVideo(format string) *Command

Re-encode the video into another format if necessary. The syntax and supported formats are the same as --remux-video

Additional information:

• See Command.UnsetRecodeVideo, for unsetting the flag.
• RecodeVideo maps to cli flags: --recode-video=FORMAT.
• From option group: "Post-Processing"

func (*Command) RemoteComponents ¶

func (c *Command) RemoteComponents(component string) *Command

Remote components to allow yt-dlp to fetch when required. This option is currently not needed if you are using an official executable or have the requisite version of the yt-dlp-ejs package installed. You can use this option multiple times to allow multiple components. Supported values: ejs:npm (external JavaScript components from npm), ejs:github (external JavaScript components from yt-dlp-ejs GitHub). By default, no remote components are allowed

Additional information:

• See Command.UnsetRemoteComponents, for unsetting the flag.
• RemoteComponents maps to cli flags: --remote-components=COMPONENT.
• From option group: "General"

func (*Command) RemoveChapters ¶

func (c *Command) RemoveChapters(regex string) *Command

Remove chapters whose title matches the given regular expression. The syntax is the same as --download-sections. This option can be used multiple times

Additional information:

• See Command.UnsetRemoveChapters, for unsetting the flag.
• RemoveChapters maps to cli flags: --remove-chapters=REGEX.
• From option group: "Post-Processing"

func (*Command) RemuxVideo ¶

func (c *Command) RemuxVideo(format string) *Command

Remux the video into another container if necessary (currently supported: avi, flv, gif, mkv, mov, mp4, webm, aac, aiff, alac, flac, m4a, mka, mp3, ogg, opus, vorbis, wav). If the target container does not support the video/audio codec, remuxing will fail. You can specify multiple rules; e.g. "aac>m4a/mov>mp4/mkv" will remux aac to m4a, mov to mp4 and anything else to mkv

Additional information:

• See Command.UnsetRemuxVideo, for unsetting the flag.
• RemuxVideo maps to cli flags: --remux-video=FORMAT.
• From option group: "Post-Processing"

func (*Command) ReplaceInMetadata ¶

func (c *Command) ReplaceInMetadata(fields, regex, replace string) *Command

Replace text in a metadata field using the given regex. This option can be used multiple times. Supported values of "WHEN" are the same as that of --use-postprocessor (default: pre_process)

References:

• Modifying Metadata: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#modifying-metadata
• Modifying Metadata Examples: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#modifying-metadata-examples

Additional information:

• See Command.UnsetReplaceInMetadata, for unsetting the flag.
• ReplaceInMetadata maps to cli flags: --replace-in-metadata=[WHEN:]FIELDS REGEX REPLACE.
• From option group: "Post-Processing"

func (*Command) ResizeBuffer ¶

func (c *Command) ResizeBuffer() *Command

The buffer size is automatically resized from an initial value of --buffer-size (default)

Additional information:

• See Command.UnsetResizeBuffer, for unsetting the flag.
• ResizeBuffer maps to cli flags: --resize-buffer.
• From option group: "Download"

func (*Command) RestrictFilenames ¶

func (c *Command) RestrictFilenames() *Command

Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames

Additional information:

• See Command.UnsetRestrictFilenames, for unsetting the flag.
• RestrictFilenames maps to cli flags: --restrict-filenames.
• From option group: "Filesystem"

func (*Command) Retries ¶

func (c *Command) Retries(retries string) *Command

Number of retries (default is 10), or "infinite"

Additional information:

• See Command.UnsetRetries, for unsetting the flag.
• Retries maps to cli flags: -R/--retries=RETRIES.
• From option group: "Download"

func (*Command) RetrySleep ¶

func (c *Command) RetrySleep(expr string) *Command

Time to sleep between retries in seconds (optionally) prefixed by the type of retry (http (default), fragment, file_access, extractor) to apply the sleep to. EXPR can be a number, linear=START[:END[:STEP=1]] or exp=START[:END[:BASE=2]]. This option can be used multiple times to set the sleep for the different retry types, e.g. --retry-sleep linear=1::2 --retry-sleep fragment:exp=1:20

Additional information:

• See Command.UnsetRetrySleep, for unsetting the flag.
• RetrySleep maps to cli flags: --retry-sleep=[TYPE:]EXPR.
• From option group: "Download"

func (*Command) RmCacheDir ¶

func (c *Command) RmCacheDir() *Command

Delete all filesystem cache files

Additional information:

• See Command.UnsetRmCacheDir, for unsetting the flag.
• RmCacheDir maps to cli flags: --rm-cache-dir.
• From option group: "Filesystem"

func (*Command) Run ¶

func (c *Command) Run(ctx context.Context, args ...string) (*Result, error)

Run invokes yt-dlp with the provided arguments (and any flags previously set), and returns the results (stdout/stderr, exit code, etc). args should be the URLs that would normally be passed in to yt-dlp.

func (*Command) SetCancelMaxWait ¶

func (c *Command) SetCancelMaxWait(value time.Duration) *Command

SetCancelMaxWait sets the maximum wait time before the command is killed, after the context is cancelled. Defaults to 1 second.

func (*Command) SetEnvVar ¶

func (c *Command) SetEnvVar(key, value string) *Command

SetEnvVar sets an environment variable for the command. If value is empty, it will be removed. If the key is "PATH", it will be merged with the parent process's PATH, (where explicit values provided here will take precedence). See also [SetEnvVarInherit].

func (*Command) SetEnvVarInherit ¶

func (c *Command) SetEnvVarInherit(enabled bool) *Command

SetEnvVarInherit sets whether the command should inherit environment variables from the parent process. If enabled, the command will inherit the parent process's environment variables, and any environment variables set with [SetEnvVar] will be merged with the parent process's environment variables. If disabled, the command will only use the environment variables set with [SetEnvVar] (with the exception of PATH). Explicitly set env vars with [SetEnvVar] will always take precedence over the parent process's environment variables.

func (*Command) SetExecutable ¶

func (c *Command) SetExecutable(path string) *Command

SetExecutable sets the executable path to yt-dlp for the command.

func (*Command) SetFlagConfig ¶

func (c *Command) SetFlagConfig(flagConfig *FlagConfig) *Command

SetFlagConfig sets the flag config for the command, overriding ALL previously set flags. If nil is provided, a new empty flag config will be used.

func (*Command) SetSeparateProcessGroup ¶

func (c *Command) SetSeparateProcessGroup(value bool) *Command

SetSeparateProcessGroup sets whether the command should be run in a separate process group. This is useful to avoid propagating signals from the app process. NOTE: This is only supported on Windows and Unix-like systems.

func (*Command) SetWorkDir ¶

func (c *Command) SetWorkDir(path string) *Command

SetWorkDir sets the working directory for the command. Defaults to current working directory.

func (*Command) Simulate ¶

func (c *Command) Simulate() *Command

Do not download the video and do not write anything to disk

Additional information:

• See Command.UnsetSimulate, for unsetting the flag.
• Simulate maps to cli flags: -s/--simulate.
• From option group: "Verbosity Simulation"

func (*Command) SkipDownload ¶

func (c *Command) SkipDownload() *Command

Do not download the video but write all related files

Additional information:

• See Command.UnsetSkipDownload, for unsetting the flag.
• SkipDownload maps to cli flags: --skip-download/--no-download.
• From option group: "Verbosity Simulation"

func (*Command) SkipPlaylistAfterErrors ¶

func (c *Command) SkipPlaylistAfterErrors(n int) *Command

Number of allowed failures until the rest of the playlist is skipped

Additional information:

• See Command.UnsetSkipPlaylistAfterErrors, for unsetting the flag.
• SkipPlaylistAfterErrors maps to cli flags: --skip-playlist-after-errors=N.
• From option group: "Video Selection"

func (*Command) SkipUnavailableFragments ¶

func (c *Command) SkipUnavailableFragments() *Command

Skip unavailable fragments for DASH, hlsnative and ISM downloads (default)

Additional information:

• See Command.UnsetSkipUnavailableFragments, for unsetting the flag.
• SkipUnavailableFragments maps to cli flags: --skip-unavailable-fragments/--no-abort-on-unavailable-fragments.
• From option group: "Download"

func (*Command) SleepInterval ¶

func (c *Command) SleepInterval(seconds float64) *Command

Number of seconds to sleep before each download. This is the minimum time to sleep when used along with --max-sleep-interval

Additional information:

• See Command.UnsetSleepInterval, for unsetting the flag.
• SleepInterval maps to cli flags: --sleep-interval/--min-sleep-interval=SECONDS.
• From option group: "Workarounds"

func (*Command) SleepRequests ¶

func (c *Command) SleepRequests(seconds float64) *Command

Number of seconds to sleep between requests during data extraction

Additional information:

• See Command.UnsetSleepRequests, for unsetting the flag.
• SleepRequests maps to cli flags: --sleep-requests=SECONDS.
• From option group: "Workarounds"

func (*Command) SleepSubtitles ¶

func (c *Command) SleepSubtitles(seconds int) *Command

Number of seconds to sleep before each subtitle download

Additional information:

• See Command.UnsetSleepSubtitles, for unsetting the flag.
• SleepSubtitles maps to cli flags: --sleep-subtitles=SECONDS.
• From option group: "Workarounds"

func (*Command) SocketTimeout ¶

func (c *Command) SocketTimeout(seconds float64) *Command

Time to wait before giving up, in seconds

Additional information:

• See Command.UnsetSocketTimeout, for unsetting the flag.
• SocketTimeout maps to cli flags: --socket-timeout=SECONDS.
• From option group: "Network"

func (*Command) SourceAddress ¶

func (c *Command) SourceAddress(ip string) *Command

Client-side IP address to bind to

Additional information:

• See Command.UnsetSourceAddress, for unsetting the flag.
• SourceAddress maps to cli flags: --source-address=IP.
• From option group: "Network"

func (*Command) SplitChapters ¶

func (c *Command) SplitChapters() *Command

Split video into multiple files based on internal chapters. The "chapter:" prefix can be used with "--paths" and "--output" to set the output filename for the split files. See "OUTPUT TEMPLATE" for details

References:

• Output Template: https://github.com/yt-dlp/yt-dlp/blob/2025.12.08/README.md#output-template

Additional information:

• See Command.UnsetSplitChapters, for unsetting the flag.
• SplitChapters maps to cli flags: --split-chapters/--split-tracks.
• From option group: "Post-Processing"

func (*Command) SponsorblockAPI ¶

func (c *Command) SponsorblockAPI(url string) *Command

SponsorBlock API location, defaults to https://sponsor.ajay.app

Additional information:

• See Command.UnsetSponsorblockAPI, for unsetting the flag.
• SponsorblockAPI maps to cli flags: --sponsorblock-api=URL.
• From option group: "SponsorBlock"

func (*Command) SponsorblockChapterTitle ¶

func (c *Command) SponsorblockChapterTitle(template string) *Command

An output template for the title of the SponsorBlock chapters created by --sponsorblock-mark. The only available fields are start_time, end_time, category, categories, name, category_names. Defaults to "[SponsorBlock]: %(category_names)l"

Additional information:

• See Command.UnsetSponsorblockChapterTitle, for unsetting the flag.
• SponsorblockChapterTitle maps to cli flags: --sponsorblock-chapter-title=TEMPLATE.
• From option group: "SponsorBlock"

func (*Command) SponsorblockMark ¶

func (c *Command) SponsorblockMark(cats string) *Command

SponsorBlock categories to create chapters for, separated by commas. Available categories are sponsor, intro, outro, selfpromo, preview, filler, interaction, music_offtopic, hook, poi_highlight, chapter, all and default (=all). You can prefix the category with a "-" to exclude it. See [1] for descriptions of the categories. E.g. --sponsorblock-mark all,-preview [1] https://wiki.sponsor.ajay.app/w/Segment_Categories

Additional information:

• See Command.UnsetSponsorblockMark, for unsetting the flag.
• SponsorblockMark maps to cli flags: --sponsorblock-mark=CATS.
• From option group: "SponsorBlock"

func (*Command) SponsorblockRemove ¶

func (c *Command) SponsorblockRemove(cats string) *Command

SponsorBlock categories to be removed from the video file, separated by commas. If a category is present in both mark and remove, remove takes precedence. The syntax and available categories are the same as for --sponsorblock-mark except that "default" refers to "all,-filler" and poi_highlight, chapter are not available

Additional information:

• See Command.UnsetSponsorblockRemove, for unsetting the flag.
• SponsorblockRemove maps to cli flags: --sponsorblock-remove=CATS.
• From option group: "SponsorBlock"

func (*Command) SubFormat ¶

func (c *Command) SubFormat(format string) *Command

Subtitle format; accepts formats preference separated by "/", e.g. "srt" or "ass/srt/best"

Additional information:

• See Command.UnsetSubFormat, for unsetting the flag.
• SubFormat maps to cli flags: --sub-format=FORMAT.
• From option group: "Subtitle"

func (*Command) SubLangs ¶

func (c *Command) SubLangs(langs string) *Command

Languages of the subtitles to download (can be regex) or "all" separated by commas, e.g. --sub-langs "en.*,ja" (where "en.*" is a regex pattern that matches "en" followed by 0 or more of any character). You can prefix the language code with a "-" to exclude it from the requested languages, e.g. --sub-langs all,-live_chat. Use --list-subs for a list of available language tags

Additional information:

• See Command.UnsetSubLangs, for unsetting the flag.
• SubLangs maps to cli flags: --sub-langs/--srt-langs=LANGS.
• From option group: "Subtitle"

func (*Command) ThrottledRate ¶

func (c *Command) ThrottledRate(rate string) *Command

Minimum download rate in bytes per second below which throttling is assumed and the video data is re-extracted, e.g. 100K

Additional information:

• See Command.UnsetThrottledRate, for unsetting the flag.
• ThrottledRate maps to cli flags: --throttled-rate=RATE.
• From option group: "Download"

func (*Command) TrimFilenames ¶

func (c *Command) TrimFilenames(length int) *Command

Limit the filename length (excluding extension) to the specified number of characters

Additional information:

• See Command.UnsetTrimFilenames, for unsetting the flag.
• TrimFilenames maps to cli flags: --trim-filenames/--trim-file-names=LENGTH.
• From option group: "Filesystem"

func (*Command) TwoFactor ¶

func (c *Command) TwoFactor(twofactor string) *Command

Two-factor authentication code

Additional information:

• See Command.UnsetTwoFactor, for unsetting the flag.
• TwoFactor maps to cli flags: -2/--twofactor=TWOFACTOR.
• From option group: "Authentication"

func (*Command) UnsetAbortOnError ¶

func (c *Command) UnsetAbortOnError() *Command

UnsetAbortOnError unsets any flags that were previously set by one of:

• Command.NoAbortOnError
• Command.AbortOnError

func (*Command) UnsetAbortOnUnavailableFragments ¶

func (c *Command) UnsetAbortOnUnavailableFragments() *Command

UnsetAbortOnUnavailableFragments unsets any flags that were previously set by one of:

• Command.AbortOnUnavailableFragments

func (*Command) UnsetAddHeaders ¶

func (c *Command) UnsetAddHeaders() *Command

UnsetAddHeaders unsets any flags that were previously set by one of:

• Command.AddHeaders

func (*Command) UnsetAgeLimit ¶

func (c *Command) UnsetAgeLimit() *Command

UnsetAgeLimit unsets any flags that were previously set by one of:

• Command.AgeLimit

func (*Command) UnsetAllowDynamicMPD ¶

func (c *Command) UnsetAllowDynamicMPD() *Command

UnsetAllowDynamicMPD unsets any flags that were previously set by one of:

• Command.AllowDynamicMPD

func (*Command) UnsetApListMSO ¶

func (c *Command) UnsetApListMSO() *Command

UnsetApListMSO unsets any flags that were previously set by one of:

• Command.ApListMSO

func (*Command) UnsetApMSO ¶

func (c *Command) UnsetApMSO() *Command

UnsetApMSO unsets any flags that were previously set by one of:

• Command.ApMSO

func (*Command) UnsetApPassword ¶

func (c *Command) UnsetApPassword() *Command

UnsetApPassword unsets any flags that were previously set by one of:

• Command.ApPassword

func (*Command) UnsetApUsername ¶

func (c *Command) UnsetApUsername() *Command

UnsetApUsername unsets any flags that were previously set by one of:

• Command.ApUsername

func (*Command) UnsetAudioFormat ¶

func (c *Command) UnsetAudioFormat() *Command

UnsetAudioFormat unsets any flags that were previously set by one of:

• Command.AudioFormat

func (*Command) UnsetAudioMultistreams ¶

func (c *Command) UnsetAudioMultistreams() *Command

UnsetAudioMultistreams unsets any flags that were previously set by one of:

• Command.AudioMultistreams
• Command.NoAudioMultistreams

func (*Command) UnsetAudioQuality ¶

func (c *Command) UnsetAudioQuality() *Command

UnsetAudioQuality unsets any flags that were previously set by one of:

• Command.AudioQuality

func (*Command) UnsetBatchFile ¶

func (c *Command) UnsetBatchFile() *Command

UnsetBatchFile unsets any flags that were previously set by one of:

• Command.BatchFile
• Command.NoBatchFile

func (*Command) UnsetBidiWorkaround ¶

func (c *Command) UnsetBidiWorkaround() *Command

UnsetBidiWorkaround unsets any flags that were previously set by one of:

• Command.BidiWorkaround

func (*Command) UnsetBreakMatchFilters ¶

func (c *Command) UnsetBreakMatchFilters() *Command

UnsetBreakMatchFilters unsets any flags that were previously set by one of:

• Command.BreakMatchFilters
• Command.NoBreakMatchFilters

func (*Command) UnsetBreakOnExisting ¶

func (c *Command) UnsetBreakOnExisting() *Command

UnsetBreakOnExisting unsets any flags that were previously set by one of:

• Command.BreakOnExisting
• Command.NoBreakOnExisting

func (*Command) UnsetBreakPerInput ¶

func (c *Command) UnsetBreakPerInput() *Command

UnsetBreakPerInput unsets any flags that were previously set by one of:

• Command.BreakPerInput
• Command.NoBreakPerInput

func (*Command) UnsetBufferSize ¶

func (c *Command) UnsetBufferSize() *Command

UnsetBufferSize unsets any flags that were previously set by one of:

• Command.BufferSize

func (*Command) UnsetCacheDir ¶

func (c *Command) UnsetCacheDir() *Command

UnsetCacheDir unsets any flags that were previously set by one of:

• Command.CacheDir
• Command.NoCacheDir

func (*Command) UnsetCheckAllFormats ¶

func (c *Command) UnsetCheckAllFormats() *Command

UnsetCheckAllFormats unsets any flags that were previously set by one of:

• Command.CheckAllFormats

func (*Command) UnsetCheckCertificates ¶

func (c *Command) UnsetCheckCertificates() *Command

UnsetCheckCertificates unsets any flags that were previously set by one of:

• Command.NoCheckCertificates

func (*Command) UnsetCheckFormats ¶

func (c *Command) UnsetCheckFormats() *Command

UnsetCheckFormats unsets any flags that were previously set by one of:

• Command.CheckFormats
• Command.NoCheckFormats

func (*Command) UnsetCleanInfoJSON ¶

func (c *Command) UnsetCleanInfoJSON() *Command

UnsetCleanInfoJSON unsets any flags that were previously set by one of:

• Command.CleanInfoJSON
• Command.NoCleanInfoJSON

func (*Command) UnsetClientCertificate ¶

func (c *Command) UnsetClientCertificate() *Command

UnsetClientCertificate unsets any flags that were previously set by one of:

• Command.ClientCertificate

func (*Command) UnsetClientCertificateKey ¶

func (c *Command) UnsetClientCertificateKey() *Command

UnsetClientCertificateKey unsets any flags that were previously set by one of:

• Command.ClientCertificateKey

func (*Command) UnsetClientCertificatePassword ¶

func (c *Command) UnsetClientCertificatePassword() *Command

UnsetClientCertificatePassword unsets any flags that were previously set by one of:

• Command.ClientCertificatePassword

func (*Command) UnsetColor ¶

func (c *Command) UnsetColor() *Command

UnsetColor unsets any flags that were previously set by one of:

• Command.Color

func (*Command) UnsetCompatOptions ¶

func (c *Command) UnsetCompatOptions() *Command

UnsetCompatOptions unsets any flags that were previously set by one of:

• Command.CompatOptions

func (*Command) UnsetConcatPlaylist ¶

func (c *Command) UnsetConcatPlaylist() *Command

UnsetConcatPlaylist unsets any flags that were previously set by one of:

• Command.ConcatPlaylist

func (*Command) UnsetConcurrentFragments ¶

func (c *Command) UnsetConcurrentFragments() *Command

UnsetConcurrentFragments unsets any flags that were previously set by one of:

• Command.ConcurrentFragments

func (*Command) UnsetConfigLocations ¶

func (c *Command) UnsetConfigLocations() *Command

UnsetConfigLocations unsets any flags that were previously set by one of:

• Command.NoConfigLocations
• Command.ConfigLocations

func (*Command) UnsetConsoleTitle ¶

func (c *Command) UnsetConsoleTitle() *Command

UnsetConsoleTitle unsets any flags that were previously set by one of:

• Command.ConsoleTitle

func (*Command) UnsetContinue ¶

func (c *Command) UnsetContinue() *Command

UnsetContinue unsets any flags that were previously set by one of:

• Command.Continue
• Command.NoContinue

func (*Command) UnsetConvertSubs ¶

func (c *Command) UnsetConvertSubs() *Command

UnsetConvertSubs unsets any flags that were previously set by one of:

• Command.ConvertSubs

func (*Command) UnsetConvertThumbnails ¶

func (c *Command) UnsetConvertThumbnails() *Command

UnsetConvertThumbnails unsets any flags that were previously set by one of:

• Command.ConvertThumbnails

func (*Command) UnsetCookies ¶

func (c *Command) UnsetCookies() *Command

UnsetCookies unsets any flags that were previously set by one of:

• Command.Cookies
• Command.NoCookies

func (*Command) UnsetCookiesFromBrowser ¶

func (c *Command) UnsetCookiesFromBrowser() *Command

UnsetCookiesFromBrowser unsets any flags that were previously set by one of:

• Command.CookiesFromBrowser
• Command.NoCookiesFromBrowser

func (*Command) UnsetDate ¶

func (c *Command) UnsetDate() *Command

UnsetDate unsets any flags that were previously set by one of:

• Command.Date

func (*Command) UnsetDateAfter ¶

func (c *Command) UnsetDateAfter() *Command

UnsetDateAfter unsets any flags that were previously set by one of:

• Command.DateAfter

func (*Command) UnsetDateBefore ¶

func (c *Command) UnsetDateBefore() *Command

UnsetDateBefore unsets any flags that were previously set by one of:

• Command.DateBefore

func (*Command) UnsetDefaultSearch ¶

func (c *Command) UnsetDefaultSearch() *Command

UnsetDefaultSearch unsets any flags that were previously set by one of:

• Command.DefaultSearch

func (*Command) UnsetDownloadArchive ¶

func (c *Command) UnsetDownloadArchive() *Command

UnsetDownloadArchive unsets any flags that were previously set by one of:

• Command.DownloadArchive
• Command.NoDownloadArchive

func (*Command) UnsetDownloadSections ¶

func (c *Command) UnsetDownloadSections() *Command

UnsetDownloadSections unsets any flags that were previously set by one of:

• Command.DownloadSections

func (*Command) UnsetDownloader ¶

func (c *Command) UnsetDownloader() *Command

UnsetDownloader unsets any flags that were previously set by one of:

• Command.Downloader

func (*Command) UnsetDownloaderArgs ¶

func (c *Command) UnsetDownloaderArgs() *Command

UnsetDownloaderArgs unsets any flags that were previously set by one of:

• Command.DownloaderArgs

func (*Command) UnsetDumpJSON ¶

func (c *Command) UnsetDumpJSON() *Command

UnsetDumpJSON unsets any flags that were previously set by one of:

• Command.DumpJSON

func (*Command) UnsetDumpPages ¶

func (c *Command) UnsetDumpPages() *Command

UnsetDumpPages unsets any flags that were previously set by one of:

• Command.DumpPages

func (*Command) UnsetDumpSingleJSON ¶

func (c *Command) UnsetDumpSingleJSON() *Command

UnsetDumpSingleJSON unsets any flags that were previously set by one of:

• Command.DumpSingleJSON

func (*Command) UnsetEmbedChapters ¶

func (c *Command) UnsetEmbedChapters() *Command

UnsetEmbedChapters unsets any flags that were previously set by one of:

• Command.EmbedChapters
• Command.NoEmbedChapters

func (*Command) UnsetEmbedInfoJSON ¶

func (c *Command) UnsetEmbedInfoJSON() *Command

UnsetEmbedInfoJSON unsets any flags that were previously set by one of:

• Command.EmbedInfoJSON
• Command.NoEmbedInfoJSON

func (*Command) UnsetEmbedMetadata ¶

func (c *Command) UnsetEmbedMetadata() *Command

UnsetEmbedMetadata unsets any flags that were previously set by one of:

• Command.EmbedMetadata
• Command.NoEmbedMetadata

func (*Command) UnsetEmbedSubs ¶

func (c *Command) UnsetEmbedSubs() *Command

UnsetEmbedSubs unsets any flags that were previously set by one of:

• Command.EmbedSubs
• Command.NoEmbedSubs

func (*Command) UnsetEmbedThumbnail ¶

func (c *Command) UnsetEmbedThumbnail() *Command

UnsetEmbedThumbnail unsets any flags that were previously set by one of:

• Command.EmbedThumbnail
• Command.NoEmbedThumbnail

func (*Command) UnsetEnableFileURLs ¶

func (c *Command) UnsetEnableFileURLs() *Command

UnsetEnableFileURLs unsets any flags that were previously set by one of:

• Command.EnableFileURLs

func (*Command) UnsetEncoding ¶

func (c *Command) UnsetEncoding() *Command

UnsetEncoding unsets any flags that were previously set by one of:

• Command.Encoding

func (*Command) UnsetExec ¶

func (c *Command) UnsetExec() *Command

UnsetExec unsets any flags that were previously set by one of:

• Command.Exec
• Command.NoExec

func (*Command) UnsetExtractAudio ¶

func (c *Command) UnsetExtractAudio() *Command

UnsetExtractAudio unsets any flags that were previously set by one of:

• Command.ExtractAudio

func (*Command) UnsetExtractorArgs ¶

func (c *Command) UnsetExtractorArgs() *Command

UnsetExtractorArgs unsets any flags that were previously set by one of:

• Command.ExtractorArgs

func (*Command) UnsetExtractorRetries ¶

func (c *Command) UnsetExtractorRetries() *Command

UnsetExtractorRetries unsets any flags that were previously set by one of:

• Command.ExtractorRetries

func (*Command) UnsetFFmpegLocation ¶

func (c *Command) UnsetFFmpegLocation() *Command

UnsetFFmpegLocation unsets any flags that were previously set by one of:

• Command.FFmpegLocation

func (*Command) UnsetFileAccessRetries ¶

func (c *Command) UnsetFileAccessRetries() *Command

UnsetFileAccessRetries unsets any flags that were previously set by one of:

• Command.FileAccessRetries

func (*Command) UnsetFixup ¶

func (c *Command) UnsetFixup() *Command

UnsetFixup unsets any flags that were previously set by one of:

• Command.Fixup

func (*Command) UnsetFlatPlaylist ¶

func (c *Command) UnsetFlatPlaylist() *Command

UnsetFlatPlaylist unsets any flags that were previously set by one of:

• Command.FlatPlaylist
• Command.NoFlatPlaylist

func (*Command) UnsetForceIPv4 ¶

func (c *Command) UnsetForceIPv4() *Command

UnsetForceIPv4 unsets any flags that were previously set by one of:

• Command.ForceIPv4

func (*Command) UnsetForceIPv6 ¶

func (c *Command) UnsetForceIPv6() *Command

UnsetForceIPv6 unsets any flags that were previously set by one of:

• Command.ForceIPv6

func (*Command) UnsetForceKeyframesAtCuts ¶

func (c *Command) UnsetForceKeyframesAtCuts() *Command

UnsetForceKeyframesAtCuts unsets any flags that were previously set by one of:

• Command.ForceKeyframesAtCuts
• Command.NoForceKeyframesAtCuts

func (*Command) UnsetForceOverwrites ¶

func (c *Command) UnsetForceOverwrites() *Command

UnsetForceOverwrites unsets any flags that were previously set by one of:

• Command.ForceOverwrites
• Command.NoForceOverwrites

func (*Command) UnsetForceWriteArchive ¶

func (c *Command) UnsetForceWriteArchive() *Command