UsageGuide

Complete Usage Guide / 完全使用指南

English translation is NOT provided temporarily. Submit an issue if necessary.
Before that, please translate by yourself.

此文档目前尚不完整，需要进一步编辑 ...

本文将尽可能全面地叙述 video-downloader-deploy 的使用指南、注意事项、使用过程中可能遇到的各种问题。

至于 you-get, youtube-dl, annie, ffmpeg 的使用，另见 Quick Reference Manual / 速查手册。

以下是一些注意事项。阅读正文前你应该了解的一些事。

声明

you-get, youtube-dl, annie, ffmpeg 等 各工具的功能实现、使用方法、错误异常等均与此脚本无关。通俗地说，下载视频的能力不是此脚本而是由各工具提供的！
感谢各工具的作者及众多开源社区的贡献者。

你不一定需要此脚本

如果你已经安装了 Python 3 ，除非有特殊需求，你应该直接使用 pip 而不是此脚本。
此脚本只是将 you-get, youtube-dl, annie, ffmpeg 的部署过程自动化，你当然可以选择手动部署。
you-get, youtube-dl, annie 只是众多网络视频下载工具中的三种命令行工具。下载网络视频的工具并非只有这三种，其他的还有 ykdl, IDM, Tampermonkey脚本等等各种工具，应用界面、上手难度、便捷程度等各不相同，不再赘述。
......

写在前面

本小节预先声明了一些下文经常出现的字词、符号、标记法。

`$` 和 `>`

$ 符号表示命令，实际输入时不要带上，例如下文中出现：

$ echo test

而实际只需输入：

echo test

> 符号表示仅适用于 Windows CMD 的命令。例如设置 HTTP_PROXY 时：

> set "http_proxy=http://127.0.0.1:10809"
> set "https_proxy=http://127.0.0.1:10809"

`\`

由于此脚本仅用于 Windows 系统，故使用 \ 分隔路径、表示文件夹。

获取

本节列举了下载获取此脚本文件的三种途径。

从 GitHub 获取

适用于所有用户的下载方式。

如项目主页所述，点击 Download ZIP 即可下载脚本文件。

如果你有 Gitee(码云) 账号，你可以点击这里，登录后下载。对于国内网络，下载速度会比 GitHub 快。

从蓝奏网盘获取

适用于国内用户的下载方式。

由于国内网络从 GitHub 下载的速度可能很慢，你可以从蓝奏网盘 (如有密码则为 lussac ) 下载我打包上传的脚本文件。同时网盘还提供懒人包下载，具体细节另见其中 下载须知.txt 。

但需注意，网盘不一定能及时更新上传。如果没有及时更新，请参照上一小节下载脚本文件。

通过 Git 获取

如果你已经安装了 Git ，建议你通过 git clone 获取脚本文件，因为后续可以通过 git pull 更新脚本文件。

$ git clone https://github.com/LussacZheng/video-downloader-deploy.git

国内用户可以从 Gitee 镜像仓库克隆。

$ git clone https://gitee.com/lussac/video-downloader-deploy.git

更新

本脚本会经常更新，增加新功能或修复 Bug ，并不定期地迭代版本号。若通过执行 Deploy.bat -> [5] 更新此脚本 获得提示“此脚本可更新”，则说明脚本文件需要更新。

本节列举了更新脚本文件的三种方式。更新方式不必与当初的下载途径对应，因为最终目的都是覆盖替换旧文件。

从 GitHub 更新

适用于所有获取途径的更新方式。

与获取脚本文件时相同，点击 Download ZIP 即可下载新的脚本文件，解压并对应覆盖旧文件。

从蓝奏网盘更新

适用于所有获取途径的更新方式。

与”从 GitHub 更新“基本相同，只是从蓝奏网盘 (如有密码则为 lussac ) 下载我打包上传的新的脚本文件。解压并对应覆盖旧文件。

但需注意，网盘不一定能及时更新上传。如果没有及时更新，请参照上一小节。

通过 Git 更新

只有当你此前是通过 git clone 获取的脚本文件时，才可以通过 git pull 更新。

$ git pull

更新后

通常直接覆盖更新不会产生问题。但当 Deploy.bat -> [6] 高级设置 中新增了可配置项时，（由于配置文件设计的限制）会产生无法切换该项设置的问题。

因此建议：每次覆盖更新后，请通过执行 Deploy.bat -> [6] 高级设置 -> [99] 为什么我无法切换以上的某项设置? 或手动删除 res\deploy.settings。但这会导致所有的设置（ wget参数设置 除外）恢复至默认，还请重新逐一修改，由此造成的不便深感抱歉。

基本使用

本节将叙述此脚本的基本使用及注意事项。

[1] 初始配置

注意：请全程注意配置流程，若出现以下报错信息则说明配置过程出现问题。

文件不存在
找不到文件
拒绝访问
系统找不到指定的路径
命令语法不正确
Syntax Error
Command Line Error
Cannot find archive name
等 ......

一般只需要删除usr文件夹，重新配置即可。若res\download\文件夹下的压缩文件未下载完成，及文件损坏不完整，还先需要删除损坏的文件再重新配置。

[11] 绿色配置

此文档目前尚不完整，需要进一步编辑 ...

[12] 快速配置

[12] 完整配置

[2] 配置 FFmpeg

[3] 更新所有视频下载器

[4] 重新创建启动脚本

[5] 更新此脚本

[6] 高级设置

详见下一节：高级设置

高级设置

[1] 选择语言

[2] 选择下载地区

[3] 设置全局代理

[4] (显示/隐藏) 代理参数的命令示例

[5] (禁用/启用) FFmpeg

[6] 为 'wget' 设置参数

[7] 指定系统位数

[8] (禁用/启用) 更新时的网络连接测试

[9] 通过 (PyPI.org/GitHub_Releases) 更新 you-get

[99] 为什么我无法切换以上的某项设置?

依赖

移动