Menu
▾
▴
Tree [8c03dd] default tip / History
Read Me
imv v0.16.0 - keyboard-friendly image viewer in Gtk2-perl
BETA VERSION:
There might still be some errors in the code and things might be
changed in the later version.
=== Files ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
imv main
imv_tnv.pm thumbnail viewer
imv_pop.pm popup image viewer
imv_snd.pm SE player
imv_help.pm key-binding table viewer
imv_man.pm manual page viewer
imv_ver.pm about me window
imv_fck.pl file checker driver
imv_dm.pm directory scanner
imv_ex.pm archive extractor
imv_cv.pm file converter
imv_ft.pm list of non-image supported files
imv_fte.pm file checker by extension
imv_ftf.pm file checker by contents
imvcmd IPC client CUI
imv_ipc.pl IPC server/client for imv
imv_rmdir.pl temporary directory cleaner
loaders/ default location for external image loaders
...
resources/pix
imv*.png icon pix
pause.png pause pix used for slideshow
play.png play pix used for slideshow
hatena.png pix for unloadable files
blue.png LED-like pix shown in thumbnail viewer
gray.png LED-like pix shown in thumbnail viewer
logo/* for "imv_ver.pm"
resources/snd
page.mp3 page turn SE
slide.mp3 slide turn SE
stop.mp3 stop slideshow SE
start.mp3 resume slideshow SE
end.mp3 end of slideshow SE
extensions/ default directory for extensions
...
docs/ some documents
...
~/.imvrc start-up script: same as "-a ~/.imvrc"
=== Install ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Copy all the files to the installation directory and run imv. For
example,
% tar xvJf imv.tar.xz -C ~/lib
% ln -s ~/lib/imv/imv ~/bin/imvy
% rehash
% imvy ~/my/images
or
% perl imvy ~/my/images
* imv assumes perl is located in "/usr/local/bin"
=== Uninstall ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Remove all the files you have copied at the installation. imv makes no
files other than temporary files which are to be deleted on normal exit
and file-list files saved by the user.
=== Requirements :::::::::::::::::::::::::::::::::::::::::::::::::::::::
imv has been developed mainly on armv7l Linux 2.6.28-15-araneo (Ubuntu
9.04) and tested with the following packages:
Binaries:
* perl v5.18.2 mandatory with thread support
+ file v5.13 for checking file by contents
+ gs v8.64 for ps/eps/pdf conversion
+ unrar v3.80 for extracting files from archives
+ unzip v5.52 for extracting files from archives
+ tar v1.26 for extracting files from archives
+ lsof v4.78 for checking extracted or converted files
+ pod2man, nroff, xterm, less
for viewing manual pages and all
* tty v6.10 for imvcmd to receive messages
perl modules:
* Glib v1.304 mandatory
* Gtk2 v1.247 mandatory
+ Cairo v1.104 for slideshow
+ GStreamer v0.19 for playing SE
* Cwd v3.40 mandatory: for directory scan etc.
* Encode v2.57 mandatory: imv assumes utf8 for filenames
+ File::Find v1.20 for directory scan
+ File::Path v2.08_01 for $TMPDIR cleaning
+ File::Temp v0.2304 for making $TMPDIR of extracted/converted
files
+ base v2.18 for "imv_pop.pm"
+ Digest::MD5 v2.53 for searching duplicate files etc.
* Fcntl v1.11 mandatory: for non-blocking IPC I/O
imv might and might not work anyway if some of above softwares were
not installed. imv dose not check the existence of all of them and the
behavior in the case of lacking the necessary softwares is not
observed yet by the developers of imv.
=== Usage ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Usage information for general users is available by "-h" option which
calls pod2man imv |nroff -man |less.
In case "-h" option dose not work for lacking pod2man and so on, the
same contents can be found in imv under "=pod" line in pod format.
Developers might find doc/advanced-usage.txt of some help to customize
imv, which describes user-defined key-bindings, functions, variables and
status-bar strings.
=== Key-bindings :::::::::::::::::::::::::::::::::::::::::::::::::::::::
?-key in the main window of imv opens a table of key-bindings.
Control-h also shows the same contents on a terminal.
See docs/kb-readme.txt for more information.
=== Copyright and License ::::::::::::::::::::::::::::::::::::::::::::::
This software is free and provided to you ``AS IS'' without warranty
of any kind and is
Copyright (c) 2013-2014 by Elseif Laboratory,
licensed under:
The Artistic License 2.0
=== Author ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Elseif Laboratory <elseifkk@users.sf.net>