当前位置:首页 > 备忘录 > 正文内容

[备忘] Youtube-dl 命令行参数 , 中文翻译

logger2019-10-07备忘录1549

请用 Ctrl+F 查找需要了解的参数

---命令行语法: youtube-dl [通用选项] URL [URL...]---

通用选项:
-h, --help打印帮助文档
--version打印版本信息


-U, --update更新到最新版(需要权限)
-i, --ignore-errors遇到下载错误时跳过
--abort-on-error遇到下载错误时终止
--dump-user-agent显示当前使用的浏览器(User-agent)
--list-extractors列出所有的提取器(支持的网站)
--extractor-descriptions同上
--force-generic-extractor强制使用通用提取器下载
--default-search PREFIX使用此前缀补充不完整的URLs,例如:"ytsearch2 yt-dl" 从youtube搜索并下载两个关于yt-dl视频. 使用"auto"youtube-dl就会猜一个,一般效果等价于"ytsearch"("auto_warning"猜测时加入警告).我已知支持的PREFIX:ytsearch (youtube), ytsearchdate (youtube), yvsearch (yahoo videos), gvsearch (google videos)
--ignore-config不读取配置文件,当时用了全局配置文件/etc/youtube-dl.conf:不再读取 ~/.config/youtube-dl/config (%APPDATA%/youtube-dl/config.txt on Windows)
--config-location PATH使用指定路径下的配置文件
--flat-playlist列出列表视频但不下载
--mark-watched标记看过此视频 (YouTube only)
--no-mark-watched不标记看过此视频 (YouTube only)
--no-color打印到屏幕上的代码不带色


网络选项:
--proxy URL使用HTTP/HTTPS/SOCKS协议的代理.如:socks5://127.0.0.1:1080/.
--socket-timeout SECONDS放弃连接前等待时间
--source-address IP绑定的客户端IP地址
-4, --force-ipv4所有连接通过IPv4
-6, --force-ipv6所有连接通过IPv6


地理限制:
--geo-verification-proxy URL使用此代理地址测试一些有地理限制的地址
--geo-bypass绕过地理限制通过伪装X-Forwarded-For HTTP头部的客户端ip (实验)
--no-geo-bypass不 绕过地理限制通过伪装X-Forwarded-For HTTP头部的客户端ip (实验)
--geo-bypass-country CODE强制绕过地理限制通过提供准确的ISO 3166-2标准的国别代码(实验) 注:以上三个实验参数实测未成功


视频选择:
--playlist-start NUMBER指定列表中开始下载的视频(默认为1)
--playlist-end NUMBER指定列表中结束的视频(默认为last)
--playlist-items ITEM_SPEC指定列表中要下载的视频项目编号.如:"--playlist-items 1,2,5,8"或"--playlist-items 1-3,7,10-13"
--match-title REGEX下载标题匹配的视频(正则表达式或区分大小写的字符串)
--reject-title REGEX跳过下载标题匹配的视频(正则表达式或区分大小写的字符串)
--max-downloads NUMBER下载NUMBER个视频后停止
--min-filesize SIZE不下载小于SIZE的视频(e.g. 50k or 44.6m)
--max-filesize SIZE不下载大于SIZE的视频(e.g. 50k or 44.6m)
--date DATE仅下载上传日期在指定日期的视频
--datebefore DATE仅下载上传日期在指定日期或之前的视频 (i.e. inclusive)
--dateafter DATE仅下载上传日期在指定日期或之后的视频 (i.e. inclusive)
--min-views COUNT不下载观影数小于指定值的视频
--max-views COUNT不下载观影数大于指定值的视频
--match-filter FILTER通用视频过滤器. Specify any key (see help for -o for a list of available keys) to match if the key is present, !key to check if the key is not present, key > NUMBER (like "comment_count > 12", also works with >=, <, <=, !=, =) to compare against a number,key = 'LITERAL' (like "uploader = 'Mike Smith'", also works with !=) to match against a string literal and & to require multiple matches. Values which are not known are excluded unless you put a question mark (?) after the operator. For example, to only match videos that have been liked more than 100 times and disliked less than 50 times (or the dislike functionality is not available at the given service), but who also have a description, use --match-filter "like_count > 100 & dislike_count < ? 50 & description" .
--no-playlist当视频链接到一个视频和一个播放列表时,仅下载视频
--yes-playlist当视频链接到一个视频和一个播放列表时,下载视频和播放列表
--age-limit YEARS下载合适上传年限的视频
--download-archive FILE仅下载档案文件中未列出的影片,已下载的记录ID
--include-ads同时下载广告(实验)


