cliftp

command module
v0.0.0-...-b78781e Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 25, 2026 License: MIT Imports: 18 Imported by: 0

README

cliftp

A dual-pane terminal FTP client that actually looks good.

build go report card license version

cliftp is a local ↔ remote file browser for your terminal: click around with the mouse or drive it entirely from the keyboard, upload and download with a live progress bar, and manage remote files (mkdir/rename/delete) without leaving the pane. No config file to write, no FTP verbs to remember.

Built with Bubble Tea and Lip Gloss — the same stack behind cliamp, whose rounded, boxed-in look this borrows. Colors come from your terminal's own ANSI palette rather than hardcoded hex, so if you're on Omarchy, cliftp re-skins itself the moment you run omarchy theme set.

Features

  • Dual-pane browser — local filesystem on one side, remote FTP on the other, both navigable independently
  • Mouse-driven — click a row to select it, double-click to open a directory or transfer a file, scroll wheel to move around
  • Full keyboard control — vim-style (hjkl) or arrow keys, nothing requires the mouse
  • Upload / download with a live progress bar
  • mkdir, rename, delete (with a confirm prompt) on either side
  • Quick-connect — remembers your last connection so the next launch is one keypress
  • Theme-reactive — pulls colors from the terminal's ANSI palette, Nerd Font icons throughout

Install

go install github.com/fush1ft/cliftp@latest

Or build from source:

git clone https://github.com/fush1ft/cliftp
cd cliftp
go build -o cliftp .

Usage

cliftp                                      # opens the connect screen
cliftp -host ftp.example.com -user me       # prefills and auto-connects
Flag Default Description
-host — FTP server to connect to on startup
-port 21 FTP port
-user anonymous Username
-pass — Password
-local-dir current directory Where the local pane starts

Quick-connect: after a successful connection, the host/port/username/ password are saved to ~/.config/cliftp/lastconn.json (mode 0600, in a 0700 directory). Launch cliftp with no flags next time and the connect screen comes up prefilled — press Enter and you're in. Passing explicit flags overrides this for that run, and saves over it on success.

Controls

Mouse: click a row to select it (and focus that pane) · double-click to open a directory or transfer the selected file · scroll wheel to move the cursor.

Key Action
Tab switch pane
↑/↓, j/k move cursor
PgUp/PgDn, Home/End (g/G) jump around the list
Enter, →/l open directory, or transfer the selected file
Backspace, ←/h go to parent directory
Space/t transfer selected file (upload if local pane is active, download if remote)
n new directory
r rename
x / Delete delete (asks to confirm)
R refresh both panes
c open the connect screen (reconnect / switch server)
? toggle full keybind help
q / Ctrl+C quit

Limitations

  • Directory transfers aren't implemented yet — files only.
  • One transfer at a time; other network actions are blocked while it's in flight (the FTP connection itself isn't safe for concurrent use).
  • Plain FTP only — no FTPS/TLS yet.

Credits

  • cliamp for the terminal-Winamp look that inspired the panel styling
  • Charm for Bubble Tea, Lip Gloss, and Bubbles
  • jlaffaye/ftp for the FTP client library

License

MIT

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL