Getting started

Getting started

Install TideFTP

Run the installer on Linux or macOS:

curl -fsSL https://raw.githubusercontent.com/allisonhere/TideFTP/main/install.sh | sh

The installer puts tideftp in ~/.local/bin by default. Set INSTALL_DIR to choose another directory:

curl -fsSL https://raw.githubusercontent.com/allisonhere/TideFTP/main/install.sh | \
  INSTALL_DIR="$HOME/bin" sh

You can also download an archive from the latest release.

Open the app

Run tideftp, then press c to open the connection picker. Choose the last row to add a profile. Enter the protocol, host, port, username, and starting directory.

After connecting, the left pane shows local files and the right pane shows remote files. Press Tab to switch panes. Press u to upload and d to download.

Read Connections and security before connecting to an SFTP host with an unknown host key or an FTPS host with a private certificate.

Connect from the command line

To open SFTP directly:

tideftp --host files.example.com --user allie --path /srv/www

To use explicit FTPS on port 21:

TIDEFTP_FTP_PASSWORD=secret tideftp --protocol ftps \
  --host files.example.com --user allie --path /pub

To use implicit FTPS on port 990:

TIDEFTP_FTP_PASSWORD=secret tideftp --protocol ftps-implicit \
  --host files.example.com --user allie --path /pub

Update TideFTP

Release builds check GitHub once when they start. When an update exists, press U to review and install it. TideFTP verifies the archive against the release's SHA256SUMS before replacing the binary.

To disable the startup check, open Settings with ,, or add this configuration:

[updates]
check_on_startup = false

Development builds that report version dev do not check for updates.

This page describes source revision b1fb600.