下载选项:
-r, --limit-rate RATE最大bps (e.g. 50K or 4.2M)
-R, --retries RETRIES重试次数 (默认10), or "infinite".
--fragment-retries RETRIES一个分段的最大重试次数(default is 10), or "infinite" (DASH, hlsnative and ISM)
--skip-unavailable-fragments跳过不可用分段(DASH, hlsnative and ISM)
--abort-on-unavailable-fragment放弃某个分段当不可获取时
--keep-fragments下载完成后,将下载的片段保存在磁盘上; 片段默认被删除
--buffer-size SIZE设置缓冲区大小buffer (e.g. 1024 or 16K) (default is 1024)
--no-resize-buffer不自动调整缓冲区大小.默认情况下自动调整
--playlist-reverse以相反的顺序下载播放列表视频
--playlist-random以随机的顺序下载播放列表视频
--xattr-set-filesizeSet file xattribute ytdl.filesize with expected file size (experimental)
--hls-prefer-native使用本机默认HLS下载器而不是ffmpeg
--hls-prefer-ffmpeg使用ffmpeg而不是本机HLS下载器
--hls-use-mpegts使用TS流容器来存放HLS视频,一些高级播放器允许在下载的同时播放视频
--external-downloader COMMAND使用指定的第三方下载工具,当前支持:aria2c,avconv,axel,curl,ffmpeg,httpie,wget
--external-downloader-args ARGS给第三方下载工具指定参数,如:--external-downloader aria2c --external-downloader-args -j8


文件系统选项:
-a, --batch-file FILE文件中包含需要下载的URL
--id仅使用文件名中的视频ID
-o, --output TEMPLATEOutput filename template, see the "OUTPUT TEMPLATE" for all the info
--autonumber-start NUMBER指定%(autonumber)s的起始值(默认为1)
--restrict-filenames将文件名限制为ASCII字符,并避免文件名中的“&”和空格
-w, --no-overwrites不要覆盖文件
-c, --continue强制恢复部分下载的文件。 默认情况下,youtube-dl仅在可能时将恢复下载。
--no-continue不要恢复部分下载的文件(从头开始重新启动)
--no-part不使用.part文件 - 直接写入输出文件
--no-mtime不使用Last-modified header来设置文件最后修改时间
--write-description将视频描述写入.description文件
--write-info-json将视频元数据写入.info.json文件
--write-annotations将视频注释写入.annotations.xml文件
--load-info-json FILE包含视频信息的JSON文件(使用“--write-info-json”选项创建)
--cookies FILE文件从中读取Cookie(经测试,export cookies插件可以使用,但firebug导出的cookies导致错误,chrome下请用cookies.txt)注意:不同平台windows、Linux、OSX之间需要转换CE LF才能使用!
--cache-dir DIR文件存储位置。youtube-dl需要永久保存一些下载的信息。默认为$XDG_CACHE_HOME/youtube-dl或/.cache/youtube-dl。目前,只有YouTube播放器文件(对于具有模糊签名的视频)进行缓存,但可能会发生变化。
--no-cache-dir不用缓存
--rm-cache-dir删除所有缓存文件


缩略图:
--write-thumbnail把缩略图写入硬盘
--write-all-thumbnails将所有缩略图写入磁盘
--list-thumbnails列出所有可用的缩略图格式


