fiv/README.adoc

93 lines
3.5 KiB
Plaintext
Raw Normal View History

fiv
===
2021-07-14 07:09:19 +02:00
2022-07-22 19:35:03 +02:00
'fiv' is a slightly unconventional, general-purpose image browser and viewer
for Linux (as well as macOS and Windows, though these have known issues).
2021-07-14 07:09:19 +02:00
image::docs/fiv.webp["Screenshot of both the browser and the viewer"]
2022-01-06 12:42:34 +01:00
2022-01-07 12:15:14 +01:00
Features
--------
- Uses a compact thumbnail view, helping you browse collections comfortably.
2022-01-22 20:49:45 +01:00
- Supports BMP, (A)PNG, GIF, TGA, JPEG, WebP directly, plus optionally raw
photos, HEIC, AVIF, SVG, X11 cursors and TIFF, or whatever your gdk-pixbuf
modules manage to load.
2022-01-07 12:15:14 +01:00
- Employs high-performance file format libraries: Wuffs and libjpeg-turbo.
- Makes use of 30-bit X.org visuals, whenever it's possible and appropriate.
- Has a notion of pages, and tries to load all included content within files.
- Can keep the zoom and position when browsing, to help with comparing
zoomed-in images.
2022-01-07 12:15:14 +01:00
Explicit non-goals
------------------
- Editing--that's what _editors_ are for, be it GIMP or Rawtherapee;
nothing beyond the most basic of adjustments is desired.
- Following the latest GNOME HIG to the letter--header bars are deliberately
avoided, for their general user hostility.
- Memory efficiency is secondary to both performance and development effort.
2022-01-07 12:15:14 +01:00
Aspirations
-----------
Show colours as accurately as hardware allows. Open everything. Be fast.
Not necessarily in this order.
2021-07-14 07:09:19 +02:00
Packages
--------
Regular releases are sporadic. git master should be stable enough. You can get
a package with the latest development version from Archlinux's AUR.
Building and Running
--------------------
Build-only dependencies:
Meson, pkg-config, asciidoctor or asciidoc (recommended but optional) +
2023-06-03 21:36:21 +02:00
Runtime dependencies: gtk+-3.0, glib>=2.64, pixman-1, shared-mime-info,
libturbojpeg, libwebp, librsvg-2.0 (for icons) +
Optional dependencies: lcms2, LibRaw, librsvg-2.0, xcursor, libheif, libtiff,
ExifTool, resvg (unstable API, needs to be requested explicitly) +
Runtime dependencies for reverse image search:
xdg-utils, cURL, jq
2021-07-14 07:09:19 +02:00
$ git clone --recursive https://git.janouch.name/p/fiv.git
2021-07-14 07:09:19 +02:00
$ meson builddir
$ cd builddir
$ meson compile
2022-01-07 12:15:14 +01:00
Considering the vast amount of dynamically-linked dependencies, do not attempt
direct installations via `ninja install`. To test the program:
2022-01-07 12:15:14 +01:00
$ meson devenv fiv
2021-07-14 07:09:19 +02:00
The lossless JPEG cropper and reverse image search are intended to be invoked
from a context menu.
Windows
~~~~~~~
'fiv' can be cross-compiled for Windows, provided that you install a bunch of
dependencies listed at the beginning of 'msys2-cross-configure.sh',
plus rsvg-convert from librsvg2, and icotool from icoutils.
Beware that the build will take up about a gigabyte of disk space.
$ sh -e msys2-cross-configure.sh builddir
$ meson install -C builddir
If everything succeeds, you will find a portable build of the application
in the 'builddir/package' subdirectory. Keep your expectations low.
Documentation
2021-11-22 20:51:59 +01:00
-------------
For information concerning usage, refer to link:docs/fiv.html[the user guide],
which can be invoked from within the program by pressing F1.
2021-11-23 14:58:21 +01:00
2021-07-14 07:09:19 +02:00
Contributing and Support
------------------------
Use https://git.janouch.name/p/fiv to report any bugs, request features,
2021-07-14 07:09:19 +02:00
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
License
-------
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.