KDE-Apps.org Applications for the KDE-Desktop 
 GTK-Apps.org Applications using the GTK Toolkit 
 GnomeFiles.org Applications for GNOME 
 MeeGo-Central.org Applications for MeeGo 
 CLI-Apps.org Command Line Applications 
 Qt-Apps.org Free Qt Applications 
 Qt-Prop.org Proprietary Qt Applications 
 Maemo-Apps.org Applications for the Maemo Plattform 
 Java-Apps.org Free Java Applications 
 eyeOS-Apps.org Free eyeOS Applications 
 Wine-Apps.org Wine Applications 
 Server-Apps.org Server Applications 
 apps.ownCloud.com ownCloud Applications 
 KDE-Look.org Artwork for the KDE-Desktop 
 GNOME-Look.org Artwork for the GNOME-Desktop 
 Xfce-Look.org Artwork for the Xfce-Desktop 
 Box-Look.org Artwork for your Windowmanager 
 E17-Stuff.org Artwork for Enlightenment 
 Beryl-Themes.org Artwork for the Beryl Windowmanager 
 Compiz-Themes.org Artwork for the Compiz Windowmanager 
 EDE-Look.org Themes for your EDE Desktop 
 Debian-Art.org Stuff for Debian 
 Gentoo-Art.org Artwork for Gentoo Linux 
 SUSE-Art.org Artwork for openSUSE 
 Ubuntu-Art.org Artwork for Ubuntu 
 Kubuntu-Art.org Artwork for Kubuntu 
 LinuxMint-Art.org Artwork for Linux Mint 
 Arch-Stuff.org Art And Stuff for Arch Linux 
 Frugalware-Art.org Themes for Frugalware 
 Fedora-Art.org Artwork for Fedora Linux 
 Mandriva-Art.org Artwork for Mandriva Linux 
 KDE-Files.org Files for KDE Applications 
 OpenTemplate.org Documents for OpenOffice.org
 GIMPStuff.org Files for GIMP
 InkscapeStuff.org Files for Inkscape
 ScribusStuff.org Files for Scribus
 BlenderStuff.org Textures and Objects for Blender
 VLC-Addons.org Themes and Extensions for VLC
 KDE-Help.org Support for your KDE Desktop 
 GNOME-Help.org Support for your GNOME Desktop 
 Xfce-Help.org Support for your Xfce Desktop 
openDesktop.orgopenDesktop.org:   Applications   Artwork   Linux Distributions   Documents    Linux42.org    OpenSkillz.com   


- Content .- Fans  .- Knowledge Base  . 



KDE Graphic Viewer

Score 63%

Minimum required   KDE 4.x
Downloads:  209
Submitted:  Jul 23 2008
Updated:  Mar 26 2009


riv - Ruby Image Viewer

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

Riv tries to mimic kuickshow simple interface but with some improvements:

- easy digikam albums and tags accesibility. You can easily create a desktop icon for access to specific images from your digikam albums without open digikam.
- copy viewed image (duplicate) to a new windowm. You can mantain de original image an manipulate a copy.
- save current layout. You can prepare a layout of some of your images and later restore the layout. See the screenshot for a sample.
- window frameless mode.

Planning features:

- digikam tag tree support.
- layouts slideshow.
- installer (icon and file association).
- thumbnails viewer.
- preconfigured slideshows (images, time, position, zoom, rotation, etc...).
- configuration form.
- support of digikam 4 database format.

This is my first Ruby program and my first Qt program, so suggestions from ruby & qt programmers are welcome :).

Installation & configuration

ruby, rubygems, rubygem-sqlite3, ruby-kde4, or equivalent packages, are required. wget is required to download files from internet.

1) Copy riv to ~/bin
2) Edit file permissions and check "Is executable".
3) Optional, but really useful, is create a desktop icon to the program :).
4) If you try riv -h in console you can see:

Usage: riv [options] [URL]

Specific options:
-c, --cfg FILE Alternate configuration file (default '~/.kde4/share/config/rivrc').
-w, --write_cfg [FILE] Creates/overwrites a configuration file.
-f, --frameless Disable window frame.
-p, --print_cfg Prints program configuration.
-d, --digikam Shows first digikam imagen from current album/tag.
-r, --digikam_random Shows random digikam image from current album/tag.
-a, --digikam_album ALBUM Selects digikam album.
-t, --digikam_tag TAG Selects digikam tag.
-l, --layout [LAYOUT] Loads LAYOUT layout.

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

c -> copy viewed image to a new window.
f -> window frame toggle.
esc -> quit.
ctrl+d -> set digikam albums path.
ctrl+a -> select digikam album and shows an image from album.
ctrl+t -> select digikam tag and shows an image from tag.
d -> view first digikam image in current album/tag and sets secuencial mode.
r -> view random digikam image in current album/tag and sets random mode.
o -> restore zoom / best fit.
+ -> zoom +.
- -> zoom -.
ctrl+- -> rotate 90º left.
ctrl++ -> rotate 90º right.
space -> next image (mouse wheel down).
backspace -> previous image (mouse wheel up).
home -> first image.
end -> last image.
s -> save layout.
ctrl+s -> overwrite layout.
l -> load layout.
e -> erase layout
ctrl+e -> clear layout.
ctrl+w -> start/stop secuential slideshow.
ctrl+r -> start/stop random slideshow.
p -> pause/unpause slideshow.
F11 -> toggle fullscreen mode.