详细/模拟选项:
-q, --quiet激活退出模式
--no-warnings忽略警告
-s, --simulate不下载不存储任何文件到硬盘,模拟下载模式
--skip-download不下载视频
-g, --get-url模拟下载获取视频直连
-e, --get-title模拟下载获取标题
--get-id模拟下载获取id
--get-thumbnail模拟下载获取缩略图URL
--get-description模拟下载获取视频描述
--get-duration模拟下载获取视频长度
--get-filename模拟下载获取输出视频文件名
--get-format模拟下载获取输出视频格式
-j, --dump-json模拟下载获取JSON information.
-J, --dump-single-json模拟下载获取每条命令行参数的JSON information.如果是个播放列表,就获取整个播放列表的JSON
--print-json下载的同时获取视频信息的JSON
--newline进度条在新行输出
--no-progress不打印进度条
--console-title在控制台标题栏显示进度
-v, --verbose打印各种调试信息
--dump-pages打印下载下来的使用base64编码的页面来调试问题(非常冗长)
--write-pages将下载的中间页以文件的形式写入当前目录中以调试问题
--print-traffic显示发送和读取HTTP流量
-C, --call-home联系youtube-dl服务器进行调试
--no-call-home不联系youtube-dl服务器进行调试


解决方法:
--encoding ENCODING强制指定编码(实验)
--no-check-certificate禁止HTTPS证书验证
--prefer-insecure使用未加密的连接来检索有关视频的信息(目前仅支持YouTube)
--user-agent UA指定user agent
--referer URL指定自定义的referer,仅限视频来源于同一网站
--add-header FIELD:VALUE指定一个自定义值的HTTP头文件,使用分号分割,可以多次使用此选项
--bidi-workaround围绕缺少双向文本支持的终端工作。需要在PATH中有bidiv或fribidi可执行文件
--sleep-interval SECONDS在每次下载之前休眠的秒数,或者每次下载之前的随机睡眠的范围的下限(最小可能的睡眠秒数)与-max-sleep-interval一起使用。
--max-sleep-interval SECONDS每次下载前随机睡眠范围的上限(最大可能睡眠秒数)。只能与--min-sleep-interval一起使用。


视频格式选项:
-f, --format FORMAT视频格式代码,查看"FORMAT SELECTION"获取所有信息
--all-formats获取所有视频格式
--prefer-free-formats开源的视频格式优先,除非有特定的请求
-F, --list-formats列出请求视频的所有可用格式
--youtube-skip-dash-manifest不要下载关于YouTube视频的DASH清单和相关数据
--merge-output-format FORMAT如果需要合并(例如bestvideo + bestaudio),则输出到给定的容器格式。mkv,mp4,ogg,webm,flv之一。如果不需要合并,则忽略


字幕选项:
--write-sub下载字幕文件
--write-auto-sub下载自动生成的字幕文件 (YouTube only)
--all-subs下载所有可用的字幕
--list-subs列出所有字幕
--sub-format FORMAT字幕格式,接受格式偏好,如:"srt" or "ass/srt/best"
--sub-lang LANGS要下载的字幕的语言(可选)用逗号分隔,请使用--list-subs表示可用的语言标签


验证选项:
-u, --username USERNAME使用ID登录
-p, --password PASSWORD账户密码,如果此选项未使用,youtube-dl将交互式地询问。
-2, --twofactor TWOFACTOR双因素认证码
-n, --netrc使用.netrc认证数据
--video-password PASSWORD视频密码(vimeo, smotri, youku)


Adobe Pass Options:
--ap-mso MSOAdobe Pass多系统运营商(电视提供商)标识符,使用--ap-list-mso列出可用的MSO
--ap-username USERNAMEMSO账号登录
--ap-password PASSWORD账户密码,如果此选项未使用,youtube-dl将交互式地询问。
--ap-list-mso列出所有支持的MSO


