https://github.com/ghimiresdp/furl-cli
A fast, multithreaded CLI downloader built in Rust.
https://github.com/ghimiresdp/furl-cli
download-manager downloader file-downloader network-util
Last synced: about 1 month ago
JSON representation
A fast, multithreaded CLI downloader built in Rust.
- Host: GitHub
- URL: https://github.com/ghimiresdp/furl-cli
- Owner: ghimiresdp
- License: apache-2.0
- Created: 2025-12-20T06:33:32.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-29T17:06:44.000Z (about 1 month ago)
- Last Synced: 2026-05-29T18:12:17.799Z (about 1 month ago)
- Topics: download-manager, downloader, file-downloader, network-util
- Language: Rust
- Homepage: https://crates.io/crates/furl-cli
- Size: 297 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# fURL (`furl-cli`)
[](https://github.com/ghimiresdp/furl-cli/actions/workflows/ci.yml)
[](https://github.com/ghimiresdp/furl-cli/actions/workflows/release.yml)
A fast, multithreaded CLI downloader built in Rust.
furl is a high-performance command-line tool designed to download files faster
by utilizing multiple threads to fetch chunks of data concurrently. Inspired by
the simplicity of cURL and the robustness of wget.
> [!Warning]
> This branch is usually ahead of the latest release. If something does not
> work as expected, consider checking out a specific release tag, or install
> a stable version via cargo or winget. For more, see the [Installation](#installation) section.
## ✨ Features
- **Smart Parallel Downloads**: Automatically splits large files into chunks and
downloads them across multiple threads when needed and size is known. Also
automatically shrinks the maximum length of chunk to 10MB for better resource
utilization.
- **Modern Async**: Built on top of `tokio` and `reqwest` for maximum efficiency.
- **Visual Progress**: Beautiful, real-time progress bars using `indicatif`.
- **Rust Powered**: Memory-safe and "fearless" concurrency.
## Installation
You can install `furl` using WinGet, Cargo, or by building it from source.
### Windows (Recommended: WinGet)
For Windows users, WinGet is the recommended installation method.
Requirement: WinGet must be available on your system (included by default on modern Windows 10/11 setups).
```shell
winget install ghimiresdp.furl
```
### Crates.io
Use this method on any platform where Rust is installed.
Requirement: Rust toolchain and Cargo must be installed.
Install Rust from the official guide:
```shell
cargo install furl-cli
```
### From Source
Use this method if you want to build from the latest source code or contribute changes.
Requirement: Git, Rust toolchain, and Cargo must be installed.
Install Rust from the official guide:
```shell
git clone https://github.com/ghimiresdp/furl-cli.git
cd furl-cli
cargo build --release
```
### Pre-built Binaries
If `furl` is not yet available in your package manager, you can download pre-built binaries from the **Assets** section of the [latest release](https://github.com/ghimiresdp/furl-cli/releases/latest).
If you need an older version, browse all published releases in the [Releases](https://github.com/ghimiresdp/furl-cli/releases) section and check the **Assets** section for that release.
## 🛠 Usage
`furl` can be used in 2 modes `Library mode` and `Binary mode`.
### Binary Mode
You need to install the `furl-cli` and add it to the path before you can use it
in the binary mode. For more details, you can check the
[Installation](#installation) section.
#### Without output directory
When no output directory is passed, it automatically downloads the file in the
current terminal directory (PWD).
```bash
furl [URL]
```
**Example:**
```bash
furl https://raw.githubusercontent.com/ghimiresdp/furl-cli/refs/heads/main/res/images/example.png
```
#### With output directory
```bash
furl [URL] -o [path/to/the/directory]
```
**Example:**
```bash
furl https://raw.githubusercontent.com/ghimiresdp/furl-cli/refs/heads/main/res/images/example.png -o ./tmp -t 32
```
### Library Mode
In library mode, you can just import the `Downloader` struct and use its
`download()` method to download files.
```rust
use furl_core::{DownloadConfig, Downloader};
// since Downloader::download() method is async, it needs to be implemented
// inside the async function. if it is main function, we can use
// `#[tokio::main]` macro.
#[tokio::main]
async fn main() {
let url = "https://raw.githubusercontent.com/ghimiresdp/furl-cli/refs/heads/main/res/images/example.png";
let config = DownloadConfig::default().set_max_chunk_size(5 * 1024 * 1024); // 5 MB
let mut downloader = Downloader::new(url).with_config(config);
if downloader.download(".", None, Some(4)).await.is_ok() {
println!("Download completed successfully!");
} else {
println!("Download failed.");
}
}
```
For runnable workspace examples that embed `furl-cli` as a library,
check the [examples/](examples) directory (e.g. [embedded-minimal](examples/embedded-minimal), [no-indicator](examples/no-indicator)).
## 🏗 Architecture Decisions
Project design decisions are documented as Architecture Decision Records
(ADRs) under [docs/adr](docs/adr). The ADR index is available at
[docs/adr/README.md](docs/adr/README.md).
## 📦 Examples
Implementation-oriented examples live in the [examples](examples)
directory. These are standalone workspace crates that show how to use
`furl-cli` as a library in real applications.
## 🗺 Roadmap
- [x] Multithreaded chunk downloading
- [x] Customize number of threads with arguments
- [x] Basic CLI argument parsing (clap)
- [x] Real-time progress bars
- [x] Smart Threading (Completely ignore threading for files smaller than 1 MB).
- [x] Package manager support (Windows: WinGet)
- [x] Examples
- [ ] Config file support (furl.toml)
- [ ] Support for Proxy and Basic Auth
- [ ] Resume interrupted downloads (Checkpoints)
- [ ] Package manager support (Linux: APT)
- [ ] Package manager support (Linux: Flatpak)
- [ ] Package manager support (Linux: Snap)
- [ ] Package manager support (macOS: Homebrew)
## 🤝 Contributing
Contributions are welcome! Since this project is actively being developed,
please open an issue first to discuss the changes you'd like to make.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)`
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
For more details, please check [CONTRIBUTING.md](CONTRIBUTING.md).
## 📄 License
This project is licensed under the Apache License 2.0.
See the [LICENSE](LICENSE) file for details.
### Third-Party Licenses
This software uses several open-source components. You can view the full list of
dependencies and their licenses using `cargo-license`:
> [!NOTE]
> furl-cli (or fURL) is a successor to my previous project
> [ghimiresdp/rust-raid](https://github.com/ghimiresdp/rust-raid)'s
> [cget](https://github.com/ghimiresdp/rust-raid/tree/main/projects/cget) download manager.
> It incorporates refined logic and improved multithreading from that original
> implementation.