swiftdl README

项目的 README,来自 github.com/harshsinghsv/swiftdl。合并为一个 markdown 文件:README.md。

SwiftDL

SwiftDL

Every download, at full speed.

The free, open-source download manager for Windows, macOS and Linux.

Latest release CI Platforms Built with Rust and Tauri MIT license


Clicking Download on the Ubuntu website opens SwiftDL's New download window; after Start, the 5.9 GB file downloads over eight connections at about 29 MB/s

▶  Watch the one-minute launch video



Download SwiftDL

Why SwiftDL · Download · Features · How it works · Browser extension · FAQ · Build from source


Your browser is the bottleneck

Browsers download every file over a single connection, and many servers cap how fast each connection can go. Click Download on Ubuntu's 5.9 GB installer and Chrome settles in for nearly an hour:

Chrome's download bubble: ubuntu-26.04.1-desktop-amd64.iso at under 2 MB/s, 56 minutes left

SwiftDL splits the same file across many connections at once, keeps every one of them busy until the last byte, and writes straight into the final file. Same file, same internet:

Same file, same internet: your browser on one connection takes 56 minutes, SwiftDL on eight connections takes 3 minutes 31 seconds

And it saves its progress every second, so a crash, a closed laptop or a dropped Wi-Fi connection never means starting over.

See it in action

Click a download in your browser and SwiftDL takes it from there, with your cookies, so downloads behind a login still work. On video sites, the Download video button on the player lets you pick a quality, from 4K down to audio only:

On a YouTube video, SwiftDL's Download video button opens a window with the quality set to 1080p60; the 412 MB video downloads and merges

Everything lands in one place: live speed, every connection, queue, pause and resume.

SwiftDL main window: downloads grouped by status, with live speed, connections and a detail panel

Download

Platform Installer
Windows 10 and 11 SwiftDL_x.y.z_x64-setup.exe, installs per user, no admin rights needed
macOS (Apple silicon and Intel) SwiftDL_x.y.z_universal.dmg
Linux .AppImage, .deb or .rpm

Then add the browser extension so SwiftDL can catch your downloads.

[!NOTE] The official source for SwiftDL is github.com/harshsinghsv/swiftdl. Download installers only from its Releases page.

Features

A window for every download

When your browser hands over a file, a small window asks where to save it. Press Start and the same window shows live progress, each connection's position and speed, and finally a Download complete summary with Open and Show in folder.

Download window with live progress and the per-connection view
New download window with the file's address, size, category and save location

Know what you're getting first

SwiftDL checks the file before downloading: its real name, size, type and whether the server can resume it. Pick a category and folder, or Download later to queue it.

Fast by design

  • Many connections per file, up to 32.
  • Dynamic segmentation: when a connection finishes its part, it takes half of the biggest part left, so nothing sits idle near the end.
  • No joining step: the file is reserved up front and every connection writes straight into it.
Download complete window with Open and Show in folder

Also included

SwiftDL in light mode

How it works

Your browser hands the link and cookies to SwiftDL; the app asks where to save it and shows a window; the engine checks the file, reserves it and downloads every part over its own connection, straight into the final file.
  1. Check. SwiftDL asks the server for the first byte. The answer reveals the file's size and whether it can be downloaded in parts.
  2. Reserve. The full-size file is created on disk, so every connection can write to its own place.
  3. Split. The file is divided into parts, one per connection, each fetched with an HTTP range request.
  4. Rebalance. When a connection finishes early, it takes over half of the largest remaining part.
  5. Save progress. The list of missing ranges is saved every second, which is what makes resume work after a crash.

Benchmark

On a server that limits each connection to 2 MB/s: 1 connection 2.0 MiB/s in 32 seconds, 8 connections 15.9 MiB/s in 4 seconds, 16 connections 25.1 MiB/s in 2.6 seconds.

Eight connections finishing in exactly an eighth of the time shows the rebalancing at work: no connection is left idle while another finishes alone. You can run this yourself with tools/throttle_server.py.

Browser extension

The SwiftDL extension works in Chrome, Edge, Brave, Vivaldi and Firefox:

Firefox: install it from Firefox Add-ons, or click Add to Firefox in SwiftDL's Settings → Browser.

Chrome, Edge, Brave and Vivaldi: the extension comes with SwiftDL, so there's nothing extra to download. In SwiftDL, click Add the extension (or go to Settings → Browser) and follow the four steps:

  1. Open chrome://extensions (or edge://extensions).
  2. Turn on Developer mode.
  3. Click Load unpacked.
  4. Choose SwiftDL's extension folder. The Open extension folder button takes you there. On Windows it's %LOCALAPPDATA%\SwiftDL\extension.

Use that folder rather than a copy: it stays in place while SwiftDL is installed and is refreshed when SwiftDL updates. If you don't have the app installed, swiftdl-extension.zip on the latest release has the same files.

Once the extension is on the Chrome Web Store, SwiftDL will offer it automatically: Chrome, Edge and Brave show a one-time New extension added prompt and you click Enable. No browser lets an app install an extension silently.

FAQ

Is it really faster?

