wxyzv: yet another image viewer

Copyright (C) 1999 David Flater

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Why this exists

I made wxyzv in 1999 so I could efficiently review a large number of JPEGs. It later found use as a way to quickly display a png screenshot in a window for reference while I work on something else.

Then and now, I found the widely-available desktop image viewers to be bloated, complicated, cumbersome, and slow for what I needed to do. Although the computational overhead of scaling and displaying large images is no longer a factor, wxyzv still wins on ergonomics.

Where to find it

Source distribution: https://flaterco.com/files/wxyzv/
Copy of the README: https://flaterco.com/wxyzv.html





wxyzv is packaged with the popular and portable GNU Automake, so all usual GNU tricks should work. Help on configuration options can be found in the INSTALL file or obtained by entering ./configure --help.

Normally, one should only need to do the following to compile and install wxyzv:

bash$ ./configure
bash$ make
bash$ su
bash# make install


wxyzv file [file...]

space                            go to next image
p or P                           go back to previous image
q or Q                           quit
up arrow / mouse roller          adjust gamma (brighter)
down arrow / mouse roller        adjust gamma (darker)
left arrow / mouse button        smoother
right arrow / mouse button       sharper
r                                rotate clockwise
R                                rotate counterclockwise
f or F                           toggle JPEG scaling
m or M                           toggle NetWM fullscreen

The fullscreen button does not affect the scale of the displayed image. Fullscreen mode is enabled by default just to stop the window manager from overriding the size and position of the window. Toggling it off brings back the window decorations and enables manual repositioning, but the window manager may force the window to a smaller size, causing the bottom or side of the image to be cut off.


Send bug reports to dave@flaterco.com.

There is no time budgeted to add features to this program since many full-featured alternatives already exist.

Change log

wxyzv 1.2 (2022-06-11)

Unsolved problem:

wxyzv 1.1.1 (2011-03-30)

wxyzv 1.1 (2006-04-09)

Added rotation feature. Fixed miscellaneous code rot.

wxyzv 1.0 r2 (2005-06-16)

Documentation changes only: updated e-mail address, synced with web page.

wxyzv 1.0 (2000-01-02)