Use left button & mouse to move image, control + left button.& mouse to move the form.

Please, read file comments for more info and documentation updates.


----- 26/03/09 -----
version 0.8 - Dot-comma release:
- CHANGE: Caption form string format changed.
- CHANGE: If riv can't open file riv exists directly.
- BUG fixed: sometimes forms caption don't displays correctly.
- BUG fixed: sometimes wget download fails for malformed url.
- BUG fixed: riv hangs loading configuration file for a wrong float numbers conversion
- BUG fixed: layouts fails to load due changes converting float numbers

----- 13/08/08 -----
version 0.7 - internet 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.

----- 10/08/08 -----
version 0.6 - slideshow release:
- layouts now are ordered by name.
- basic slideshow. Use Ctrl+w to start/stop secuential slideshow. Use Ctrl+r to start/stop random slideshow. Use "p" to pause/unpause slideshow.
- fullscreen mode (F11).
- secuencial and random digikam modes do not requery db unless necessary.
- riv now remembers the last image viewed.
- changed control + left key + mouse move to the more common alt key.
- code cleanups.
- BUG fixed: riv don't locate files with brackets in path due Dir.glob() limitation. I changed Dir.glob() for Dir.entries().

----- 29/07/08 -----
version 0.5 - layouts release:
- layouts. Use "s" key to save, "ctrl+s" to overwrite, "l" key to restore,
"e" key to delete saved layout and "ctrl+e" to clear current layout.
- recursive digikam subalbums/tags. Can be deactivated in configuration file.
- program displays now only first level digikam tags to avoid problems with tags tree. A solution will be available in a future release.
- various sql improvements and speedups.
- next/previous with skip x picture (Ctrl+Space and Ctrl+Backspace). X can be specified in configuration file.
- copy view works now.
- first steps to multilanguage.
- CHANGE: left click + mouse move the image, with control key the form is moved.
- BUG fixed: programs fails to locate initial image if directory is not
especified (for example, riv image.jpg). Workaround use "riv ./image.jpg".
- BUG fixed: copy view fails.
- BUG fixed: upper valid file extensions not recognized.
- BUG fixed: incorrect default configuration file location.

----- 25/07/08 -----
version 0.4 - a little improvement release:
- digikam album selection.
- digikam secuencial mode visualization.
- mouse feedback in time consuming operations.
- album & tag selection remembers last selection. added "clear selection" option.
- album & tag selection are case insensitive but only for 7 bits characters
due sqlite SQL limitation.
- parameter --write_cfg now accepts an optional FILE param.
- select file or directory to view.
- file open is the default operation if no operation is specified in command
- image rotation.
- code cleanups.
- more accurate magic windows decoration numbers. I don't found a better
solution :(.
- better error handling.
- BUG fixed: program hangs with paths and filenames with not 7 bits

----- 22/07/08 -----
version 0.3 - first public release:
- auto size improvement.
- initial digikam support. Random image from tag name. Tag selection.
- frameless mode.
- copy image. First try.
- adecuate config file path selection ~/.kde4/share/config/, ~/.kde/share/config/ or ~/.config/

----- 07/01/08 -----
version 0.2 - and might work for others release:
- mouse scroll.
- zoom.
- configuration file support.

----- 25/12/07 -----
version 0.1 - works for me release:

Send to a friend
Other  Apps  from eusonig
Report inappropriate content



 by cinan on: Jul 25 2008
Score 50%


Reply to this


 Re: screen

 by eusonig on: Jul 26 2008
Score 50%

One screenshoot added with multiple instances of riv viewing the same picture.

Reply to this



 by trebor on: Feb 21 2009
Score 50%

if i open a picture with riv, i had to delete the configfile rivrc to start riv again. otherwise i get the message:

/usr/bin/riv:1614:in `read': undefined method `to_f' for [0, 1]:Array (NoMethodError)
from /usr/bin/riv:2171

Reply to this


 Re: bug

 by eusonig on: Mar 25 2009
Score 50%

I found the problem. In a few days a will upload a new release.

Reply to this


 Re: Re: bug

 by trebor on: Mar 25 2009
Score 50%

thx ;-)

Reply to this

Add commentBack

How do you like Plasma 5?
 The best KDE Desktop ever.
 Definitely a nice improvement.
 Not decided yet. Haven't tried it yet.
 I do not like some of the changes.
 KDE is taking the wrong way.
 I am still sticking with KDE 3.5.
 I have no opinion, but wanted to vote anyway.

 Who we are
More about us
Frequently Asked Questions
Updates on identi.ca
Updates on Twitter
Content RSS   
Events RSS   

Add App
Public API
About KDE-Apps.org
Legal Notice
Spreadshirt Shop
CafePress Shop
Sponsor us
Report Abuse

Copyright 2003-2016 KDE-Apps.org Team  
All rights reserved. KDE-Apps.org is not liable for any content or goods on this site.
All contributors are responsible for the lawfulness of their uploads.
KDE and K Desktop Environment are trademarks of KDE e.V.