Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

ratclone runs on Linux, on x86_64 and aarch64. It needs:

  • rclone v1.68.0 or newer. ratclone checks the version when it starts and says so if it is older. Browser login inside the app needs v1.75.0 or newer; older supported versions use the authorization-token flow.
  • A terminal with truecolor and a Nerd Font for the icons. Without one, set icons = "ascii" in the configuration or in the settings (,).

Getting a recent rclone

Fedora, openSUSE Tumbleweed and Arch Linux ship a recent enough rclone, and the packages below install it for you. Debian and Ubuntu ship rclone 1.60, which is too old. Install the current release from rclone’s own site instead, which puts it in /usr/bin:

sudo -v ; curl https://rclone.org/install.sh | sudo bash

rclone’s install page has the other ways, including its own .deb and .rpm packages. Check with rclone version.

Packages

Each release has packages and archives on the releases page, with SHA256SUMS listing the checksum of every file. x86_64 files are named amd64 or x86_64, aarch64 files arm64 or aarch64. The binary inside is static (musl), so it does not depend on your distribution’s glibc.

SystemFileInstall
Arch LinuxAURparu -S ratclone-bin (or ratclone to build from source)
Arch Linuxratclone-VERSION-1-x86_64.pkg.tar.zstsudo pacman -U ./ratclone-*-x86_64.pkg.tar.zst
Debian, Ubunturatclone_VERSION-1_amd64.debsudo apt install ./ratclone_*_amd64.deb
Fedora, RHELratclone-VERSION-1.x86_64.rpmsudo dnf install ./ratclone-*.x86_64.rpm
openSUSEratclone-VERSION-1.x86_64.rpmsudo zypper install --allow-unsigned-rpm ./ratclone-*.x86_64.rpm
Any Linuxratclone-VERSION-x86_64-unknown-linux-musl.tar.gzunpack it and put ratclone on your PATH

The Arch and RPM packages depend on rclone and install it. The .deb only suggests it, because the rclone in Debian and Ubuntu is too old: install it as described above.

Check a download, and its build provenance (which proves it was built by this repository’s release workflow), with the GitHub CLI:

sha256sum --check --ignore-missing SHA256SUMS
gh attestation verify ratclone_*_amd64.deb --repo SyscallBrain/ratclone

From crates.io

With Rust 1.88 or newer:

cargo install --locked ratclone

From source

git clone https://github.com/SyscallBrain/ratclone
cd ratclone
cargo build --release
./target/release/ratclone

Try it first

ratclone --demo

Demo mode shows made-up accounts and files. Nothing touches rclone or your accounts, so it is safe to try every key.