KelpsGet now is KGet! v1.5.2 (Latest Release)

A modern, lightweight, and versatile downloader written in Rust for fast and reliable file downloads via command line (CLI) and graphical user interface (GUI).

English | Português | Español

Screenshots

GUI:

Torrent on localhost:9091/transmission/web/:

CLI:

Interactive:

How It Works (Summary)

Progress Bar (CLI): Shows speed, ETA, and transferred bytes.
Smart File Naming:
- Uses the filename from the URL.
- Defaults to index.html if the URL ends with /.
Error Handling: Exits with code 1 on HTTP errors (e.g., 404).
Space Check: Verifies available disk space.
Automatic Retry: Retries download on network failure.
ISO Smart Detection: Detects .iso files to ensure raw binary transfer and prevent corruption.
Integrity Check: Optional SHA256 verification for disk images after download.
Memory Efficient: Parallel downloads use streaming buffers to maintain a low RAM footprint regardless of file size.
Disk Optimization: Uses buffered I/O to prevent high disk active time and system freezes during fast transfers.
Advanced Download Mode (HTTP/HTTPS): Downloads in parallel chunks, supports resume.
Proxy Support: HTTP, HTTPS, SOCKS5 with authentication.
Optimization Features: Compression (for cache), file caching, speed limiting.
Torrent Downloads: Adds magnet links to transmission-daemon for download.
FTP/SFTP Downloads: Connects to FTP/SFTP servers to transfer files.

Features

See the full list of features and recent changes in the CHANGELOG.

KGet now is a Library too!

If you want to use KGet as a library you can click here.

Optional GUI feature

The GUI is provided behind an optional Cargo feature called gui. To build or run the binary with the GUI enabled:

cargo build --features gui

cargo run --features gui -- --gui

If you don't enable the gui feature, the binary and library will compile without GUI dependencies.

Installation

Option 1: Compile from source

You will need Rust installed. If you don't have it, install it from rustup.rs.

Install some dependencies: For Debian/Ubuntu based systems:

sudo apt update

sudo apt install -y libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libssl-dev pkg-config

For Fedora:

sudo dnf install -y libxcb-devel libxkbcommon-devel openssl-devel pkg-config

Clone the repository and compile the project:

git clone https://github.com/davimf721/KGet.git

cd KGet

cargo build --release

The executable will be in target/release/kget. You can copy it to a directory in your PATH:

sudo cp target/release/kget /usr/local/bin/

Option 2: Install via Cargo

You can install the published binary from crates.io (the GUI is opt-in via features):

# Install the binary without GUI (default)

cargo install Kget


# Install the binary with GUI support (compiles GUI deps; system libraries may be required)

cargo install Kget --features gui


#Add to your PATH

$env:PATH += ";$HOME\.cargo\bin"

If you encounter issues with the GUI when installing via cargo install, compiling from source is more reliable.

Option 3: Download Pre-compiled Binaries

Check the Releases section for the latest binaries for your OS.

Linux/macOS:

chmod +x ksget  # Make executable

./kelpsget [URL]    # Run directly

Windows:

Run the .exe file directly.

Additional Requirement for Torrent Downloads: Transmission Daemon

KGet uses the transmission-daemon to manage torrent downloads.

1. Install Transmission Daemon:

Debian/Ubuntu:

sudo apt update

sudo apt install transmission-daemon

Fedora:
```
sudo dnf install transmission-daemon
```
Arch Linux:
```
sudo pacman -S transmission-cli
```

2. Stop the Daemon for Configuration:

sudo systemctl stop transmission-daemon

3. Configure Transmission: Edit the settings.json file. Common locations:

/var/lib/transmission-daemon/info/settings.json (Debian/Ubuntu, if installed as a service)
/var/lib/transmission/.config/transmission-daemon/settings.json (Another common path, check your system)
~/.config/transmission-daemon/settings.json (if run as a user)

Use sudo nano /var/lib/transmission-daemon/info/settings.json (or the correct path for your system).

Find and modify these lines:

{
    // ...
    "rpc-authentication-required": true,
    "rpc-enabled": true,
    "rpc-password": "transmission", // This is the value KGet uses by default to connect to Transmission (recommended)
    "rpc-port": 9091,
    "rpc-username": "transmission", // Username KGet uses to connect to Transmission
    "rpc-whitelist-enabled": false, // For local access. For remote access, configure IPs.
    "download-dir": "/var/lib/transmission-daemon/downloads", // Transmission's default download directory
    // ...
}

Important: After saving and starting transmission-daemon, it will replace the plain text rpc-password with a hashed version.

