| 1 |
.TH fimgs 1 "(c) 2007-2023 Michele Martone" |
| 2 |
.SH NAME |
| 3 |
fimgs - poor man's [http://]PostScript/pdf/dvi/cbr/rar/cbz/zip viewer based on fim |
| 4 |
.SH SYNOPSIS |
| 5 |
.B fimgs [ {fimgs-options} ] file [-- [{fim-options}]] |
| 6 |
.SH DESCRIPTION |
| 7 |
.B fimgs |
| 8 |
is a wrapper script which takes a PostScript or pdf or .cbr or .rar or .cbz or .zip or .dvi or any of the above prefixed with http:// or https:// or ssh: as input, renders the pages using ghostscript into a temporary directory and finally calls \fB fim\fP to display them. |
| 9 |
|
| 10 |
In case of compressed archives (in ZIP or RAR formats), the images are decompressed into a directory and displayed using \fB fim\fP. |
| 11 |
In this case, only images contained in the archive will be displayed (no nested archives or pdf's or ps's or dvi's). |
| 12 |
|
| 13 |
The temporary directory name will be of the form $TMPDIR/fbps-$$. |
| 14 |
If the $TMPDIR environment variable is unset, /dev/shm and /var/tmp will be checked for existence and permissions. |
| 15 |
The $$ above is the script process ID. |
| 16 |
The script deletes the temporary directory when \fB fim\fP terminates. |
| 17 |
|
| 18 |
In order to uncompress RAR archives, fimgs will use 'unrar-nonfree' or 'rar' or 'unrar-free'. |
| 19 |
|
| 20 |
In order to uncompress ZIP archives, fimgs will use 'zip'. |
| 21 |
|
| 22 |
In order to uncompress BZ2 files, 'bunzip2' will be used, if present. |
| 23 |
|
| 24 |
In order to uncompress TAR.GZ or TAR.BZ2 or TAR.XZ archives, fimgs will use 'tar'. |
| 25 |
|
| 26 |
In order to fetch http:// or https:// prefixed URLS, 'wget' will be used, if present. |
| 27 |
|
| 28 |
In order to fetch ssh: prefixed host:path locations, 'scp' will be used. |
| 29 |
|
| 30 |
In case of a CBZ, CBR, PDF, PS, or DVI file, will invoke \fB fim\fP with '--autotop --autowidth'. |
| 31 |
|
| 32 |
.SH OPTIONS |
| 33 |
To pass through options to \fB fim\fP, you may specify them after "--". |
| 34 |
|
| 35 |
Default options are '--autozoom'. |
| 36 |
|
| 37 |
.B -r {resolution} |
| 38 |
Specify resolution for the 'gs' -r option (e.g.: 96x96; default 120x120). |
| 39 |
.TP |
| 40 |
|
| 41 |
.B -m |
| 42 |
Dump a man page for fimgs. |
| 43 |
.TP |
| 44 |
|
| 45 |
.B -p {password} |
| 46 |
Specify password for the 'gs' -p (password) option. |
| 47 |
.TP |
| 48 |
|
| 49 |
.B -h |
| 50 |
Will display a help message. |
| 51 |
.\" Additionally you can specify -l, -xl or -xxl to get the pages |
| 52 |
.\" rendered with 100, 120 or 150 dpi (default is 75). |
| 53 |
.SH SEE ALSO |
| 54 |
fim(1), fimrc(1), gs(1), fbi(1), fbgs(1), bash(1) |
| 55 |
,zip(1), rar(1), rar-free(1), unrar-free(1), tar(1), gzip(1) |
| 56 |
.SH AUTHOR |
| 57 |
Michele Martone <dezperado _ GUESS _ autistici.org>. |