gitaction - GNU Interactive Tools - per file type action script
gitaction directory file
.gitaction directory file
gitaction is a script that executes a different action for each file
type specified. It is called by the gitfm program when pressing F2 or
^Xa (see the gnuitrc.TERM configuration files in the gnuit manual). The
first parameter is the current directory name and the second one is the
file name to be matched against the default patterns. The matching is
done using the shell ’case’ statement. If you press F2 or ^Xa on a
*.html file, gitfm will invoke a browser to view it, if you press F2 or
^Xa on a *.tar.gz file, gitfm will list the tar archive contents, if
you press the same keys on a *.gz file, gitfm will display its
uncompressed contents on the screen, etc ...
If you press F2 or ^Xa on a *.gif file or *.jpg file and you have the
zgv utility installed, you will be able to see it. If you want to
change the gif/jpeg viewer, all you need to do is to change its name in
the gitaction script.
There are many more file types and viewers that gitaction knows about.
In addition, if you are running under GNOME, gnome-open is used, and on
MacOS, open(1) is used. see(1) and metamail(1) are also used as
If all else fails, the file is displayed using $GNUIT_PAGER. Feel free
to change this. If you want to find out what the default action for
each file type is (or if you want to modify it), just read/modify the
The script can be easily enhanced. Just read it.
The .gitaction script is a local version of the gitaction script. When
started, gitaction tries to search a script called .gitaction in the
current directory and, if it finds it, it starts it. If .gitaction’s
exit code is 0 ( .gitaction couldn’t find a matching pattern),
gitaction starts its own case statement trying to match the current
file name (the second parameter) against its default patterns.
The .gitaction script *must* be executable. An example of .gitaction
can be found in the directory gitfm is installed into. (usually
/usr/local/bin or /usr/bin) Debian users can find it in
/usr/share/doc/gnuit/examples/. You should copy the example to the
current directory or your home directory and then modify it.
Please send bug reports to:
gitfm(1) gitps(1) gitview(1) gitmount(1) gitkeys(1) gitrgrep(1)
Tudor Hulubei <email@example.com>
Andrei Pitis <firstname.lastname@example.org>
Ian Beckwith <email@example.com> (current maintainer).