2022-01-24 08:41:05 +01:00
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
<html lang="en">
|
|
|
|
|
<head>
|
|
|
|
|
<meta charset="UTF-8">
|
|
|
|
|
<title>fiv: User Guide</title>
|
|
|
|
|
<link rel="stylesheet" href="stylesheet.css">
|
|
|
|
|
<style>
|
|
|
|
|
q:lang(en):before { content: "‘"; }
|
|
|
|
|
q:lang(en):after { content: "’"; }
|
|
|
|
|
</style>
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<h1>fiv: User Guide</h1>
|
|
|
|
|
|
|
|
|
|
<p class="details">
|
|
|
|
|
<span id="author">Přemysl Eric Janouch</span><br>
|
|
|
|
|
<span id="email"><a href="mailto:p@janouch.name">p@janouch.name</a></span><br>
|
|
|
|
|
<span id="revnumber">version 0.0.0,</span>
|
2023-04-17 07:17:16 +02:00
|
|
|
|
<span id="revdate">2023-04-17</span>
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
2023-04-17 07:17:16 +02:00
|
|
|
|
<p class="figure"><img src="fiv.webp" alt="fiv in browser and viewer modes">
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
|
|
|
|
<h2>Introduction</h2>
|
|
|
|
|
|
|
|
|
|
<p><i>fiv</i> is a general-purpose image browser and viewer. This document will
|
|
|
|
|
guide you through the application and help to familiarize you with it.
|
|
|
|
|
|
|
|
|
|
<h2>Controls</h2>
|
|
|
|
|
|
|
|
|
|
<p><i>fiv</i> is designed with computer mice having dedicated forwards/backwards
|
|
|
|
|
and page up/down buttons in mind, such as SteelSeries Sensei series. Ozone Neon
|
|
|
|
|
series may also be mapped this way. Your experience may be degraded with other
|
|
|
|
|
kinds of devices.
|
|
|
|
|
|
2023-04-17 07:17:16 +02:00
|
|
|
|
<p>Controls should generally be accessible through the keyboard. Pressing
|
|
|
|
|
<kbd>Ctrl</kbd> + <kbd>?</kbd> will give you a convenient overview
|
|
|
|
|
of all shortcuts. In addition to these, remember that you may often use
|
|
|
|
|
<kbd>Ctrl</kbd> + <kbd>Tab</kbd> and <kbd>F6</kbd> to navigate to
|
|
|
|
|
different groups of widgets.
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
|
|
|
|
<h2>Browser</h2>
|
|
|
|
|
|
|
|
|
|
<p><i>fiv</i> normally starts in a file browser view. On the left side of the
|
|
|
|
|
window, you'll find your GTK+ bookmarks, mounted locations as recognized by
|
2023-04-17 07:17:16 +02:00
|
|
|
|
GVfs, an item for entering arbitrary filesystem paths or URIs, and finally
|
|
|
|
|
breadcrumbs leading to the currently opened directory, as well as descendants
|
|
|
|
|
of it. At the top, there is a toolbar with view controls.
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
2023-04-17 07:17:16 +02:00
|
|
|
|
<p>You can open items in a new window either by middle clicking on them, or with
|
|
|
|
|
the left mouse button while holding the <kbd>Ctrl</kbd> key.
|
|
|
|
|
Right clicking the directory view offers a context menu for opening files,
|
|
|
|
|
or even the directory itself, in a different application.
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
|
|
|
|
<h2>Viewer</h2>
|
|
|
|
|
|
|
|
|
|
<p>The image viewer may be both entered (so long as you have a file selected)
|
2023-04-17 07:17:16 +02:00
|
|
|
|
and exited using the <kbd>Enter</kbd> key. This way you may easily switch
|
|
|
|
|
between the two modes. When using the mouse, the forwards and backwards buttons
|
|
|
|
|
will fulfill the same function.
|
2022-01-24 08:41:05 +01:00
|
|
|
|
|
|
|
|
|
<p>Double clicking the image switches full-screen view, and the mouse wheel
|
|
|
|
|
adjusts the zoom level.
|
|
|
|
|
|
|
|
|
|
<p>Files are iterated in the same order, and using the same filtering as in
|
|
|
|
|
the browser.
|
|
|
|
|
|
|
|
|
|
<h2>File formats</h2>
|
|
|
|
|
|
|
|
|
|
<p>The list of all supported file formats may be obtained by running:
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
fiv --list-supported-media-types
|
|
|
|
|
</pre>
|
|
|
|
|
|
2022-01-25 05:58:34 +01:00
|
|
|
|
<p>Unless it has been turned off in your installation, you may extend it through
|
2022-01-24 08:41:05 +01:00
|
|
|
|
gdk-pixbuf modules.
|
|
|
|
|
|
|
|
|
|
<h2>Thumbnails</h2>
|
|
|
|
|
|
2022-02-20 13:13:49 +01:00
|
|
|
|
<p><i>fiv</i> uses a custom means of storing thumbnails, and doesn't currently
|
|
|
|
|
invalidate this cache automatically. Should you find out that your
|
2022-01-24 08:41:05 +01:00
|
|
|
|
<i>~/.cache/thumbnails</i> directory is taking up too much space, run:
|
|
|
|
|
|
2022-02-20 13:13:49 +01:00
|
|
|
|
<pre>
|
|
|
|
|
fiv --invalidate-cache
|
|
|
|
|
</pre>
|
|
|
|
|
|
2022-07-31 05:47:39 +02:00
|
|
|
|
<p>to trim it down. Alternatively, if you want to get rid of <i>all</i>
|
|
|
|
|
thumbnails, even for existing images:
|
2022-02-20 13:13:49 +01:00
|
|
|
|
|
2022-01-24 08:41:05 +01:00
|
|
|
|
<pre>
|
|
|
|
|
rm -rf ~/.cache/thumbnails/wide-*
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h2>Configuration</h2>
|
|
|
|
|
|
2022-07-25 14:25:14 +02:00
|
|
|
|
<p>The few configuration options <i>fiv</i> has can be adjusted using
|
2022-08-05 09:57:39 +02:00
|
|
|
|
<i>dconf-editor</i>, which can be launched in the appropriate location from
|
2023-04-17 07:17:16 +02:00
|
|
|
|
within the application by pressing <kbd>Ctrl</kbd> + <kbd>,</kbd>.
|
|
|
|
|
For command line usage, there is the <i>gsettings</i> utility:
|
2022-07-31 05:47:39 +02:00
|
|
|
|
|
2022-07-25 14:25:14 +02:00
|
|
|
|
<pre>
|
|
|
|
|
gsettings list-recursively name.janouch.fiv
|
|
|
|
|
</pre>
|
|
|
|
|
|
2022-08-05 09:57:39 +02:00
|
|
|
|
<p>To make your changes take effect, restart <i>fiv</i>.
|
|
|
|
|
|
2022-07-25 14:25:14 +02:00
|
|
|
|
<h3>Theming</h3>
|
|
|
|
|
|
2022-01-24 08:41:05 +01:00
|
|
|
|
<p>The standard means to adjust the looks of the program is through GTK+ 3 CSS.
|
|
|
|
|
As an example, to tightly pack browser items, put the following in your
|
|
|
|
|
<i>~/.config/gtk-3.0/gtk.css</i>:
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
fiv-browser { -FivBrowser-spacing: 0; padding: 0; border: 0; margin: 0; }
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>Similarly, you can adjust some of the key bindings, as per the command table
|
|
|
|
|
in the <i>fiv-view.h</i> source file:
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
@binding-set ViewBindings { bind 'p' { 'command' (print) }; }
|
|
|
|
|
fiv-view { -gtk-key-bindings: ViewBindings; }
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>Should you want to experiment, you will find the GTK+ inspector very helpful.
|
|
|
|
|
|
|
|
|
|
<script>
|
|
|
|
|
var toc = '', all = document.querySelectorAll('h2')
|
|
|
|
|
for (var i = 0; i < all.length; i++) {
|
|
|
|
|
var name = all[i].innerHTML.replace(/[^0-9a-z]/ig, '-')
|
|
|
|
|
toc += '<li><p><a href="#' + name + '">' + all[i].innerHTML + '</a></li>'
|
|
|
|
|
all[i].id = name
|
|
|
|
|
all[i].innerHTML = (i + 1) + '. ' + all[i].innerHTML
|
|
|
|
|
}
|
|
|
|
|
all[0].insertAdjacentHTML('beforebegin',
|
|
|
|
|
'<h2>Table of Contents</h2><ol>' + toc + '</ol>')
|
|
|
|
|
</script>
|