X-Git-Url: http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=blobdiff_plain;f=README.md;h=35d2ec4629999b95c660bd4fa4c6af9458ff4906;hp=a1ae2534edab8d8ddf31eeec227babfc0ec34483;hb=24e7bb7be54da3d0d2d12c2031f5f4fc1dee739e;hpb=978ec2dd45c9c5a2477420e7b4b40c56014f2c7d diff --git a/README.md b/README.md index a1ae2534..35d2ec46 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,8 @@ + ################################################################### ## Geeqie x.x ## ## ## - ## Copyright (C) 2008 - 2017 The Geeqie Team ## + ## Copyright (C) 2008 - 2021 The Geeqie Team ## ## Copyright (C) 1999 - 2006 John Ellis. ## ## ## ## Use at your own risk! ## @@ -21,7 +22,10 @@ The Geeqie project will continue the development forward and maintain the existi Geeqie is currently considered stable. -For questions, problems or suggestions, please open an issue on [Geeqie at GitHub](https://github.com/BestImageViewer/geeqie/issues). +Please send any questions, problems or suggestions to the [mailing list](mailto:geeqie@freelists.org) or +open an issue on [Geeqie at GitHub](https://github.com/BestImageViewer/geeqie/issues). + +Subscribe to the mailing list [here](https://www.freelists.org/list/geeqie). The project website is and you will find the latest sources in the [Geeqie repository](http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git). @@ -67,7 +71,8 @@ Geeqie is a graphics file viewer. Basic features: * output: single image, anaglyph, SBS, mirror, SBS half size (3DTV) * Viewing raster and vector images, in the following formats: -3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM. Animated GIFs are supported. +3FR, ANI, APM, ARW, AVIF, BMP, CR2, CR3, CRW, CUR, DDS, DjVu, DNG, ERF, GIF, HEIC, HEIF, ICNS, ICO, JP2. JPE/JPEG/JPG, JPS, KDC, MEF, MOS, MPO, MRW, NEF, ORF, PBM/PGM/PNM/PPM, PEF, PNG, PSD, PTX, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WEBP, WMF, XBM, XPM. +Animated GIFs are supported. * Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program. @@ -95,20 +100,37 @@ Geeqie is a graphics file viewer. Basic features: * Maps from [OpenStreetMap](http://www.openstreetmap.org) may be displayed in a side panel. If an image has GPS coordinates embedded, its position will be displayed on the map - if Image Direction is encoded, that will be displayed also. If an image does not have embedded GPS coordinates, it may be dragged-and-dropped onto the map to encode its position. +# ## Downloading -Geeqie is available as a package with some distributions. +Geeqie is available: + +* as a package with some distributions. + +* as a [flatpak](https://flathub.org/apps/details/org.geeqie.Geeqie) from the [Flathub site](https://flathub.org/home). + +* as an [AppImage](https://cclark.uk/Geeqie). + +However Geeqie is stable and you may compile the latest version from sources. -The source tar of the latest formal release may be downloaded: +There are two scripts which will download and compile the sources for you. -However Geeqie is stable, and you may download the latest version (if you have installed git) from here: +The first script will install Geeqie to a defined location, and will run under any system. However, it is left to you to make sure dependencies are fulfilled. +To get the script, from the command line type:

+`wget https://raw.githubusercontent.com/pixlsus/Scripts/master/build-geeqie` + +The second script will run only on Debian-based system, but will fulfil all dependencies and also give you the opportunity to include additional pixbuf loaders and other useful programs. +To get the script, from the command line type:

+`wget https://raw.githubusercontent.com/BestImageViewer/geeqie/master/web/geeqie-install-debian.sh` + + +If you wish to compile the sources yourself you may download the latest version (if you have installed git) from here: Either: `git clone git://www.geeqie.org/geeqie.git` Or: `git clone http://www.geeqie.org/git/geeqie.git` - -## Installation +## Manual Installation List compile options: `./autogen.sh --help` @@ -157,12 +179,8 @@ And either the ChangeLog file or [Geeqie ChangeLog](http://geeqie.org/cgi-bin/gi optional items map display and GPU acceleration are not available with GTK2 - Note: GTK+3 is still somehow experimental. It is needed for some - features but we have several complains about the GTK+3 usability. - - So if you need a stable version, you are advised to compile it - with GTK+2. If you want to play with the cool new features, use - GTK+3. + Both GTK2 and GTK3 versions have been in use for several + years, and both may be considered stable. ### Optional libraries: lcms2 2.0 @@ -220,11 +238,46 @@ And either the ChangeLog file or [Geeqie ChangeLog](http://geeqie.org/cgi-bin/gi markdown when compiling Geeqie, to create this file in html format - libffmpegthumbnailer 2.0.0 + libffmpegthumbnailer 2.1.0 https://github.com/dirkvdb/ffmpegthumbnailer for thumbnailing camera video clips disable with configure option: --disable-ffmpegthumbnailer + libpoppler-glib-dev 0.62 + for displaying pdf files + disable with configure option: --disable-pdf + + libimage-exiftool-perl + For the jpeg extraction plugin + + liblcms2-utils + For the command-line tool jpgicc, used by the jpeg extraction plugin + + ImageMagick + exiftran + gphoto2 + ufraw + exiv2 + Additional command-line tools for various operations + + libheif + For displaying HEIF images + + libwebp + For displaying webp images + + libdjvulibre + For displaying DjVu images + + libopenjp2 + For displaying JP2 images + + libraw 0.20 + For displaying CR3 images + + yelp-tools + For creating the Help files + ### Code hackers: If you plan on making any major changes to the code that will be offered for