riv is a Ruby image viewer.

A simple image viewer coded using ruby, Qt4 and KDE.

Riv is not the fastest image viewer but, if you use digikam, probably you found it useful.

Installation & configuration

ruby, rubygems, rubygem-sqlite3, ruby-kde4, or equivalent packages, are required.

1) Copy riv to ~/bin
2) Edit file permissions and check "Is executable".

Usage: riv [options] [URL]

Specific options:
-c, --cfg FILE Configuration (default ~.kde4/share/config/rivrc).
-d, --digikam Shows a random digikam image.
-f, --frameless Disable window frame.
-p, --print_cfg Prints program default configuration.
-t, --digikam_tag [TAG] Digikam tag.
-w, --write_cfg Creates a default configuration file in default location.

Common options:
-h, --help Show this message.
-v, --version Show version.

Hot-Keys

d -> view random digikam image.
ctrl+d -> set digikam albums path.
ctrl+t -> select digikam tag.
f -> window frame toggle.
o -> restore zoom.
+ -> zoom +.
- -> zoom -.
esc -> quit.
space -> next image (mouse wheel down)
backspace -> previous image (mouse wheel up).
home -> first image.
end -> last image.

Requirements:

· KDE 4.x

What's New in This Release:

· Now internet protocols http://, https:// and ftp:// are supported. I try to use kio but I can't found examples of using kio from ruby bindings. Waiting for a better solution I use wget to download pictures.
· BUG fixed: pause button changes form caption even if riv is not in slideshow mode.