aboutsummaryrefslogtreecommitdiff
path: root/docs/fiv.adoc
blob: 018808616b5dc3ef3e8a201e26c26327b8ad737e (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
fiv(1)
======
:doctype: manpage
:manmanual: fiv Manual
:mansource: fiv {release-version}

Name
----
fiv - Image browser and viewer

Synopsis
--------
*fiv* [_OPTION_]... [_PATH_ | _URI_]...

Description
-----------
*fiv* is a general-purpose image browser and viewer: pass it a directory path
or URI to open it for browsing, or pass an image to open it for viewing.
In case that multiple arguments are passed, they'll be opened as a virtual
directory containing all of them.

For more information concerning usage, press *F1* in the application to open
the _User Guide_.

// TODO(p): Try to merge the two, though this one focuses on command line usage.

Options
-------
*--browse*::
	When an image is passed, start in browsing mode, and preselect that
	image in its containing directory.  This is used by *fiv*'s inode/directory
	handler to implement the "Open Containing Folder" feature of certain
	applications.

*--collection*::
	Always put arguments in a virtual directory, even when only one is passed.
	Implies *--browse*.

*--help-all*::
	Show the full list of options, including those provided by GTK+.

*--invalidate-cache*::
	Invalidate the wide thumbnail cache, removing thumbnails for files that can
	no longer be found.

*--list-supported-media-types*::
	Output supported media types and exit.  This is used by a script to update
	the list of MIME types within *fiv*'s desktop file when the list
	of GdkPixbuf loaders changes.

*-V*, *--version*::
	Output version information and exit.

Internal options
~~~~~~~~~~~~~~~~
*--extract-thumbnail*::
	Present any embedded thumbnail of the first argument on the standard output
	in an application-specific bitmap format.  When both *--thumbnail*
	and *--extract-thumbnail* are passed, this option takes precedence,
	exiting early if successful.  This is used to enhance responsivity
	of thumbnail procurement.

*--thumbnail*=_SIZE_::
	Generate wide thumbnails for the first argument, in all sizes not exceeding
	_SIZE_, and present the largest of them on the standard output
	in an application-specific bitmap format.  Available sizes follow directory
	names in the _Thumbnail Managing Standard_.

*--thumbnail-for-search*=_SIZE_::
	Transform the first argument to a widely supported image file format,
	and present it on the standard output.  The image will be downscaled as
	necessary so as to not exceed _SIZE_ (see *--thumbnail*).

Reporting bugs
--------------
Use https://git.janouch.name/p/fiv to report bugs, request features,
or submit pull requests.

See also
--------
_Desktop Entry Specification_,
https://specifications.freedesktop.org/desktop-entry-spec/latest/[].

_Thumbnail Managing Standard_,
https://specifications.freedesktop.org/thumbnail-spec/thumbnail-spec-latest.html[].