unar(1)

✨ NAME ✨

ok so unar — she extracts archive file contents 💖 that's it that's the whole job, and she does it flawlessly, no cap 🫶

🌸 SYNOPSIS 🌸

unar [OPTION]... ARCHIVE [FILE]...

🦋 DESCRIPTION 🦋

bestie, you give her an ARCHIVE, and optionally some FILEs inside it, and she pulls those files out. Extract FILEs or the contents of ARCHIVE. simple as that, literally 💅

🎀 OPTIONS 🎀

• -o, -output-directory DIRECTORY — where she drops the goods. this is the directory the contents of the archive get written to. if you don't say anything, it defaults to the current directory. lowkey the default, but you can highkey change it 😌
• -f, -force-overwrite — always overwrite files when a file to be unpacked already exists on disk. by default the program asks the user if possible, otherwise skips the file. so like, no questions, just go 💥
• -r, -force-rename — always rename files when a file to be unpacked already exists on disk. she's not deleting anything, she's just giving the new one a glow-up name ✨
• -s, -force-skip — always skip files when a file to be unpacked already exists on disk. girl sees a collision and just walks past it 🚶♀️💨
• -d, -force-directory — always create a containing directory for the contents of the unpacked archive. by default, a directory is created if there is more than one top-level file or folder. so this one is like "no, we're ALWAYS making the folder, periodt" 📁
• -D, -no-directory — never create a containing directory for the contents of the unpacked archive. the opposite vibe, files just spill out wherever, chaotic but valid 🙈
• -p, -password PASSWORD — the password to use for decrypting protected archives. locked archives, we're getting in 🔐👑
• -e, -encoding ENCODING — the encoding to use for filenames in the archive, when it is not known. if not specified, the program attempts to auto-detect the encoding used. and ooh, pro tip: use "help" or "list" as the argument to give a listing of all supported encodings. cute right? 🌈
• -E, -password-encoding ENCODING — the encoding to use for the password for the archive, when it is not known. if not specified, then either the encoding given by the -encoding option or the auto-detected encoding is used. so she'll fall back on whatever she figured out earlier 💜
• -i, -indexes — instead of specifying the files to list as filenames or wildcard patterns, specify them as indexes, as output by lsar. numbers instead of names, iykyk 🔢
• -nr, -no-recursion — do not attempt to extract archives contained in other archives. for instance, when unpacking a .tar.gz file, only unpack the .tar file and not its contents. archive-ception? not today 💀
• -t, -copy-time — copy the file modification time from the archive file to the containing directory, if one is created. timestamps, preserved, iconic ⏰
• -k, -forks visible|hidden|skip — how to handle Mac OS resource forks. visible creates AppleDouble files with the extension ".rsrc", hidden creates AppleDouble files with the prefix "._", and skip discards all resource forks. defaults to visible. three whole moods, pick your fighter 🍓
• -q, -quiet — run in quiet mode. she's not gonna yap at you 🤫
• -v, -version — print version and exit. quick lil flex and she's out ✌️
• -h, -help — display help information. when you're lost, she's got you 🫶

💖 SEE ALSO 💖

• lsar(1) — her partner in crime, go say hi 🧚

⚠️ heads up bestie, -f, -r and -s are all fighting over the same job (what to do when a file already exists), so don't be surprised if they clash. pick one and commit 💅

and that's the whole page, mwah 💋 this was written by The Unarchiver, dated 2011-09-26, from the User Commands era of the manual — vintage, but still serving looks 👑⭐