Download Studio
A multi-threaded file downloader for VS Code. Download HTTP/HTTPS links over multiple connections. Unfinished downloads resume after a restart or shutdown without downloading finished parts again.
English · 简体中文说明在后半部分
Features
- Multi-threaded HTTP/HTTPS downloads: each file is split into ranges and fetched over several connections at once (1–32, 8 by default). When a connection finishes its part, it takes over half of the largest remaining part, so the download does not stall on one slow connection at the end.
- Thread counts apply immediately: the number of connections and the number of simultaneous downloads take effect on running tasks as soon as you save them, with no restart. A single task can also have its own thread count.
- Resume after restart or shutdown: tasks and progress are saved continuously. The next time VS Code opens, unfinished tasks continue on their own and keep the parts already downloaded. If the file on the server has changed (different ETag or size), the download starts over instead of producing a corrupted file.
- Reliable downloads:
- automatic retries with back-off on network errors, timeouts and 5xx responses, so tasks also recover when the network comes up late after boot;
- fewer connections when the server limits them;
- redirects, file names from
Content-Disposition (including non-ASCII names), and an automatic name (1).ext when a file with the same name exists;
- single-connection download for servers without range support.
- Custom requests: extra request headers per task, such as
Referer, and an HTTP proxy.
- Find tasks quickly: the box at the top filters the list by name or link, and works together with the status filters (All, Downloading, Paused, Completed, Failed).
- English and Chinese interface: follows the VS Code display language by default. Switch it from the gear menu at any time; all VS Code windows switch together.
- One engine for all windows: downloads run in a background engine shared by every VS Code window, so opening, switching or closing windows does not interrupt them. When the last window closes, the engine saves its progress and exits.
- Status bar and notifications: the status bar shows the total download speed, plus the number of running tasks when there is more than one. When a download completes, a notification in the focused window lets you open the file or show it in its folder. A failed download shows a notification with a Retry button.
- Nothing else to install: no aria2, no Node.js, no native modules.
Getting started
- Click the Download Studio icon (a hexagon with a "D") in the Activity Bar to open Downloads. The toolbar has a filter box, Link and a gear menu.
- Download links: click Link and paste HTTP/HTTPS links, one per line. You can change the folder and the file name. Under Advanced you can add request headers such as
Referer and set threads for this task.
- Adjust speed: gear menu → Settings… opens a dialog with HTTP threads and Simultaneous downloads. Click Save and the new values apply to running tasks right away.
- Manage tasks: each row has pause / resume / retry, open, show in folder, copy link, set threads for this task, and delete (optionally with the downloaded files). Double-click a completed task to open the file.
- Gear menu: besides Settings…, it has 界面语言 / Language (中文 / English), Start All, Pause All, Open in Editor (a larger view in the editor area), Open conf.yaml, Open Engine Log and Restart Download Engine.
Commands
Open the Command Palette and type Download Studio: New Link Download, Open Download List in Editor, Start All, Pause All, Set Threads / Connections / Simultaneous Downloads, Open Default Download Folder, Open Configuration File, Open Download Engine Log, Restart Download Engine, Select Display Language.
Configuration
Settings are stored in ~/.x1/download-studio/conf.yaml. Changes made in the UI are written there. You can also edit the file by hand: saved changes take effect immediately, and your comments are kept.
language: auto # display language: auto (follow VS Code), en, zh-cn
downloadDir: ~/Downloads # default download folder
maxActiveTasks: 3 # simultaneous downloads (1–20); the rest wait in a queue
autoResume: true # continue unfinished tasks when VS Code starts
notifyOnComplete: true # show a notification when a download completes
http:
threads: 8 # connections per HTTP task (1–32)
maxRetries: 10 # rounds without progress before a task fails (about 3 minutes)
timeoutSec: 30 # connect / read timeout
proxy: '' # HTTP proxy, e.g. http://127.0.0.1:7890
Every option is explained by a comment in the file.
The same folder also holds tasks.json (tasks and progress) and logs/engine.log (the engine log).
Limitations
- Download Studio does not use your browser's sign-ins. For links that require a login, add the needed request headers by hand.
- FTP and HLS / M3U8 streams are not supported.
- Speed limits, scheduled downloads and sending links from a browser are not supported yet.
- Command titles in the Command Palette and the view name follow the VS Code display language, not the language chosen in the gear menu.
Requirements
VS Code 1.101 or later on Windows, macOS or Linux. Nothing else needs to be installed.
License
MIT
Download Studio(简体中文)
VS Code 里的多线程文件下载工具:HTTP/HTTPS 链接多线程下载。关机或重启 VS Code 后,未完成的任务接着下载,已下载的部分不重下。
功能
- HTTP/HTTPS 多线程下载:文件分段,多条连接同时下载(1–32,默认 8)。某条连接下完自己那段后,会把剩余最多的一段劈一半接过来,最后不会卡在一条慢连接上。
- 线程数随调随生效:连接数和「同时下载」数保存后立即作用到进行中的任务,不用重启任务;单个任务还可以单独设置线程数。
- 断点续传,关机不丢:任务和进度随时保存。下次打开 VS Code,未完成的任务自动继续,已下载的部分保留。服务器上的文件变了(ETag 或大小不同)时自动从头下载,不会拼出损坏的文件。
- 下载稳定可靠:
- 网络错误、超时、5xx 自动退避重试,开机时网络还没就绪也能自动恢复;
- 服务器限制连接数时自动减少连接;
- 支持重定向;文件名取自
Content-Disposition(支持中文);同名文件自动改为 名称 (1).扩展名;
- 服务器不支持断点时用单连接下载。
- 自定义请求:每个任务可附加
Referer 等请求头;支持 HTTP 代理。
- 快速找到任务:顶部的过滤框按名称或链接过滤,可与状态筛选(全部、下载中、已暂停、已完成、失败)一起用。
- 中英文界面:默认跟随 VS Code 的显示语言,可随时在齿轮菜单里切换,所有 VS Code 窗口一起切换。
- 多个窗口共用一个下载引擎:下载在后台引擎里进行,所有 VS Code 窗口共用,开关、切换窗口都不会打断下载。最后一个窗口关闭时引擎保存进度后退出。
- 状态栏与通知:状态栏显示总下载速度,多个任务同时进行时附带任务数。下载完成时在当前窗口弹出通知,可直接打开文件或在文件夹中显示;下载失败的通知带“重试”按钮。
- 无需另装任何程序:不需要 aria2、Node.js,不含原生模块。
快速开始
- 点活动栏的 Download Studio 图标(六边形里一个 D),打开“下载列表”。顶部工具栏是过滤框、「链接」和齿轮菜单。
- 链接下载:点「链接」,粘贴 HTTP/HTTPS 链接,一行一个;可修改保存目录和文件名,“高级”里可填
Referer 等请求头和本任务线程数。
- 调速度:齿轮菜单 →“设置…”,在弹框里调整「HTTP 线程」「同时下载」,点“保存”后立即生效。
- 管理任务:每行可暂停 / 继续 / 重试、打开、在文件夹中显示、复制链接、设置本任务线程数、删除(可选同时删除文件)。双击已完成的任务直接打开文件。
- 齿轮菜单:除了“设置…”,还有“界面语言 / Language”(中文 / English)、全部开始、全部暂停、在编辑器中打开(在编辑器区域打开大窗口)、打开配置文件 conf.yaml、打开下载引擎日志、重启下载引擎。
命令
命令面板中输入 Download Studio:新建链接下载、在编辑器中打开下载列表、全部开始、全部暂停、设置线程数 / 连接数 / 同时下载数、打开默认下载目录、打开配置文件 conf.yaml、打开下载引擎日志、重启下载引擎、选择界面语言。
配置
配置文件是 ~/.x1/download-studio/conf.yaml。界面上的修改会写回这里;也可以直接编辑,保存后立即生效,手写的注释会保留。
language: auto # 界面语言:auto 跟随 VS Code 的显示语言,zh-cn 中文,en 英文
downloadDir: ~/Downloads # 默认保存目录
maxActiveTasks: 3 # 同时下载的任务数(1–20),超出的排队
autoResume: true # 启动时自动继续未完成的任务
notifyOnComplete: true # 下载完成时弹出通知
http:
threads: 8 # 每个 HTTP 任务的连接数(1–32)
maxRetries: 10 # 连续多少轮毫无进展判定失败(约 3 分钟)
timeoutSec: 30 # 连接 / 读取超时(秒)
proxy: '' # HTTP 代理,如 http://127.0.0.1:7890
每一项在配置文件里都有注释说明。
同一目录下还有 tasks.json(任务与进度)、logs/engine.log(引擎日志)。
已知限制
- 不使用浏览器里的登录状态,需要登录的链接要手工填写所需的请求头。
- 不支持 FTP、HLS / M3U8。
- 暂不支持限速、计划任务、从浏览器发送链接。
- 命令面板里的命令标题和视图名称跟随 VS Code 的显示语言,不跟随齿轮菜单里选的语言。
运行要求
VS Code 1.101 及以上,Windows、macOS、Linux 均可,无需另装其他程序。
许可证
MIT