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

termscp is available for many platforms. Pick the method that matches your system below.

Linux, FreeBSD, and macOS

This shell script installs termscp on your system with a single command:

curl --proto '=https' --tlsv1.2 -sSLf https://termscp.rs/install.sh | sh

On macOS the installation requires Homebrew; otherwise the Rust compiler is installed to build termscp from source.

Windows

Install termscp from PowerShell with a single command:

irm https://termscp.rs/install.ps1 | iex

Alternatively, install it with Chocolatey:

choco install termscp

NetBSD

Install termscp from the official repositories:

pkgin install termscp

Arch Linux

Install termscp from the official repositories:

pacman -S termscp

Official binaries

Official release binaries are published for these targets:

  • GNU/Linux:
    • x86_64-unknown-linux-musl
    • aarch64-unknown-linux-musl
  • macOS:
    • x86_64-apple-darwin
    • aarch64-apple-darwin
  • Windows:
    • x86_64-pc-windows-msvc
    • aarch64-pc-windows-msvc

The Linux binaries, and the .deb package built from them, are statically linked against musl. They have no runtime dependencies: they run on any Linux distribution and any glibc version, with no system packages to install.

Requirements

The official binaries do not require these dependencies. They are needed only to build termscp from source, for example with cargo install termscp:

  • Linux users:
    • libdbus-1
    • pkg-config
    • libsmbclient
  • FreeBSD and NetBSD users:
    • dbus
    • pkgconf
    • libsmbclient

Optional requirements

These dependencies are not required to run termscp, but they are needed to enjoy all of its features.

  • Linux and FreeBSD users, to open files via V (at least one of these):
    • xdg-open
    • gio
    • gnome-open
    • kde-open
  • Linux users: a keyring manager. Read more in the Password security page.
  • WSL users, to open files via V:

Updating termscp

To update termscp to the latest version, run it from the command line with:

(sudo) termscp update

For all platforms and methods, see https://termscp.rs/install.