后处理选项:
-x, --extract-audio将视频文件转换为纯音频文件(需要ffmpeg或avconv和ffprobe或avprobe)
--audio-format FORMAT指定音频格式: "best", "aac", "flac", "mp3", "m4a", "opus", "vorbis", or "wav"; "best" by default;-x存在时无效
--audio-quality QUALITY指定ffmpeg/avconv音频质量,为VBR插入一个0(best)-9(worse)的值(默认5),或者指定比特率
--recode-video FORMAT必要时将视频转码为其他格式(当前支持: mp4|flv|ogg|webm|mkv|avi)
--postprocessor-args ARGS给后处理器提供这些参数
-k, --keep-video视频文件在后处理后保存在磁盘上; 该视频默认被删除
--no-post-overwrites不要覆盖后处理文件; 默认情况下,后处理文件将被覆盖
--embed-subs在视频中嵌入字幕(仅适用于mp4,webm和mkv视频)
--embed-thumbnail将缩略图嵌入音频作为封面艺术
--add-metadata将元数据写入视频文件
--metadata-from-title FORMAT从视频标题中解析附加元数据,如歌曲标题/艺术家。格式语法和--output相似.也可以使用带有命名捕获组的正则表达式。解析的参数替换现有值。Example: --metadata-from-title "%(artist)s - %(title)s" matches a title like "Coldplay - Paradise". Example (regex): --metadata-from-title "( ? P < artist >.+ ? ) - ( ? P < title >.+)"
--xattrs将元数据写入视频文件的xattrs(使用dublin core 和 xdg标准)
--fixup POLICY自动更正文件的已知故障。never(不做警告), warn(只发出警告), detect_or_warn (默认;如果可以的话修复文件,否则警告)
--prefer-avconv后处理时相较ffmpeg偏向于avconv
--prefer-ffmpeg后处理优先使用ffmpeg
--ffmpeg-location PATHffmpeg/avconv程序位置;PATH为二进制所在文件夹或者目录.
--exec CMD在下载后对文件执行命令,类似于find -exec语法.示例:--exec'adb push {} /sdcard/Music/ && rm {}'
--convert-subs FORMAT转换字幕格式(当前支持: srt|ass|vtt)

来源: https://www.cnblogs.com/zhaobang/p/7192684.html

扫描二维码推送至手机访问。

版权声明:本文由CXLOG.CN发布,如需转载请注明出处。

分享给朋友:

相关文章

[软件] 几个2018年尚且活跃的文本转码及加密的免费软件站

软件特点支持的编码活跃时间Paranoia Text Encryption跨平台,支持Windows、Mac、Linux、Android、iOS,可以实现图片中绑定文本。有在线版本。文本计算编码:Bl...

[软件使用] PotPlayer 快捷键列表

快捷键指令"播放->跳略播放->跳略播放 开|关'播放->跳略播放->跳略播放设置...,字幕->字幕同步(帧率)->滞后0.5 秒Alt+,字幕...

[软件] 几款免费WebDav客户端与服务端

软件名特色维护状态CarotDAV免费,小体积,界面简单,支持WebDAV / FTP / SFTP /,支持主流网盘同步。仅支持windows平台,有日文版。2018~Duplicati免费,跨平台...

移除 MS Office 2010 以上版本秘钥Key,重新激活

进入Office安装目录,打开命令行进入目录后,在空白区域中使用Shift+鼠标右键,可以快捷调出CMD窗口检查当前Key及激活状态,在CMD窗口里键入:cscript OSPP.VBS /dstat...

[备忘] 如何减少主机里吵闹的硬盘转动声噪音

[备忘] 如何减少主机里吵闹的硬盘转动声噪音

首先,一块优质的硬盘是最小化硬盘运行噪音的最可靠方式.但是纵观世界硬盘厂家,屈指可数的数目.有时候往往一个厂牌的硬盘,品控可以有天壤之别.所以优质的硬盘并非是可以被稳定控制的选项.那么剩下的就是&qu...

[备忘] 盈通 RX470 4G 游戏高手原厂BIOS下载备份

>GPU-Z数据库已经录入点击下载>JD购入后,曾经返厂一次(掉驱动),自己Rip出来的BIOSYeston-RX470-4G-GameMaster-20190512-Ellesmere....