Krolyxon
Commit 80ada33

Branches

Refs →

nsxivnsxiv.1

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