Please note that the full documentation of fim is in the FIM.TXT file distributed in the source package. This man page only describes the fim command line switches.
For example, -c '*2;2pan_up;display;while(1){bottom_align;sleep "1" ; top_align}'
(with the single quotes) will tell fim to first double the displayed image size, then pan two times up, then display the image ; and then do an endless loop consisting of bottom and top aligning, alternated.
Note that these the three standard input reading functionalities (-i,-p and -) conflict : if two or more of them occur in fim invocation, fim will exit with an error and warn about the ambiguity.
See the section EXAMPLES below to read some useful (and unique) ways of employing fim.
cursor keys scroll large images
h,j,k,l scroll large images left,down,up,right
+, - zoom in/out
ESC, q quit
Tab toggle output console visualization
PgUp,p previous image
PgDn,n next image
Space next image if on bottom, scroll down instead
Return next image, write the filename of the current image to stdout on exit from the program.
m mirror
f flip
r rotate by 90 degrees
d,x,D,X diagonal scroll
C-w scale to the screen width
H scale to the screen heigth
m mark the current file for printing its name when terminating fim
:{number} jump to {number}^th image in the list
:^ jump to first image in the list
:$ jump to last image in the list
:*{factor} scale the image by {factor}
:{scale}% scale the image to the desired {scale}
:+{scale}% scale the image up to the desired percentage {scale} (relatively to the original)
:-{scale}% scale the image down to the desired percentage {scale} (relatively to the original)
/regexp entering the pattern {regexp} (with /) makes fim jump to the next image whose filename matches {regexp}
/*.png$ entering this pattern (with /) makes fim jump to the next image whose filename ends with 'png'
/png a shortcut for /.*png.*
!{cmd} executes the {cmd} string as a "/bin/sh" shell command
C-n after entering in search mode (/) and submitting a pattern, C-n (pressing the Control and the n key together) will jump to the next matching filename
C-c terminate instantaneously fim
T split horizontally the current window
V split vertically the current window
C close the currently focused window
H change the currently focused window with the one on the left
J change the currently focused window with the lower
K change the currently focused window with the upper
L change the currently focused window with the one on the right
U swap the currently focused window with the split sibling one (it is not my intention to be obscure, but precise : try V, m, U and see by yourself :) )
d move the image diagonally north-west
D move the image diagonally south-east
x move the image diagonally north-east
X move the image diagonally south-west
m mirror
f flip
r rotate
You can visualize all of the default bindings invoking fim --dump-default-fimrc | grep bind .
You can visualize all of the default aliases invoking fim --dump-default-fimrc | grep alias .
The Return vs. Space key thing can be used to create a file list while reviewing the images and use the list for batch processing later on.
All of the key bindings are reconfigurable; please see the default fimrc file for examples on this, or read the complete manual: the FIM.TXT file distributed with fim.
FBFONT (just like in fbi) a consolefont or a X11 (X Font Server - xfs) font file.
For instance, /usr/share/consolefonts/LatArCyrHeb-08.psfu.gz is a Linux console file.
Consult 'man setfont' for your current font paths.
NOTE : Currently xfs is disabled.
FBGAMMA (just like in fbi) gamma correction.
FRAMEBUFFER (just like in fbi) if set, will override user set framebuffer device file.
TERM (only in fim: see the default fimrc) will influence the output device selection algorithm, especially if $TERM=="screen"
If using udev, you can edit :
/etc/udev/permissions.d/50-udev.permissions
and set these lines like here :
# fb devices
fb:root:root:0600
fb[0-9]*:root:root:0600
fb/*:root:root:0600
fim also needs access to the linux console (i.e. /dev/ttyN) for sane console switch handling. That is obviously no problem for console logins, but any kind of a pseudo tty (xterm, ssh, screen, ...) will not work.
#will make fim read the file list from standard input.
find /mnt/media/ -name *.jpg | shuf | fim -
#will make fim read the file list from standard input, randomly permuted.
c cat script.fim | fim -p images/*
#will make fim read the script file script.fim from standard input prior to displaying files in the directory images
scanimage ... | tee scan.ppm | fim -i
#will make fim read the image scanned from a flatbed scanner as soon as it is read
fim * > selection.txt
#will output the file names marked interactively with 'm' in fim to a file.
fim * | fim -
#will output the file names marked with 'm' in fim to a second instance of fim, in which these could be marked again.
Michele Martone <dezperado _ GUESS _ autistici.org> is the author of fim, "fbi improved". Gerd Knorr <kraxel _ GUESS _ bytesex.org> is the original author of fbi, upon which this code is based.
Copyright (C) 2007-2009 Michele Martone <dezperado _ GUESS _ autistici.org> Copyright (C) 1999-2000 Gerd Knorr <kraxel _ GUESS _ bytesex.org> This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.