aboutsummaryrefslogtreecommitdiff
path: root/docs/fiv.html
blob: 72b1963b1d7b04571197dc08937cc154067f4454 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<!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>
<span id="revdate">2023-04-17</span>

<p class="figure"><img src="fiv.webp" alt="fiv in browser and viewer modes">

<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.

<p>Controls should generally be accessible through the keyboard. Pressing
<kbd>Ctrl</kbd>&#8239;+&#8239;<kbd>?</kbd> will give you a convenient overview
of all shortcuts. In addition to these, remember that you may often use
<kbd>Ctrl</kbd>&#8239;+&#8239;<kbd>Tab</kbd> and <kbd>F6</kbd> to navigate to
different groups of widgets.

<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
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.

<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.

<h2>Viewer</h2>

<p>The image viewer may be both entered (so long as you have a file selected)
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.

<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>

<p>Unless it has been turned off in your installation, you may extend it through
gdk-pixbuf modules.

<h2>Thumbnails</h2>

<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
<i>~/.cache/thumbnails</i> directory is taking up too much space, run:

<pre>
fiv --invalidate-cache
</pre>

<p>to trim it down. Alternatively, if you want to get rid of <i>all</i>
thumbnails, even for existing images:

<pre>
rm -rf ~/.cache/thumbnails/wide-*
</pre>

<h2>Configuration</h2>

<p>The few configuration options <i>fiv</i> has can be adjusted using
<i>dconf-editor</i>, which can be launched in the appropriate location from
within the application by pressing <kbd>Ctrl</kbd>&#8239;+&#8239;<kbd>,</kbd>.
For command line usage, there is the <i>gsettings</i> utility:

<pre>
gsettings list-recursively name.janouch.fiv
</pre>

<p>To make your changes take effect, restart <i>fiv</i>.

<h3>Theming</h3>

<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>