1ncplayer(1) ncplayer(1)
2
6 ncplayer - Render images and video to a terminal
7
9 ncplayer [-h] [-V] [-q] [-d delaymult] [-l loglevel] [-b blitter] [-s
10 scalemode] [-k] [-L] [-t seconds] [-n] [-a color] files
11
13 ncplayer uses a multimedia-enabled Notcurses to render images and
14 videos to a terminal. By default, stretch-type scaling is used to fill
15 the rendering area, and the highest-quality blitter available is em‐
16 ployed.
17
19 -d delaymult: Apply a non-negative rational multiplier to the de‐
20 layscale. Only applies to multiframe media such as video and animated
21 images. Not supported with -k.
22 -t seconds: Delay seconds after each file. If this option is used, the
24 "press any key to continue" prompt will not be displayed. seconds may
25 be any non-negative number.
26 -l loglevel: Log between everything (loglevel 7) and nothing (loglevel
28 0) to stderr.
29 -s scalemode: Scaling mode, one of none, hires, scale, scalehi, or
31 stretch.
32 -b blitter: Blitter, one of ascii, half, quad, sex, braille, or pixel.
34 -m margins: Define rendering margins (see below).
36 -L: Loop frames until a key is pressed. Not supported with -k.
38 -k: Use direct mode (see notcurses_direct(3)). This will have the ef‐
40 fect of leaving the output on-screen after program exit, and generating
41 it inline (rather than clearing the screen and placing it at the top).
42 Not supported with -L or -d.
43 -q: Print neither frame/timing information along the top of the screen,
45 nor the output summary on exit.
46 -a: Treat color as if it were transparent.
48 -n: Use non-interpolative scaling. The result is usually less pleasing
50 to the eye, but it doesn't introduce new colors.
51 -V: Print the program name and version, and exit with success.
53 -h: Print help information, and exit with success.
55 files: Select which files to render, and what order to render them in.
57 Default margins are all 0 and default scaling is stretch. The full
59 rendering area will thus be used. Using -m, margins can be supplied.
60 Provide a single number to set all four margins to the same value, or
61 four comma-delimited values for the top, right, bottom, and left mar‐
62 gins respectively. Top, right, and bottom margins are ignored when -k
63 is used. Negative margins are illegal.
64 Scaling mode stretch resizes the object to match the target rendering
66 area exactly. Unless a blitter is specified with -b, stretch will use
67 the highest-resolution blitter available. scale resizes the object so
68 that the longer edge of the rendering area is matched exactly, and the
69 other edge is changed to maintain aspect ratio. none uses the original
70 image size. Both scale and none aim for a 1:1 aspect ratio, and will
71 thus prefer half to quad, sex, or braille. scalehi and hires use the
72 highest-resolution blitter available.
73 Blitters can be selected at runtime by pressing '0' through '6'.
75 NCBLIT_DEFAULT corresponds to '0'. The various blitters are described
76 in notcurses_visual(3). If a blitter cannot be used in the current en‐
77 vironment, the current blitter will be retained.
78 Multiframe media can be paused with space. Press space (or any other
80 valid control) to resume.
81
83 If you're looking for a fast, inline image viewer for the shell, try
84 using ncplayer -k -t0 -q.
85 Optimal display requires a terminal advertising the rgb [22mterminfo(5) ca‐
87 pability, or that the environment variable COLORTERM is defined to
88 24bit (and that the terminal honors this variable), along with a fixed-
89 width font with good coverage of the Unicode Block Drawing Characters.
90
92 Direct mode is kinda fundamentally suboptimal for multiframe media, and
93 is not yet supported with -L nor -d. Top, right, and bottom margins
94 are ignored without warning when using direct mode.
95
97 notcurses(3), notcurses_direct(3), notcurses_visual(3), terminfo(5),
98 unicode(7)
99
101 nick black <nickblack@linux.com>.
102 v3.0.8 ncplayer(1)