4. (Optional) Adjust Daemon User Permissions: If transmission-daemon runs as a specific user (e.g., debian-transmission or transmission), ensure this user has write permissions in the download directories you intend to use with KelpsGet or Transmission itself. You can add your user to the Transmission daemon's group:

sudo usermod -a -G debian-transmission your_linux_user # For Debian/Ubuntu

# Check the Transmission group/user name on your system

5. Start the Transmission Daemon:

sudo systemctl start transmission-daemon

# Check status:

sudo systemctl status transmission-daemon

Access http://localhost:9091 in your browser. You should see the Transmission web interface and be prompted to log in with the rpc-username and rpc-password you configured.

Usage

Command Line (CLI)

kget [OPTIONS] <URL>

Examples:

HTTP/HTTPS Download:
```
kget https://example.com/file.txt
```

Rename Output File:

kget -O new_name.txt https://example.com/file.txt

kget -O ~/MyDownloads/ https://example.com/video.mp4 # Saves as ~/MyDownloads/video.mp4

FTP Download:

kget ftp://user:password@ftp.example.com/archive.zip

kget --ftp ftp://ftp.example.com/pub/file.txt

SFTP Download: (Requires SSH key setup or password if the server allows it)

kget sftp://user@sftp.example.com/path/file.dat

kget --sftp sftp://user@sftp.example.com/path/file.dat -O local.dat

Torrent Download (Magnet Link): (Requires transmission-daemon configured and running)
```
kget "magnet:?xt=urn:btih:YOUR_HASH_HERE&dn=TorrentName"

kget --torrent "magnet:?xt=urn:btih:YOUR_HASH_HERE" -O ~/MyTorrents/
```
KelpsGet will add the torrent to Transmission and attempt to open the web interface (http://localhost:9091) for management.
Silent Mode:
```
kget -q https://example.com/file.txt
```
Advanced Download Mode (HTTP/HTTPS):
```
kget -a https://example.com/large_file.zip
```
- ISO Download with Verification: KGet will automatically detect the ISO and ask if you want to verify the SHA256 hash once finished.

Use Proxy:

kget -p http://proxy:8080 https://example.com/file.txt

Proxy with Authentication:

kget -p http://proxy:8080 --proxy-user user --proxy-pass pass https://example.com/file.txt

Speed Limit:

kget -l 1048576 https://example.com/file.txt  # Limit to 1MB/s

Disable Compression (KelpsGet-specific, not HTTP):

kelpsget --no-compress https://example.com/file.txt

Disable Cache (KelpsGet-specific):

kget --no-cache https://example.com/file.txt

Graphical User Interface (GUI)

To start the GUI:

kget --gui

The GUI allows you to enter the URL, output path, and start downloads. Status and progress are displayed in the interface.

KGet Configuration

KGet uses a configuration file at:

Windows: %APPDATA%\kget\config.json
Linux/macOS: ~/.config/kget/config.json

Example config.json for KGet:

{
  "proxy": {
    "enabled": false,
    "url": null,
    "username": null,
    "password": null,
    "proxy_type": "Http"
  },
  "optimization": {
    "compression": true, // Compression for KGet cache
    "compression_level": 6,
    "cache_enabled": true,
    "cache_dir": "~/.cache/kget", // Expand ~ manually or use absolute path
    "speed_limit": null,
    "max_connections": 4
  },
  "torrent": {
    "enabled": true,
    "transmission_url": "http://localhost:9091/transmission/rpc",
    "username": "transmission", // User configured in Transmission's settings.json
    "password": "transmission", // Password configured in Transmission's settings.json
    "max_peers": 50,
    "max_seeds": 50,
    "port": null,
    "dht_enabled": true,
    "default_download_dir": null // Default directory for torrent downloads via KGet
  },
  "ftp": {
    "default_port": 21,
    "passive_mode": true
  },
  "sftp": {
    "default_port": 22,
    "key_path": null // Path to private SSH key, e.g., "~/.ssh/id_rsa"
  }
}

Note on cache_dir and key_path: If using ~, ensure your program correctly expands the tilde to the user's home directory, or use absolute paths.

🔗 Important Links

📚 Documentation
📦 crates.io
💻 GitHub
📝 Changelog

You can see posts about the project in others communities:

Contributing

Want to contribute? Check out our contribution guide!

Found a bug or want to add a feature? Open an issue or send a PR!

🚀 Download files effortlessly with the speed and reliability of Rust. 🚀

License

This project is licensed under the MIT License - see the LICENSE file for details.

Kget 1.5.2