ouch(1)

πŸ“¦
version 0.8.3 Β· 2 versions
, in arch rolling, nixpkgs unstable

πŸ’… ouch(1) β€” the manual page, but make it slay

okay bestie, so ouch is the command-line utility for easily compressing and decompressing files and directories. that's it, that's the whole vibe. it's from the General Commands Manual, section <pink>1</pink>, and it's genuinely iconic for how much it just works. 🫢


✨ NAME ✨

ouch β€” a command-line utility for easily compressing and decompressing files and directories.

like, no cap. that's literally the whole job and it ate. πŸ’…


🌸 SYNOPSIS 🌸

ouch [-y|--yes] [-n|--no] [-A|--accessible] [-H|--hidden] [-q|--quiet]
[-g|--gitignore] [-f|--format] [-p|--password] [-c|--threads]
[-h|--help] [-V|--version] <subcommands>

it's giving "technically one command, but it does everything." main character energy fr fr. πŸ‘‘


πŸ’– DESCRIPTION πŸ’–

so here's the thing, bestie: ouch is a command-line utility for easily compressing and decompressing files and directories. lowkey that's the entire pitch and honestly? it doesn't need more.

the formats it supports? a whole roster, bestie, like a group chat with every icon in it: tar, zip, gz, 7z, xz, lzma, lzip, bz/bz2, bz3, lz4, sz (that's Snappy, iykyk), zst, rar and br. that's the full list, no gatekeeping. ✨

the repository lives at https://github.com/ouch-org/ouch if you wanna go be nosy. πŸ¦‹


πŸŽ€ OPTIONS πŸŽ€

okay, the flags. there's a lot but they're all baddies, i promise. one bullet each, exactly as documented:

  • -y, --yes β€” skips the [Y/n] questions and defaults to yes. auto-consent era. πŸ’…
  • -n, --no β€” skips the [Y/n] questions and defaults to no. respectfully declining, always. πŸ™ˆ
  • -A, --accessible β€” activates accessibility mode, reducing visual noise. calm, quiet, still slaying. 🌸
  • -H, --hidden β€” ignore hidden files. the invisible ones don't get an invite. 🫢
  • -q, --quiet β€” silence output. she's not talking rn. 🀫
  • -g, --gitignore β€” ignore files matched by git's ignore files. git said not today and ouch listened. πŸ’€
  • -f, --format <FORMAT> β€” specify the format of the archive. you pick, it commits. ✨
  • -p, --password <PASSWORD> β€” decompress or list with password. secret girl stuff. πŸ”
  • -c, --threads <THREADS> β€” concurrent working threads. multitasking icon behavior. ⭐
  • -h, --help β€” print help (see a summary with -h). cute little cheat sheet energy. πŸŽ€
  • -V, --version β€” print version. identity check. πŸ‘‘

πŸ¦‹ SUBCOMMANDS πŸ¦‹

each one has its own whole manual page and honestly they all ate:

  • ouch-compress(1) β€” compress one or more files into one output file. gathering the girlies into one group chat. πŸ’Œ
  • ouch-decompress(1) β€” decompresses one or more files, optionally into another folder. opening the group chat back up (and you can move it to a new folder, fancy). 🎁
  • ouch-list(1) β€” list contents of an archive. like scrolling the member list before you say anything. πŸ‘€

🌈 VERSION 🌈

v0.8.3


πŸ’‘ friendly reminder bestie: the flags above do exactly what it says and nothing more. don't invent behavior, don't assume defaults beyond what's written, and definitely don't guess at what -f <FORMAT> will do with a format that isn't listed. iykyk. 🫢

peace, love, and compression ✨ β€” this page is from ouch 0.8.3, and the footer says ouch 0.8.3 dated ouch(1), so basically the whole page is a shrine to version 0.8.3 and she earned it. πŸ’– πŸŽ€ πŸ¦‹

πŸ“¦ where this page comes from