fimgs(1)

✨ fimgs(1) — the manual page, bestie edition ✨

okay so. you opened man fimgs and now you're here, and honestly? you're in the right place. welcome to fimgs, a whole General Commands Manual moment. grab a snack, we're doing this. 💖

---

🌸 NAME 🌸

fimgs — poor man's [http://]PostScript/pdf/dvi/cbr/rar/cbz/zip viewer based on fim

no cap, that's literally the name. "poor man's" is the vibe and it ate. 💅

---

🦋 SYNOPSIS 🦋

fimgs [ {fimgs-options} ] file [-- [{fim-options}]]

that's it. that's the whole summoning ritual. ✨

---

💜 DESCRIPTION 💜

fimgs is a wrapper script, and bestie, a wrapper script is exactly what it sounds like: it takes your input and then hands it off like it's passing notes in class. 📝

So. It takes a PostScript or pdf or .cbr or .rar or .cbz or .zip or .dvi file — or any of the above prefixed with http:// or https:// or ssh: — renders the pages using ghostscript into a temporary directory, and finally calls fim to display them. iconic behavior honestly. 🔥

Now for compressed archives, i.e. the ZIP and RAR formats: the images get decompressed into a directory and displayed using fim. But listen, this is the important part — in this case, only images contained in the archive will be displayed. That means no nested archives or pdf's or ps's or dvi's. none. zero. the vibe check stops at the first layer. 🫶

The temporary directory name will be of the form $TMPDIR/fbps-$$. If the $TMPDIR environment variable is unset, /dev/shm and /var/tmp will be checked for existence and permissions. That $$ up there? It's the script process ID. Not me being dramatic, that's just what it is. And the script deletes the temporary directory when fim terminates — it cleans up after itself, unlike some people. 😭

Now, the little helper programs it pulls up to the group chat, depending on what you're doing:

• To uncompress RAR archives, fimgs will use 'unrar-nonfree' or 'rar' or 'unrar-free'.
• To uncompress ZIP archives, fimgs will use 'zip'.
• To uncompress BZ2 files, 'bunzip2' will be used, if present.
• To uncompress TAR.GZ or TAR.BZ2 or TAR.XZ archives, fimgs will use 'tar'.
• To fetch http:// or https:// prefixed URLS, 'wget' will be used, if present.
• To fetch ssh: prefixed host:path locations, 'scp' will be used.

And in case of a CBZ, CBR, PDF, PS, or DVI file, it will invoke fim with '--autotop --autowidth'. slay. 💅

---

🎀 OPTIONS 🎀

First things first, queen: to pass through options to fim, you may specify them after "--". that's the whole trick. 🪄

Default options are '--autozoom'. (yes, that's the default vibe. autozoom. obsessed.)

• -r {resolution} — Specify resolution for the 'gs' -r option (e.g.: 96x96; default 120x120).
• -m — Dump a man page for fimgs. (meta. recursive. we love to see it. 🌀)
• -p {password} — Specify password for the 'gs' -p (password) option.
• -h — Will display a help message.

---

🌈 SEE ALSO 🌈

fim(1), fimrc(1), gs(1), fbi(1), fbgs(1), bash(1) ,zip(1), rar(1), rar-free(1), unrar-free(1), tar(1), gzip(1)

the whole friend group, fr fr. 🫂

---

👑 AUTHOR 👑

Michele Martone <dezperado _ GUESS _ autistici.org>.

(the _ GUESS _ is literally in there, I didn't do that, I'm just the messenger 🙈)

---

and that's the page!! if you made it this far you're genuinely the main character. now go read a pdf in your terminal like the icon you are. no notes. periodt. 💜

© 2007-2023 Michele Martone — that's the copyright, that's the date range, and this whole fimgs(1) manual moment has been brought to you by them. byeee bestie, go read something pretty 💖✨🎀