NEWS
Since the last release of KuickShow (0.6.7), a lot has happened. The Qt and KDE
libraries have much improved; parts of it have been rewritten completely. This affects
especially KuickShow's filebrowser and the interaction with the window manager. The current
version of KuickShow has so far only been tested with "kwin", the WM of KDE2. Please report
eventual problems with other window managers, I'll try to fix them.
Two things that users of the previous KuickShow versions (<= 0.6.7) might miss:
- The filebrowser doesn't show the parent directory ".." anymore, to behave consistently
with Konqueror and the filedialog. As in those, you can use the shortcut Alt+Up to change
into the parent directory. Additionally, there are buttons in the toolbar for easy navigation.
- The shortcut Ctrl+G and the "Change directory" entry in the context menu have been removed.
The functionality was moved into the "filefinder", the little editfield in the lower right corner,
that appears when you start typing. You can enter absolute or relative paths or just filenames
of the current directory.
KuickShow is a comfortable image browser/viewer. It displays a filebrowser
where you can select images which are then shown. Select them by either clicking with
the mouse on them, hitting return or choosing "Show Image" in the context menu.
The following image formats are supported: jpg, gif, tiff, png, bmp, psd, xpm, xbm, pbm, xcf, eim.
Images can be displayed either in an own window, as large as the image,
or fullscreen. This is configurable in the options dialog.
Further options in the configuration dialog:
- After loading one image, the next can be loaded automatically in the background.
This greatly increases performance when stepping from one image to the next.
- You can set the delay time between images for the slideshow.
- The extensions of files to be shown in the browser can be set.
- You can tweak the speed/quality ratio.
The second page of the dialog offers options for modifying the appearance of images:
- Images can be automatically shrunk to fit onto the screen, if they are larger
- Images can be automatically scaled up to the display size, if they are smaller. Optionally,
a maximum scaling factor can be set.
- Images can be flipped horizontally or vertically, or rotated.
- The brightness, contrast and gamma value can be set.
The geometry and image modifications are shown in a preview image. The left image
shows the original image, the right one shows the same image with the modifications applied.
All the settings of this page are also available as keyboard shortcuts or in the context menu
of the image viewer.
In the next two pages, the shortcuts for the image viewer and the filebrowser can be configured.
Image window:
Keyboard shortcuts
- PageDown loads the next image
- PageUp loads the previous image
- Home loads the first image
- End loads the last image
- + zooms into the image
- - zooms out of the image
- * flips the image horizontally
- / flips the image vertically
- 7 rotates 270° clockwise ( = 90 degrees counterclockwise )
- 9 rotates 90° clockwise
- arrow keys move the image (or rather you, the viewer) if it is larger than the screen
- Return toggles between fullscreen and window mode
- Spacebar toggles showing the browser
- Esc or q closes the image window (and kuickshow too, if you don't have a browser window open
- b / B lightens / darkens the image
- c / C adds / removes contrast
- g / G more / less gamma
- o shows image in original size (useful when automatic up/downscaling is active, or the has image been scaled)
- m maximizes the image
- Enter rerenders the image in default settings/size
- Ctrl-s opens a filedialog to save the current image
- Delete deletes the current image
- Shift-Delete deletes the current image without asking
- F1 opens the online help
- Ctrl-q quits KuickShow
Mouse usage
- right button opens a context menu with several options
- left button held + move moves image, if it doesn't fit into the window
- Shift + left button held + move let's you mark a rectangle to zoom into
- left doubleclick closes the the current image
Browser window:
Keyboard shortcuts
- Return enters a directory or opens an image window
- Alt-Return shows the properties of the selected file/directory and allows renaming it.
- PageDown advances one page
- PageUp moves back one page
- Home selects the first file/directory
- End selects the last file/directory
- Alt-Up changes into the parent directory
- Alt-Left "back", changes into the previous directory
- Alt-Right "forward", changes into the previous directory after "going back"
- Ctrl-Home changes into the home directory
- Spacebar toggles showing the browser, if an imagewindow is open
- "any character" opens a small editfield for finding files in the current directory or
changing directories.
- Delete deletes the current file
- Shift-Delete deletes the current file without asking
- F1 opens online help
- F2 starts a slideshow with all images of the current directory
- F5 reloads the current directory
- Ctrl-q quits KuickShow
Mouse usage
- Single leftclick enters a directory, or selects an image window
- Single rightclick opens a context menu with several options
- Doubleclick loads the selected image / enters the selected directory
If you're looking for a certain file in the current directory, just enter the first
characters of its filename (in the browser). A small editfield will pop up in the
bottom-right corner. Once a matching file is found, it is highlighted. Pressing return
will show the image or enter the directory, depending on whether it's a file or directory.
You can leave the edit-window by pressing escape.
Commandline parameters
You can pass KuickShow commandline parameters:
By starting it as
kuickshow /home/user/images/bla.jpg
n window showing the given image will appear. The filebrowser will be hidden
until you press Space. When showing the filebrowser, it will open the directory
of the given filename. If you give more than one images on the commandline, the
browser will show the directory of the last image.
If you just specify a directory on the commandline, e.g.
kuickshow /usr/local/images/
it will just open a browser with that directory. The path to an image or a directory
can be both absolute or relative.
You can also drop images from the KDE filemanager onto an image window or the filebrowser.
Configuration file
The configuration of KuickShow will be saved in the file $KDEHOME/share/config/kuickshowrc.
If the environment variable KDEHOME is not set, it will get substituted by $HOME. You can
manually modify or delete the config file as long as kuickshow is not running (otherwise
your changes will be overwritten). It will use the new settings (or the defaults if you
deleted the file) from the next start on.
Bugs / Limitations
- Printing does work, but is very limited. Printed images are stretched to fully
fit on the page, which is probably not what you always want :-}
- The filefinder in the browser doesn't work correctly when you use the splitted
view (directories and files in a separate view).
See the