When the server limits each connection, which many do, yes, by roughly the number of connections (see the benchmark). When a single connection already fills your internet line, more connections can't add speed you don't have, but resume and the queue still help.

Can it download videos from YouTube?

Yes, and from Vimeo, X, Reddit and other video sites. Click the Download video button on the player (or paste the link into New download) and pick a quality, from 4K down to audio only. These sites don't serve a plain file, so SwiftDL uses yt-dlp for them, plus ffmpeg to join the video and audio. Both are downloaded the first time you need them (on macOS and Linux, install ffmpeg with Homebrew or your package manager), and yt-dlp is kept up to date. Only download what you have the right to. DRM-protected video, like Netflix, will never be supported.

What happens if my PC crashes mid-download?

Open SwiftDL and press Resume. Progress is saved every second, so at most a second of data is downloaded again, as long as the server supports resuming. SwiftDL tells you up front when it doesn't.

Do downloads that need a login work?

Yes, when they come from the browser extension. It passes the site's cookies, referrer and user agent along with the link. They're stored with the download so resume works too, and cleared when it completes.

Does SwiftDL collect any data?

No. It has no accounts, analytics or telemetry. It only connects to the servers you download from.

How do I uninstall it?

Use Apps & features on Windows (or remove the app on macOS and Linux). The uninstaller also removes SwiftDL's browser registrations.

Build from source

You need Rust and the Tauri prerequisites for your OS.

git clone https://github.com/harshsinghsv/swiftdl
cd swiftdl
cargo install tauri-cli --version "^2" --locked
cargo test --workspace
cd app/src-tauri && cargo tauri dev
Path What it is
crates/engine The download engine: probing, segmentation, rebalancing, resume and speed limiting
crates/cli swiftdl, a command-line downloader built on the engine
app/src-tauri The desktop app: download manager, windows, tray and browser integration
app/ui The interface
extension The Chromium extension (Manifest V3)
tools A throttled test server and a native-messaging test client

Working on the interface only? It is TypeScript, built with Vite: run npm install and npm run dev in app/, then open http://localhost:5179. A simulated backend fills it with downloads, so no Rust build is needed. Run npm run build once before building the app with Cargo.

Contributing

Bug reports, ideas and pull requests are welcome. Start with CONTRIBUTING.md. To report a security problem privately, see SECURITY.md. Release notes are in the CHANGELOG.

License

SwiftDL is released under the MIT License.

swiftdl (harshsinghsv/swiftdl)

正在搜索数据库…

这是什么?SwiftDL 是一款免费的开源下载管理器,支持 Windows、macOS 和 Linux。它会把每个文件拆分成多个连接同时下载,并且每秒保存一次进度,因此在程序崩溃或连接中断后,下载可以接着继续。
它只是一个桌面应用,还是也能配合我的浏览器使用?两者都支持。桌面应用负责实际下载;Chrome、Edge、Brave、Vivaldi 和 Firefox 的浏览器扩展会把浏览器中的下载任务交给 SwiftDL,同时传递你的 Cookie 和 referrer 信息。
我该怎么把它装好并运行?从 Releases 页面选择适合你系统的安装包:Windows 的 setup .exe 安装程序(按用户安装)、macOS 的通用 .dmg,或 Linux 的 .AppImage、.deb 或 .rpm。然后添加浏览器扩展:Chrome 和 Edge 会在 SwiftDL 中弹出一次提示,让你启用扩展;Firefox 则需要从 Firefox Add-ons 商店安装。
使用前需要先安装什么吗?普通下载不需要任何额外安装。对于 YouTube 等网站的视频,macOS 和 Linux 需要先安装 ffmpeg;yt-dlp 会自动获取并保持更新。只有从源代码构建时才需要 Rust 和 Tauri。
有什么限制吗?受 DRM 保护的视频(例如 Netflix)永远不会被支持。视频下载还依赖 yt-dlp 和 ffmpeg 能否正常处理每个网站。
它能在哪些系统上运行?Windows 10 和 11、同时支持 Apple 芯片和 Intel 芯片的 macOS,以及 AppImage、deb 或 rpm 格式的 Linux。浏览器扩展可在 Chrome、Edge、Brave、Vivaldi 和 Firefox 中使用。
它会把我的数据发送到别处吗?不会。没有账号、没有分析统计,也没有遥测;SwiftDL 只会连接你下载所用的服务器。
它为什么比 Chrome 自带的下载更快?Chrome 每个文件只用一个连接下载。SwiftDL 最多会把文件拆成 32 个部分同时下载,先在磁盘上预留完整的文件空间,让每个连接直接写入文件;当某个连接提前完成时,它会把剩余最大那一块的一半分配给该连接。
它能抓取 YouTube 等类似网站的视频吗?可以。点击播放器上方的 “Download video” 按钮,或把链接粘贴到 “New download” 中,就会列出从 4K 到仅音频的各种画质。它使用 yt-dlp 和 ffmpeg,请只下载你有权下载的内容。
它也支持种子下载吗?支持。它可以打开任何位置的磁力链接和 .torrent 文件,你可以自行选择要获取哪些文件。
大小
11.8 MB
星标
776
时长
19天
提交 · 90 天