swiftdl README

The project's README from github.com/harshsinghsv/swiftdl. As one markdown file: 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)

Searching Database…

What is this?SwiftDL is a free, open-source download manager for Windows, macOS and Linux. It splits each file across many connections and saves progress every second, so downloads resume after a crash or a dropped connection.
Is it just a desktop app, or does it also work with my browser?Both. The desktop app does the downloading, and a browser extension for Chrome, Edge, Brave, Vivaldi and Firefox hands browser downloads over to SwiftDL, along with your cookies and referrer.
How do I get it running?Pick the installer for your OS from the Releases page: a Windows setup .exe that installs per user, a macOS universal .dmg, or a Linux .AppImage, .deb or .rpm. Then add the browser extension: Chrome and Edge show a one-time prompt in SwiftDL to enable it, and in Firefox you install it from Firefox Add-ons.
Do I need anything installed first?Nothing for regular downloads. For videos from sites like YouTube, ffmpeg must be installed on macOS and Linux, while yt-dlp is fetched and kept up to date automatically. Rust and Tauri are needed only if you build from source.
Are there any catches?DRM-protected video, such as Netflix, will never be supported. Video downloads also depend on yt-dlp and ffmpeg working with each site.
Which systems does it run on?Windows 10 and 11, macOS on both Apple silicon and Intel, and Linux in AppImage, deb or rpm form. The browser extension works in Chrome, Edge, Brave, Vivaldi and Firefox.
Does it send my data anywhere?No. There are no accounts, analytics or telemetry, and SwiftDL only connects to the servers you download from.
What makes it faster than Chrome's own downloads?Chrome sends each file over one connection. SwiftDL splits it across up to 32, reserves the full file on disk up front so every connection writes straight into it, and gives half of the largest remaining part to any connection that finishes early.
Can it grab videos from YouTube and similar sites?Yes. The Download video button over the player, or pasting a link into New download, lists qualities from 4K down to audio only. It uses yt-dlp and ffmpeg, and you should only download what you have the right to.
Does it also handle torrents?Yes. It opens magnet links and .torrent files from anywhere, and you pick which files you want to fetch.
Size
11.8 MB
Stars
776
Age
19d
Commits · 90 Days