BTRFS-ASSISTANT(8)

💖 BTRFS-ASSISTANT(8) 💖

okay bestie, welcome to the manual page for Btrfs Assistant 2.1 — yes, that's btrfs-assistant (section 8, system administration, we're doing Big Girl Sysadmin Things today), and also btfrs-assistant-bin and btrfs-assistant-launcher, which are the other names this thing answers to. she's got a lot of names, she's got main character energy, it's fine. 💅

✨ SYNOPSIS ✨

btrfs-assistant [options]

that's it. that's the whole vibe. you run her, you give her options, she does stuff. 🦋

🌸 DESCRIPTION 🌸

An application for managing Btrfs and Snapper.

fr fr that's the whole description. she manages your Btrfs and your Snapper. snapshots, restores, the whole thing. lowkey iconic. 👑

🎀 OPTIONS 🎀

okay this is the part you actually came for, so let's go, one at a time, no skipping, i would never do that to you:

• -h, --help — shows you the help for the commandline options. your girl is being helpful. 🫶
• --help-all — same energy but it also includes the Qt-specific options. the extended cut. ✨
• -v, --version — tells you what version you're running.
• -l, --list — lists your snapshots. just, like, shows you all of them. 🍓
• -r, --restore <index of snapshot> — restores the snapshot at the index of snapshot you give her. yes, this one actually does something real, be careful and be brave. 💀
• --qmljsdebugger <value> — turns on the QML/JS debugger on a port you specify. the value has to be in the format port:1234[,block] — and if you add block in there, the app will wait for a connection instead of just zooming past. so port:1234,block = she's standing at the door waiting for you. 🙈
• --platform <platformName[:options]> — the QPA plugin. peep the QGuiApplication documentation for what options each plugin actually supports, i'm not making that up, it's literally in there.
• --platformpluginpath <path> — path to where the platform plugins live.
• --platformtheme <theme> — sets the platform theme.
• --plugin <plugin> — loads extra plugins, and yes you can pass this one more than once if you're feeling extra. stacking them. 🌈
• --qwindowgeometry <geometry> — window geometry for the main window, using X11 syntax, like 100x100+50+50. classic.
• --qwindowicon <icon> — sets the default window icon.
• --qwindowtitle <title> — sets the title of the first window.
• --reverse — flips the application's layout direction to Qt::RightToLeft. it's a debugging helper, she's just doing tricks. 🧚
• --session <session> — restores the application from an earlier session. time travel but make it Qt.
• --display <display> — sets the display name, and it overrides $DISPLAY.
• --name <name> — instance name according to ICCCM 4.1.2.5. very specific, very official, we respect it.
• --nograb — disables mouse grabbing. genuinely useful when you're running in a debugger. 😭
• --dograb — forces mouse grabbing, even when you're running in a debugger. the opposite of the one above, she contains multitudes.
• --visual <id> — the ID of the X11 Visual to use.
• --geometry <geometry> — alias for --qwindowgeometry. same thing, shorter name, slay. 💅
• --icon <icon> — alias for --qwindowicon.
• --title <title> — alias for --qwindowtitle.

ngl the aliases at the bottom are just the long names in a cute little outfit. use whichever one sparks joy. 🌸

and that's the whole page, bestie, you read all of it, i'm so proud. 💖 this was Btrfs Assistant 2.1, from June 2024, section 8 of the manual, filed under system administration. go manage those snapshots. periodt. ✨👑🦋