Lux
Let there be Lux!
👾 Lux 是一个使用 Go 构建的快速且简单的视频下载器。
- [安装](#installation)
- [前置条件](#prerequisites)
- [通过 `go install` 安装](#install-via-go-install)
- [Homebrew（仅限 macOS）](#homebrew-macos-only)
- [Arch Linux](#arch-linux)
- [Void Linux](#void-linux)
- [Windows 上的 Scoop](#scoop-on-windows)
- [Windows 上的 Chocolatey](#chocolatey-on-windows)
- [Windows/macOS/Linux 上的 Cask](#cask-on-windowsmacoslinux)
- [入门指南](#getting-started)
- [下载视频](#download-a-video)
- [下载其他内容](#download-anything-else)
- [下载播放列表](#download-playlist)
- [多输入](#multiple-inputs)
- [恢复下载](#resume-a-download)
- [自动重试](#auto-retry)
- [Cookie](#cookies)
- [代理](#proxy)
- [多线程](#multi-thread)
- [短链接](#short-link)
- [bilibili](#bilibili)
- [使用指定的 Referrer](#use-specified-referrer)
- [指定输出路径和文件名](#specify-the-output-path-and-name)
- [调试模式](#debug-mode)
- [复用提取的数据](#reuse-extracted-data)
- [选项](#options)
- [下载：](#download)
- [网络：](#network)
- [播放列表：](#playlist)
- [文件系统：](#filesystem)
- [字幕：](#subtitle)
- [Youku：](#youku)
- [aria2：](#aria2)
- [支持的网站](#supported-sites)
- [已知问题](#known-issues)
- [优酷](#优酷)
- [西瓜/头条视频](#西瓜头条视频)
- [贡献](#contributing)
- [作者](#authors)
- [类似项目](#similar-projects)
- [许可证](#license)
## 安装
### 前置条件
以下依赖项是必需的，需要单独安装。
- **[FFmpeg](https://www.ffmpeg.org)**
### 通过 `go install` 安装
要安装 Lux，请使用 `go install`，或从 [Releases](https://github.com/iawia002/lux/releases) 页面下载二进制文件。
```
$ go install github.com/iawia002/lux@latest
```
### Homebrew（仅限 macOS）
对于 macOS 用户，可以通过以下方式安装 `lux`：
```
$ brew install lux
```
### Arch Linux
对于 Arch 用户 [AUR](https://aur.archlinux.org/packages/lux-dl/) 包可用。
### Void Linux
对于 Void Linux 用户，可以通过以下方式安装 `lux`：
```
$ xbps-install -S lux
```
### [Scoop](https://scoop.sh/) 在 Windows 上
```
$ scoop install lux
```
### [Chocolatey](https://chocolatey.org/) 在 Windows 上
```
$ choco install lux
```
### [Cask](https://github.com/axetroy/cask.rs) 在 Windows/macOS/Linux 上
```
$ cask install github.com/iawia002/lux
```
## 入门
用法：
```
lux [OPTIONS] URL [URL...]
```
### 下载视频
```
$ lux "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Site: YouTube youtube.com
Title: Rick Astley - Never Gonna Give You Up (Video)
Type: video
Stream:
[248] -------------------
Quality: 1080p video/webm; codecs="vp9"
Size: 63.93 MiB (67038963 Bytes)
# download with: lux -f 248 ...
41.88 MiB / 63.93 MiB [=================>-------------] 65.51% 4.22 MiB/s 00m05s
```
使用 `-i` 选项可显示视频的所有可用质量而不下载。
```
$ lux -i "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Site: YouTube youtube.com
Title: Rick Astley - Never Gonna Give You Up (Video)
Type: video
Streams: # All available quality
[248] -------------------
Quality: 1080p video/webm; codecs="vp9"
Size: 49.29 MiB (51687554 Bytes)
# download with: lux -f 248 ...
[137] -------------------
Quality: 1080p video/mp4; codecs="avc1.640028"
Size: 43.45 MiB (45564306 Bytes)
# download with: lux -f 137 ...
[398] -------------------
Quality: 720p video/mp4; codecs="av01.0.05M.08"
Size: 37.12 MiB (38926432 Bytes)
# download with: lux -f 398 ...
[136] -------------------
Quality: 720p video/mp4; codecs="avc1.4d401f"
Size: 31.34 MiB (32867324 Bytes)
# download with: lux -f 136 ...
[247] -------------------
Quality: 720p video/webm; codecs="vp9"
Size: 31.03 MiB (32536181 Bytes)
# download with: lux -f 247 ...
```
使用 `lux -f stream "URL"` 下载 `-i` 选项输出中列出的特定流。
### 下载其他内容
如果直接提供特定资源的 URL，则 Lux 会直接下载它：
```
$ lux "https://img9.bcyimg.com/drawer/15294/post/1799t/1f5a87801a0711e898b12b640777720f.jpg"
lux doesn't support this URL right now, but it will try to download it directly
Site: Universal
Title: 1f5a87801a0711e898b12b640777720f
Type: image/jpeg
Stream:
[default] -------------------
Size: 1.00 MiB (1051042 Bytes)
# download with: lux -f default "URL"
1.00 MiB / 1.00 MiB [===================================] 100.00% 1.21 MiB/s 0s
```
### 下载播放列表
使用 `-p` 选项可下载整个播放列表而不是单个视频。
```
$ lux -i -p "https://www.bilibili.com/bangumi/play/ep198061"
Site: 哔哩哔哩 bilibili.com
Title: Doctor X 第四季：第一集
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 845.66 MiB (886738354 Bytes)
# download with: lux -f default "URL"
Site: 哔哩哔哩 bilibili.com
Title: Doctor X 第四季：第二集
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 930.71 MiB (975919195 Bytes)
# download with: lux -f default "URL"
......
```
可以使用 `-start`、`-end` 或 `-items` 选项指定下载范围：
```
-start
Playlist video to start at (default 1)
-end
Playlist video to end at
-items
Playlist video items to download. Separated by commas like: 1,5,6,8-10
```
仅适用于 bilibili 播放列表：
```
-eto
File name of each bilibili episode doesn't include the playlist title
```
### 多输入
也可以一次性下载多个 URL：
```
$ lux -i "https://www.bilibili.com/video/av21877586" "https://www.bilibili.com/video/av21990740"
Site: 哔哩哔哩 bilibili.com
Title: 【莓机会了】甜到虐哭的13集单集MAD「我现在什么都不想干,更不想看14集」
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 51.88 MiB (54403767 Bytes)
# download with: lux -f default "URL"
Site: 哔哩哔哩 bilibili.com
Title: 【莓救了】甜到虐哭！！！国家队单集MAD-当熟悉的bgm响起，眼泪从脸颊滑下
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 77.63 MiB (81404093 Bytes)
# download with: lux -f default "URL"
```
这些 URL 将按顺序逐一下载。
也可以使用 `-F` 选项从文件读取 URL：
```
$ lux -F ~/Desktop/u.txt
Site: 微博 weibo.com
Title: 在Google，我们设计什么？ via@阑夕
Type: video
Stream:
[default] -------------------
Size: 19.19 MiB (20118196 Bytes)
# download with: lux -f default "URL"
19.19 MiB / 19.19 MiB [=================================] 100.00% 9.69 MiB/s 1s
......
```
可以使用 `-start`、`-end` 或 `-items` 选项指定下载范围：
```
-start
File line to start at (default 1)
-end
File line to end at
-items
File lines to download. Separated by commas like: 1,5,6,8-10
```
### 恢复下载
Ctrl+
C 中断下载。
输出目录中会保留一个临时的 `.download` 文件。如果再次使用相同参数运行 `lux`，则下载进度将从上次会话恢复。
### 自动重试
当下载失败时，lux 会自动重试，可通过 `-retry` 选项指定重试次数（默认为 100）。
### Cookie
如果需要访问视频，可以提供 Cookie 给 `lux`，使用 `-c` 选项。
Cookie 可以采用以下格式或 [Netscape Cookie](https://curl.haxx.se/rfc/cookie_spec.html) 格式：
```
name=value; name2=value2; ...
```
Cookie 可以是字符串或文本文件，以下是两种提供方式：
作为字符串：
```
$ lux -c "name=value; name2=value2" "https://www.bilibili.com/video/av20203945"
```
作为文本文件：
```
$ lux -c cookies.txt "https://www.bilibili.com/video/av20203945"
```
### 代理
可以通过环境变量设置 HTTP/SOCKS5 代理：
```
$ HTTP_PROXY="http://127.0.0.1:1087/" lux -i "https://www.youtube.com/watch?v=Gnbch2osEeo"
```
```
$ HTTP_PROXY="socks5://127.0.0.1:1080/" lux -i "https://www.youtube.com/watch?v=Gnbch2osEeo"
```
### 多线程
使用 `--multi-thread` 或 `-m` 启用多线程下载单个视频。
使用 `--thread` 或 `-n` 设置下载线程数（默认为 10）。
### 短链接
#### bilibili
可以直接使用 `av` 或 `ep` 编号下载 bilibili 视频：
```
$ lux -i ep198381 av21877586
Site: 哔哩哔哩 bilibili.com
Title: 狐妖小红娘：第79话 南国公主的吃货本色
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 485.23 MiB (508798478 Bytes)
# download with: lux -f default "URL"
Site: 哔哩哔哩 bilibili.com
Title: 【莓机会了】甜到虐哭的13集单集MAD「我现在什么都不想干,更不想看14集」
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 51.88 MiB (54403767 Bytes)
# download with: lux -f default "URL"
```
### 使用指定的 Referrer
可以通过 `-r` 选项使用 Referrer：
```
$ lux -r "https://www.bilibili.com/video/av20383055/" "http://cn-scnc1-dx.acgvideo.com/"
```
### 指定输出路径和文件名
使用 `-o` 选项设置路径，`-O` 选项设置下载文件名：
```
$ lux -o ../ -O "hello" "https://example.com"
```
### 调试模式
使用 `-d` 选项输出网络请求信息：
```
$ lux -i -d "http://www.bilibili.com/video/av20088587"
URL: http://www.bilibili.com/video/av20088587
Method: GET
Headers: http.Header{
"Referer": {"http://www.bilibili.com/video/av20088587"},
"Accept": {"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"},
"Accept-Charset": {"UTF-8,*;q=0.5"},
"Accept-Encoding": {"gzip,deflate,sdch"},
"Accept-Language": {"en-US,en;q=0.8"},
"User-Agent": {"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.146 Safari/537.36"},
}
Status Code: 200
URL: https://interface.bilibili.com/v2/playurl?appkey=84956560bc028eb7&cid=32782944&otype=json&qn=116&quality=116&type=&sign=fb2e3f261fec398652f96d358517e535
Method: GET
Headers: http.Header{
"Accept-Charset": {"UTF-8,*;q=0.5"},
"Accept-Encoding": {"gzip,deflate,sdch"},
"Accept-Language": {"en-US,en;q=0.8"},
"User-Agent": {"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.146 Safari/537.36"},
"Referer": {"https://interface.bilibili.com/v2/playurl?appkey=84956560bc028eb7&cid=32782944&otype=json&qn=116&quality=116&type=&sign=fb2e3f261fec398652f96d358517e535"},
"Accept": {"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"},
}
Status Code: 200
Site: 哔哩哔哩 bilibili.com
Title: 燃油动力的遥控奥迪R8跑赛道
Type: video
Streams: # All available quality
[default] -------------------
Quality: 高清 1080P
Size: 64.38 MiB (67504795 Bytes)
# download with: lux -f default "URL"
```
### 复用提取的数据
使用 `-j` 选项以 JSON 格式打印提取的数据：
```
$ lux -j "https://www.bilibili.com/video/av20203945"
{
"site": "哔哩哔哩 bilibili.com",
"title": "【2018拜年祭单品】相遇day by day",
"type": "video",
"streams": {
"15": {
"urls": [
{
"url": "...",
"size": 18355205,
"ext": "flv"
}
],
"quality": "流畅 360P",
"size": 18355205
},
"32": {
"urls": [
{
"url": "...",
"size": 40058632,
"ext": "flv"
}
],
"quality": "清晰 480P",
"size": 40058632
},
"64": {
"urls": [
{
"url": "...",
"size": 82691087,
"ext": "flv"
}
],
"quality": "高清 720P",
"size": 82691087
},
"80": {
"urls": [
{
"url": "...",
"size": 121735559,
"ext": "flv"
}
],
"quality": "高清 1080P",
"size": 121735559
}
}
}
```
### 选项
```
-i Information only
-F string
URLs file path
-d Debug mode
-j Print extracted data
-s Minimum outputs
-v Show version
```
#### 下载：
```
-f string
Select specific stream to download
-p Download playlist
-n int
The number of download thread (only works for multiple-parts video) (default 10)
-c string
Cookie
-r string
Use specified Referrer
-cs int
HTTP chunk size for downloading (in MB) (default 1)
```
#### 网络：
```
-retry int
How many times to retry when the download failed (default 10)
```
#### 播放列表：
```
-start int
Playlist video to start at (default 1)
-end int
Playlist video to end at
-items string
Playlist video items to download. Separated by commas like: 1,5,6,8-10
```
#### 文件系统：
```
-o string
Specify the output path
-O string
Specify the output file name
```
#### 字幕：
```
-C Download subtitles
-C -items en,zh
Download specific languages (YouTube only)
-C -items en,zh -embed
Embed subtitles into the video (YouTube only)
```
#### Youku：
```
-ccode string
Youku ccode (default "0502")
-ckey string
Youku ckey (default "7B19C0AB12633B22E7FE81271162026020570708D6CC189E4924503C49D243A0DE6CD84A766832C2C99898FC5ED31F3709BB3CDD82C96492E721BDD381735026")
-password string
Youku password
```
#### aria2：
```
-aria2
Use Aria2 RPC to download
-aria2addr string
Aria2 Address (default "localhost:6800")
-aria2method string
Aria2 Method (default "http")
-aria2token string
Aria2 RPC Token
```
## 支持的网站
| 网站 | URL | 🎬 视频 | 🌁 图片 | 🔊 音频 | 📚 播放列表 | 🍪 VIP 适配 | 构建状态 |
| ---------------- | ------------------------------------------------------------------------- | ------ | -------- | ------- | ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 抖音 |
| ✓ | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_douyin.yml) |
| 哔哩哔哩 | | ✓ | | | ✓ | ✓ | [](https://github.com/iawia002/lux/actions/workflows/stream_bilibili.yml) |
| 半次元 | | | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_bcy.yml) |
| pixivision | | | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_pixivision.yml) |
| 优酷 | | ✓ | | | | ✓ | [](https://github.com/iawia002/lux/actions/workflows/stream_youku.yml) |
| YouTube | | ✓ | | | ✓ | | [](https://github.com/iawia002/lux/actions/workflows/stream_youtube.yml) |
| 西瓜视频（头条） | , , | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_ixigua.yml) |
| 爱奇艺 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_iqiyi.yml) |
| 新片场 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_xinpianchang.yml) |
| 芒果 TV | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_mgtv.yml) |
| 糖豆广场舞 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_tangdou.yml) |
| Tumblr | | ✓ | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_tumblr.yml) |
| Vimeo | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_vimeo.yml) |
| Facebook | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_facebook.yml) |
| 斗鱼视频 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_douyu.yml) |
| 秒拍 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_miaopai.yml) |
| 微博 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_weibo.yml) |
| Instagram | | ✓ | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_instagram.yml) |
| Threads | | ✓ | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_threads.yml) |
| Twitter | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_twitter.yml) |
| 腾讯视频 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_qq.yml) |
| 网易云音乐 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_netease.yml) |
| 音悦台 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_yinyuetai.yml) |
| 极客时间 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_geekbang.yml) |
| Pornhub | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_pornhub.yml) |
| XVIDEOS | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_xvideos.yml) |
| 联合新闻网 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_udn.yml) |
| TikTok | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_tiktok.yml) |
| Pinterest | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_pinterest.yml) |
| 好看视频 |https://haokan.baidu.com> | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_haokan.yml) |
| AcFun | | ✓ | ✓ | | ✓ | | [](https://github.com/iawia002/lux/actions/workflows/stream_acfun.yml) |
| Eporner | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_eporner.yml) |
| StreamTape | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_streamtape.yml) |
| 虎扑 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_hupu.yml) |
| 虎牙视频 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_huya.yml) |
| 喜马拉雅 | | | | ✓ | | | [](https://github.com/iawia002/lux/actions/workflows/stream_ximalaya.yml) |
| 快手 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_kuaishou.yml) |
| Reddit | | ✓ | ✓ | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_reddit.yml) |
| VKontakte | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_vk.yml/) |
| 知乎 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_zhihu.yml/) |
| Rumble | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_rumble.yml/) |
| 小红书 | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_xiaohongshu.yml/) |
| Zing MP3 | | ✓ | | ✓ | | | [](https://github.com/iawia002/lux/actions/workflows/stream_zingmp3.yml/) |
| Bitchute | | ✓ | | | | | [](https://github.com/iawia002/lux/actions/workflows/stream_bitchute.yml/) |
| Odysee | | ✓ | | ✓ | | | [](https://github.com/iawia002/lux/actions/workflows/stream_odysee.yml/) |
## 已知问题
### 优酷
优酷的 `ccode` 经常变化导致 lux 不可用，如果你知道有新的可用的 `ccode`，可以直接使用 `lux -ccode ...` 而不用等待 lux 更新（当然，也欢迎你给我们提一个 Pull request 来更新默认的 `ccode`）
最好是每次下载都附带登录过的 Cookie 以避免部分 `ccode` 的问题
### 西瓜/头条视频
西瓜/头条视频必须带 Cookie 才能下载成功，西瓜和头条可共用西瓜视频的 Cookie，Cookie 的有效期可能较短，下载失败就更新 Cookie 尝试：
```
$ lux -c "msToken=yoEh0-qLUq4obZ8Sfxsem_CxCo9R3NM6ViTrWaRcM1...; ttwid=1%7C..." "https://m.toutiao.com/is/iYbTfJ79/"
```
## 贡献
Lux 是一个开源项目，构建在众多开源项目之上。请查看 [贡献指南](./CONTRIBUTING.md) 以开始参与。
## 作者
用 ❤️ 编码的 [iawia002](https://github.com/iawia002) 和可爱的 [贡献者](https://github.com/iawia002/lux/graphs/contributors)
## 类似项目
- [youtube](https://github.com/kkdai/youtube)
- [youtube-dl](https://github.com/rg3/youtube-dl)
- [you-get](https://github.com/soimort/you-get)
- [ytdl](https://github.com/rylio/ytdl)
## 许可证
MIT
Copyright (c) 2018-present, iawia002
