Krolyxon
Commit 54bfc5d

Branches

Refs →

nsxivetcnsxiv.1

591 lines · 12.2 KB · Groff/troff

Raw Blame History Download
1.TH NSXIV 1 nsxiv\-VERSION
2.SH NAME
3nsxiv \- Neo Simple X Image Viewer
4.SH SYNOPSIS
5.B nsxiv
6.RB [ \-abcfhiopqrtvZ0 ]
7.RB [ \-A
8.IR FRAMERATE ]
9.RB [ \-e
10.IR WID ]
11.RB [ \-G
12.IR GAMMA ]
13.RB [ \-g
14.IR GEOMETRY ]
15.RB [ \-N
16.IR NAME ]
17.RB [ \-n
18.IR NUM ]
19.RB [ \-S
20.IR DELAY ]
21.RB [ \-s
22.IR MODE ]
23.RB [ \-z
24.IR ZOOM ]
25.IR FILE ...
26.SH DESCRIPTION
27nsxiv is a simple image viewer for X.
28.P
29It has two modes of operation: image and thumbnail mode. The default is image
30mode, in which only the current image is shown. In thumbnail mode a grid of
31small previews is displayed, making it easy to choose an image to open.
32.P
33Please note, that the fullscreen mode requires an EWMH/NetWM-compliant window
34manager.
35.SH OPTIONS
36.TP
37.BI "\-A, \-\-framerate " FRAMERATE
38Play animations with a constant frame rate set to
39.IR FRAMERATE .
40.TP
41.B "\-a, \-\-animate"
42Play animations of multi-frame images.
43.TP
44.B "\-b, \-\-no\-bar"
45Do not show statusbar at the bottom of the window.
46.TP
47.B "\-c, \-\-clean\-cache"
48Remove all orphaned cache files from the thumbnail cache directory and exit.
49.TP
50.BI "\-e, \-\-embed " WID
51Embed nsxiv's window into window whose ID is
52.IR WID .
53.TP
54.B "\-f, \-\-fullscreen"
55Start in fullscreen mode.
56.TP
57.BI "\-G, \-\-gamma " GAMMA
58Set image gamma to GAMMA (\-32..32).
59.TP
60.BI "\-g, \-\-geometry " GEOMETRY
61Set window position and size. See section GEOMETRY SPECIFICATIONS of X(7) for
62more information on GEOMETRY argument.
63.TP
64.B "\-h, \-\-help"
65Print brief usage information to standard output and exit.
66.TP
67.B "\-i, \-\-stdin"
68Read names of files to open from standard input. Also done if FILE is `-'.
69.TP
70.BI "\-N, \-\-class " NAME
71Set the resource name (WM_CLASS) of nsxiv's X window to NAME.
72.TP
73.BI "\-n, \-\-start\-at " NUM
74Start at picture number NUM.
75.TP
76.B "\-o, \-\-stdout"
77Write list of all marked files to standard output when quitting. In combination
78with
79.B "\-i, \-\-stdin"
80nsxiv can be used as a visual filter/pipe.
81.TP
82.B "\-p, \-\-private"
83Enable private mode, in which nsxiv does not write any cache or temporary files.
84.TP
85.B "\-q, \-\-quiet"
86Be quiet, and disable warnings to standard error stream.
87.TP
88.B "\-r, \-\-recursive"
89Search the given directories recursively for images to view.
90.TP
91.BI "\-S, \-\-ss\-delay " DELAY
92Start in slideshow mode. Set the delay between images to
93.I DELAY
94seconds.
95.I DELAY
96may be a floating-point number.
97.TP
98.BI "\-s, \-\-scale\-mode " MODE
99Set scale mode according to MODE character. Supported modes are: [d]own,
100[f]it, [F]ill, [w]idth, [h]eight.
101.TP
102.B "\-t, \-\-thumbnail"
103Start in thumbnail mode.
104.TP
105.B "\-v, \-\-version"
106Print version information to standard output and exit.
107.TP
108.B "\-Z, \-\-zoom\-100"
109The same as `\-z 100'.
110.TP
111.BI "\-z, \-\-zoom " ZOOM
112Set zoom level to ZOOM percent.
113.TP
114.B "\-0, \-\-null"
115Use NULL-separator. With this option, output of \-o and file-list sent to the
116key-handler and the input of \-i will be separated by a NULL character.
117.TP
118.BI "\-\-anti\-alias" [=no]
119Enables anti-aliasing, when given
120.I no
121as an argument, disables it instead.
122.TP
123.BI "\-\-alpha\-layer" [=no]
124Enables checkerboard background for alpha layer, when given
125.I no
126as an argument, disables it instead.
127.SH KEYBOARD COMMANDS
128.SS General
129The following keyboard commands are available in both image and thumbnail modes:
130.TP
131.BR 0 \- 9
132Prefix the next command with a number (denoted via
133.IR count ).
134.TP
135.B q
136Quit nsxiv.
137.TP
138.B Return
139Switch to thumbnail mode / open selected image in image mode.
140.TP
141.B f
142Toggle fullscreen mode.
143.TP
144.B b
145Toggle visibility of statusbar at the bottom of the window.
146.TP
147.B Ctrl-x
148Send the next key to the external key-handler. See section EXTERNAL KEY HANDLER
149for more information.
150.TP
151.B g
152Go to the first image.
153.TP
154.B G
155Go to the last image, or image number
156.IR count .
157.TP
158.B r
159Reload image.
160.TP
161.B D
162Remove current image from file list and go to next image.
163.TP
164.BR Ctrl-h ", " Ctrl-Left
165Scroll left one screen width.
166.TP
167.BR Ctrl-j ", " Ctrl-Down
168Scroll down one screen height.
169.TP
170.BR Ctrl-k ", " Ctrl-Up
171Scroll up one screen height.
172.TP
173.BR Ctrl-l ", " Ctrl-Right
174Scroll right one screen width.
175.TP
176.BR +
177Zoom in.
178.TP
179.B \-
180Zoom out.
181.TP
182.B m
183Mark/unmark the current image.
184.TP
185.B M
186Mark/unmark all images starting from the last marked/unmarked image up to the
187current one.
188.TP
189.B Ctrl-m
190Reverse all image marks.
191.TP
192.B Ctrl-u
193Remove all image marks.
194.TP
195.B N
196Go
197.I count
198marked images forward.
199.TP
200.B P
201Go
202.I count
203marked images backward.
204.TP
205.B {
206Decrease gamma correction by
207.I count
208steps.
209.TP
210.B }
211Increase gamma correction by
212.I count
213steps.
214.TP
215.B Ctrl-g
216Reset gamma correction.
217.TP
218.B [
219Decrease brightness correction by
220.I count
221steps.
222.TP
223.B ]
224Increase brightness correction by
225.I count
226steps.
227.TP
228.B (
229Decrease contrast by
230.I count
231steps.
232.TP
233.B )
234Increase contrast by
235.I count
236steps.
237.SS Thumbnail mode
238The following keyboard commands are only available in thumbnail mode:
239.TP
240.BR h ", " Left
241Move selection left
242.I count
243times.
244.TP
245.BR j ", " Down
246Move selection down
247.I count
248times.
249.TP
250.BR k ", " Up
251Move selection up
252.I count
253times.
254.TP
255.BR l ", " Right
256Move selection right
257.I count
258times.
259.TP
260.B R
261Reload all thumbnails.
262.SS Image mode
263The following keyboard commands are only available in image mode:
264.TP
265Navigate image list:
266.TP
267.BR n ", " Space
268Go
269.I count
270images forward.
271.TP
272.BR p ", " Backspace
273Go
274.I count
275images backward.
276.TP
277.B [
278Go
279.I count
280* 10 images backward.
281.TP
282.B ]
283Go
284.I count
285* 10 images forward.
286.TP
287.B Ctrl-6
288Go to the previously viewed image.
289.TP
290Handle multi-frame images:
291.TP
292.B Ctrl-n
293Go
294.I count
295frames of a multi-frame image forward.
296.TP
297.B Ctrl-p
298Go
299.I count
300frames of a multi-frame image backward.
301.TP
302.BR Ctrl-a ", " Ctrl-Space
303Play/stop animations of multi-frame images.
304.TP
305Panning:
306.TP
307.BR h ", " Left
308Scroll image 1/5 of window width or
309.I count
310pixels left.
311.TP
312.BR j ", " Down
313Scroll image 1/5 of window height or
314.I count
315pixels down.
316.TP
317.BR k ", " Up
318Scroll image 1/5 of window height or
319.I count
320pixels up.
321.TP
322.BR l ", " Right
323Scroll image 1/5 of window width or
324.I count
325pixels right.
326.TP
327.B H
328Scroll to left image edge.
329.TP
330.B J
331Scroll to bottom image edge.
332.TP
333.B K
334Scroll to top image edge.
335.TP
336.B L
337Scroll to right image edge.
338.TP
339.B z
340Scroll to image center.
341.TP
342Zooming:
343.TP
344.B =
345Set zoom level to 100%, or
346.IR count %.
347.TP
348.B w
349Set zoom level to 100%, but fit large images into window.
350.TP
351.B W
352Fit image to window.
353.TP
354.B F
355Fill image to window.
356.TP
357.B e
358Fit image to window width.
359.TP
360.B E
361Fit image to window height.
362.TP
363Rotation:
364.TP
365.B <
366Rotate image counter-clockwise by 90 degrees.
367.TP
368.B >
369Rotate image clockwise by 90 degrees.
370.TP
371.B ?
372Rotate image by 180 degrees.
373.TP
374Flipping:
375.TP
376.B |
377Flip image horizontally.
378.TP
379.B _
380Flip image vertically.
381.TP
382Miscellaneous:
383.TP
384.B a
385Toggle anti-aliasing.
386.TP
387.B A
388Toggle visibility of alpha-channel, i.e. image transparency.
389.TP
390.B s
391Toggle slideshow mode and/or set the delay between images to
392.I count
393seconds.
394.SH MOUSE COMMANDS
395.SS Thumbnail mode
396The following mouse mappings are available in thumbnail mode:
397.TP
398.B Button1
399Select the image. Goes into image mode if double\-clicked.
400.TP
401.B Button3
402Mark/unmark the image. Dragging while holding down Button3 will mark/unmark
403multiple images.
404.TP
405.B Button4
406Scroll up by one row.
407.TP
408.B Button5
409Scroll down by one row.
410.TP
411.B Ctrl-Button4
412Scroll up by one page.
413.TP
414.B Ctrl-Button5
415Scroll down by one page.
416.SS Image mode
417The following mouse mappings are available in image mode:
418.TP
419.B Button1
420Go to the next image if the mouse cursor is in the right part of the window or
421to the previous image if it is in the left part.
422.TP
423.B Ctrl-Button1
424Pan the image relative to the mouse cursor.
425.TP
426.B Button2
427Pan the image according to the mouse cursor position in the window while
428keeping this button pressed down.
429.TP
430.B Button3
431Switch to thumbnail mode.
432.TP
433.B Button4
434Zoom in.
435.TP
436.B Button5
437Zoom out.
438.SH CONFIGURATION
439The following X resources are supported:
440.TP
441.B window.background
442Color of the window background
443.TP
444.B window.foreground
445Color of the window foreground
446.TP
447.B bar.font
448Name of Xft bar font
449.TP
450.B bar.background
451Color of the bar background. Defaults to window.background
452.TP
453.B bar.foreground
454Color of the bar foreground. Defaults to window.foreground
455.TP
456.B mark.foreground
457Color of the mark foreground. Defaults to window.foreground
458.TP
459Please see xrdb(1) on how to change them.
460.LP
461An X resources entry with an empty value means the default
462(defined in config.h) will be used.
463.SH WINDOW TITLE
464The window title can be replaced with the output of a user-provided script,
465which is called by nsxiv whenever any of the relevant information changes.
466The path of this script is
467.I $XDG_CONFIG_HOME/nsxiv/exec/win-title
468and the arguments given to it (where "Optional" arguments might be empty) are:
469.IP $1 4
470resolved absolute path of the current file
471.IP $2 4
472current file number
473.IP $3 4
474total file count
475.IP $4 4
476image width (Optional: Disabled on thumbnails mode)
477.IP $5 4
478image height (Optional: Disabled on thumbnails mode)
479.IP $6 4
480current zoom (Optional: Disabled on thumbnails mode)
481.P
482The term file is used rather than image as nsxiv does not precheck that the
483input files are valid images. Total file count may be different from the actual
484count of valid images.
485.P
486There is also an example script installed together with nsxiv as
487.IR EGPREFIX/win-title .
488.SH STATUS BAR
489The information displayed on the left side of the status bar can be replaced
490with the output of user-provided script.
491.P
492The script that is called by nsxiv whenever an image gets loaded is located at
493.I $XDG_CONFIG_HOME/nsxiv/exec/image-info
494and the arguments given to it are:
495.IP $1 4
496path to image file (as provided by the user)
497.IP $2 4
498image width
499.IP $3 4
500image height
501.IP $4 4
502fully resolved path to the image file
503.P
504In thumbnail mode, the script that is called is located at
505.I $XDG_CONFIG_HOME/nsxiv/exec/thumb-info
506and the arguments given to it are:
507.IP $1 4
508path to image file (as provided by the user)
509.IP $2 4
510empty
511.IP $3 4
512empty
513.IP $4 4
514fully resolved path to the image file
515.P
516There are also example scripts installed together with nsxiv as
517.IR EGPREFIX/image-info
518and
519.IR EGPREFIX/thumb-info .
520.SH EXTERNAL KEY HANDLER
521Additional external keyboard commands can be defined using a handler program
522located in
523.IR $XDG_CONFIG_HOME/nsxiv/exec/key-handler .
524The handler is invoked by pressing
525.BR Ctrl-x .
526The next key combo is passed as its first argument. Passed via stdin are the
527images to act upon: all marked images, if in thumbnail mode and at least one
528image has been marked, otherwise the current image. nsxiv(1) will block until
529the handler terminates. It then checks which images have been modified and
530reloads them.
531
532By default nsxiv(1) will send one image per-line to stdin, however when using
533\-0 the image list will be NULL separated and the environment variable
534"$NSXIV_USING_NULL" will be set to 1.
535
536The key combo argument has the following form: "[C-][M-][S-]KEY",
537where C/M/S indicate Ctrl/Meta(Alt)/Shift modifier states and KEY is the X
538keysym as listed in /usr/include/X11/keysymdef.h without the "XK_" prefix.
539If KEY has an uppercase equivalent, S-KEY is resolved into it. For instance,
540K replaces S-k and Scedilla replaces S-scedilla, but S-Delete is sent as-is.
541
542There is also an example script installed together with nsxiv as
543.IR EGPREFIX/key-handler .
544.SH THUMBNAIL CACHING
545nsxiv stores all thumbnails under
546.IR $XDG_CACHE_HOME/nsxiv/ .
547.P
548Use the command line option
549.I \-c
550to remove all orphaned cache files. Additionally, run the following command
551afterwards inside the cache directory to remove empty subdirectories:
552.P
553.RS
554find . \-depth \-type d \-empty ! \-name '.' \-exec rmdir {} \\;
555.RE
556.SH ORIGINAL AUTHOR
557.EX
558Bert Muennich <ber.t at posteo.de>
559.EE
560.SH CURRENT MAINTAINERS
561.EX
562NRK <nrk at disroot.org>
563Berke Kocaoğlu <berke.kocaoglu at metu.edu.tr>
564TAAPArthur <taaparthur at gmail.com>
565eylles <ed.ylles1997 at gmail.com>
566Stein Gunnar Bakkeby <bakkeby at gmail.com>
567explosion-mental <explosion0mental at gmail.com>
568mamg22 <marcomonizg at gmail.com>
569LuXu
570Guilherme Freire
571Sam Whitehead
572Kian Kasad <kian at kasad.com>
573.EE
574.SH CONTRIBUTORS
575.EX
576For a list of contributors, run `git shortlog -s` in the nsxiv git repository.
577.EE
578.SH HOMEPAGE
579.TP
580Website:
581.EE
582https://nsxiv.codeberg.page/
583.EX
584.TP
585Source code:
586.EE
587https://codeberg.org/nsxiv/nsxiv
588.EX
589.SH SEE ALSO
590.BR X (7),
591.BR xrdb (1)