README
1xzgv - picture viewer for X, with thumbnail-based file selector.
2Copyright (C) 1999-2003 Russell Marks.
3Copyright (C) 2007-2017 Reuben Thomas.
4
5This program is free software; you can redistribute it and/or modify
6it under the terms of the GNU General Public License as published by
7the Free Software Foundation; either version 2 of the License, or (at
8your option) any later version.
9
10This program is distributed in the hope that it will be useful, but
11WITHOUT ANY WARRANTY; without even the implied warranty of
12MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13General Public License for more details.
14
15You should have received a copy of the GNU General Public License
16along with this program; if not, write to the Free Software
17Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18
19
20Guide to documentation
21----------------------
22
23The COPYING file contains a copy of the GPL described above.
24
25The NEWS file describes the changes made in each version, so if you're
26upgrading from an old xzgv, be sure to read the relevant parts of
27that.
28
29ChangeLog is similar to NEWS, but more hacker-orientated. :-)
30
31See INSTALL for details of how to install.
32
33
34Description
35-----------
36
37xzgv is a picture viewer for X, with a thumbnail-based file selector.
38It uses GTK+. Most file formats are supported, and the thumbnails
39used are compatible with xv, zgv, and the Gimp. It can also be used
40with `xzgv file(s)', to effectively bypass the file selector.
41For more on how xzgv works and how to use it, do `info xzgv' or `man
42xzgv' once it's installed.
43
44xzgv differs from other picture viewers for X in that it uses one
45window for both the file selector and viewer, it (unlike xv) allows
46both scrolling and fit-to-window methods of viewing large pictures,
47and it (unlike xv and some others) doesn't ever mangle the picture's
48aspect ratio without you telling it to.
49
50It also provides extensive keyboard support; if you prefer using the
51keyboard, this is probably the best viewer for you. But it doesn't
52skimp on the mousey stuff, either.
53
54So anyway, it's just terribly great. :-)
55
56
57Support and development
58-----------------------
59
60Please file bugs, patches etc. on the SourceForge page:
61
62https://sourceforge.net/p/xzgv/
63
64
65Share and enjoy!
66