diff options
| author | Přemysl Eric Janouch <p@janouch.name> | 2022-01-07 12:15:14 +0100 | 
|---|---|---|
| committer | Přemysl Eric Janouch <p@janouch.name> | 2022-01-07 12:16:19 +0100 | 
| commit | 7160a915e2d47514d53e9c0dc0c4a14711a22b3b (patch) | |
| tree | a02f7083fb7c461541bfccc9d49476e521f98d1a | |
| parent | 6a878fd3c43ff96bf46f9f0a99cb48f0e1ce2779 (diff) | |
| download | fiv-7160a915e2d47514d53e9c0dc0c4a14711a22b3b.tar.gz fiv-7160a915e2d47514d53e9c0dc0c4a14711a22b3b.tar.xz fiv-7160a915e2d47514d53e9c0dc0c4a14711a22b3b.zip  | |
Update README
| -rw-r--r-- | README.adoc | 45 | 
1 files changed, 29 insertions, 16 deletions
diff --git a/README.adoc b/README.adoc index 0513e62..7837f4b 100644 --- a/README.adoc +++ b/README.adoc @@ -1,22 +1,32 @@  fiv  === -'fiv' is an image browser and viewer, supporting BMP, PNG, GIF, JPEG, WebP -directly, plus optionally raw photos, HEIC, AVIF, SVG, X11 cursors and TIFF, -or whatever gdk-pixbuf loads. - -Its development status can be summarized as '`beta`'. -E.g., certain GIFs animate wrong. +'fiv' is a slightly unconventional, general-purpose image browser and viewer.  image::fiv.webp["Screenshot of both the browser and the viewer"] -Non-goals ---------- - - fancy UI--the focus is on speed of use first, colour accuracy second - - editing--that's what _editors_ are for, be it GIMP or Rawtherapee; -   nothing beyond the most basic of adjustments is desired - - memory efficiency, though preloading can cause some pressure - - portability to non-UNIXy systems +Features +-------- + - Uses a compact thumbnail view, helping you browse collections comfortably. + - Supports BMP, (A)PNG, GIF, JPEG, WebP directly, plus optionally raw photos, +   HEIC, AVIF, SVG, X11 cursors and TIFF, or whatever gdk-pixbuf loads. + - 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. + +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. + - Portability to non-UNIXy systems, although patches are welcome. + - Memory efficiency is secondary to both performance and development time. + +Aspirations +----------- +Show colours as accurately as hardware allows.  Open everything.  Be fast. +Not necessarily in this order.  Packages  -------- @@ -36,9 +46,12 @@ gdk-pixbuf-2.0, ExifTool   $ cd builddir   $ meson compile -To install the application, you can do: +Considering the vast amount of dynamically-linked dependencies, do not attempt +direct installations.  To test the program, help it find its custom thumbnailer: + + $ PATH=$(pwd):$PATH ./fiv - # meson install +Pressing F1 will give you a convenient list of keyboard shortcuts.  Configuration  ------------- @@ -48,7 +61,7 @@ _~/.config/gtk-3.0/gtk.css_:   fiv-browser { -FivBrowser-spacing: 0; padding: 0; border: 0; margin: 0; } -The GTK+ inspector will be very helpful, should you want to experiment. +Should you want to experiment, you will find the GTK+ inspector very helpful.  Contributing and Support  ------------------------  | 
