bup-ftp(1)

📦
version 0.34 · 10 versions
, in fedora 44, nixpkgs unstable

💖 bup-ftp — the manual, but make it a group chat 💖

okay so bestie, this is bup-ftp(1), a General Commands Manual page, and it's about the ftp-ish client for wandering around your bup repos. it's giving "file browser but make it ✨command line✨". buckle up 🎀

✨ NAME ✨

bup-ftp — an ftp-like client for navigating bup repositories 🦋

🌸 SYNOPSIS 🌸

bup ftp

that's it. that's the whole vibe. no flags, no drama, just vibes and a prompt. 💅

💜 DESCRIPTION 💜

so bup ftp is a command-line tool for navigating bup repositories, no cap. it's got commands that are basically the Unix ftp(1) command's cousins — same energy, different era. 🫶

the file hierarchy you see in there is the exact same one you'd get from bup-fuse(1) and bup-ls(1). so like, if you know those, you already know what you're looking at. iconic lineup, honestly. 👑

note: if your system has the python-readline library installed, you can hit the tab key to autocomplete filenames while you're navigating your backup data. this will save you a LOT of typing. like, genuinely life-changing. not me typing out a whole 40-character timestamp by hand 😭 use the tab key bestie, i'm begging.

🎀 COMMANDS 🎀

these are the commands available inside bup ftp — your whole little toolkit, your little squad 💖

  • ls [-s] [-a] [path] — print the contents of a directory. no path argument? it just lists the current directory's contents, easy. add -a and it ALSO shows hidden files (aka the ones starting with a . character, sneaky little guys 🙈). add -s and every file gets displayed with its hash from the bup archive sitting to its left. flex. 🔥
  • cd dirname — change to a different working directory. classic. we love a good cd. 🚶♀️
  • pwd — print the path of the current working directory. where am i? who am i? anyway here's the path. ✨
  • cat filenames... — print the contents of one or more files straight to stdout. yes you can pass multiple, it's a whole lineup. 🐱
  • get filename localname — download the contents of filename and save it to disk as localname. if you leave out localname, it just uses filename as the local name. convenient!! 🫶
  • mget filenames... — download the contents of the given filenames and store them to disk under the same names. and here's the fun part: the filenames may contain Unix filename globs (*, ?, etc.) so you can grab a whole swarm at once. ✨
  • help — print a list of available commands. when in doubt, ask for help. self-care. 💅
  • quit — exit the bup ftp client. goodbye forever (until next time). 👋

🌈 EXAMPLES 🌈

here's a little tour, narrated by me, starring you 💜

$ bup ftp
bup> ls
mybackup/    yourbackup/

bup> cd mybackup/
bup> ls
2010-02-05-185507@   2010-02-05-185508@    latest@

bup> cd latest/
bup> ls
  (...etc...)

bup> get myfile
Saving 'myfile'
bup> quit

see how latest@ is right there being the main character? yeah. that's the shortcut, use it. 😌

🦋 SEE ALSO 🦋

go read those next, iykyk 🎀

💫 BUP 💫

part of the bup(1) suite. one big happy family. 🫶

⭐ AUTHORS ⭐

Avery Pennarun apenwarr@gmail.com — thank you for your service, legend 👑

and that's the whole page fr fr ✨ this was Bup 0.34, dated 2026-09-01, manual section 1 for bup-ftp(1). slay, go back up your stuff, ily, bye 💖🌸🎀🦋💅

📦 where this page comes from