FABIO-CONVERT(1)

💖 FABIO-CONVERT(1) 💖

okay bestie, welcome to the user commands corner of the manual — this is fabio-convert, and no cap, she's a whole vibe. 🦋

---

✨ NAME ✨

fabio-convert — a portable image converter based on the FabIO library. that's it, that's the girl. 💅

---

🌸 DESCRIPTION 🌸

here's the whole lewk, exactly how she runs:

usage: fabio-convert [-h] [-V] [-v] [--debug] [-l] [-o OUTPUT] [-F FORMAT]
       [-f] [-n] [--remove-destination] [-u] [-i] [--dry-run]
              [IMAGE ...]

so basically: portable image converter based on the FabIO library. she takes your images and converts them, and she does it anywhere. main character energy fr fr. 👑

🎀 positional arguments

• IMAGE — the input file images. yes plural, you can hand her a whole little stack of them, she's not scared.

🧚 options

• -h, --help — shows this help message and dips out. classic.
• -V, --version — spits out the version and exits. short and iconic.
• -v, --verbose — spills the tea on every single conversion so you can see what she's doing.
• --debug — full debug information. like, everything. the messy details, the receipts, all of it. 🐛

⭐ main arguments

• -l, --list — shows you the list of every format she can handle, then exits. window shopping, but make it formats. 🛍️
• -o OUTPUT, --output OUTPUT — where the output goes: a file or a directory, your call bestie.
• -F FORMAT, --output-format FORMAT — tells her which output format you want. she needs to know. she's nosy like that.

💜 optional behaviour arguments

• -f, --force — if an existing destination file literally cannot be opened, she removes it and tries again. slay. but heads up: this option gets ignored when the -n option is also used.
• -n, --no-clobber — do not overwrite an existing file. we respect boundaries in this house. heads up again: this one gets ignored when the -i option is also used.
• --remove-destination — removes each existing destination file before attempting to open it. (contrast this with --force, they are not the same girl, don't get it twisted)
• -u, --update — only copies when the SOURCE file is newer than the destination file, or when the destination file is just… missing. lazy but in a smart way. 😌
• -i, --interactive — prompts you before overwriting. and yes, she overrides a previous -n option, so she's got main character energy in the flag hierarchy too. 💅
• --dry-run — she does everything except actually modifying the file system. like a rehearsal. manifesting the conversion. ✨

ngl, --dry-run is lowkey the bestie move — no regrets, no deleted files, just vibes. 🫶

---

🔥 return codes 🔥

• 0 — success, we ate, no crumbs. 👑
• 1 — the conversion contains a failure. 😭
• 2 — there was an error in the arguments. bestie, check your flags. 💀

---

fabio-convert 0.14.0 🦋 November 2022 — that's the version and the date this page was serving, and honestly? iconic of her. k bye, go convert something. 💖🌈