1IMV(1) IMV(1)
2
3
4
6 imv - Image viewer for X11 and Wayland
7
9 imv is an image viewer for X11 and Wayland, aimed at users of tiling
10 window managers. It supports a wide variety of image file formats,
11 including animated gif files. imv will automatically reload the current
12 image, if it is changed on disk.
13
15 imv [options] [paths...]
16
18 -h
19 Show help message and quit.
20
21 -v
22 Show version and quit.
23
24 -b <background>
25 Set the background colour. Can either be a 6-digit hexadecimal
26 colour code or checks to show a chequered background.
27
28 -c <command>
29 Specify a command to be run on launch, after the configuration has
30 been loaded. Can be used to configure custom keys with the bind
31 command. This option can be used multiple times. Commands are run
32 in the order that they have been passed to imv.
33
34 -d
35 Start with overlay visible.
36
37 -f
38 Start fullscreen.
39
40 -l
41 List open files to stdout at exit.
42
43 -n <path|index>
44 Start with the given path, or index selected.
45
46 -r
47 Load directories recursively.
48
49 -s <none|shrink|full|crop>
50 Set scaling mode to use. none will show each image at its actual
51 size. shrink will scale down the image to fit inside the window.
52 full will both scale up and scale down the image to fit perfectly
53 inside the window. crop will scale and crop the image to fill the
54 window. Defaults to full.
55
56 -t <slideshow_duration>
57 Start in slideshow mode, with each image shown for the given number
58 of seconds.
59
60 -u <linear|nearest_neighbour>
61 Set upscaling method used by imv.
62
63 -x
64 Disable looping of input paths.
65
67 Commands can be entered by pressing :. imv supports the following
68 commands:
69
70 quit
71 Quit imv. Aliased to q.
72
73 pan <x> <y>
74 Pan the view by the given amounts.
75
76 next <offset>
77 Move forwards by a given number of images. Aliased to n
78
79 prev <offset>
80 Move backwards by a given number of images. Aliased to p
81
82 goto <index>
83 Select an image by index. 1 is the first image, 2 the second, etc.
84 The last image can be indexed as -1, the second last as -2. Aliased
85 to g.
86
87 zoom <amount|actual>
88 Zoom into the image by the given amount. Negative values zoom out.
89 actual resets the zoom to 100%, showing the image at its actual
90 size. Aliased to z.
91
92 rotate <'to'|by> <angle>
93 Rotate image clockwise by/to the given amount in degrees.
94
95 flip <'horizontal'|vertical>
96 Flip image horizontally/vertically (across vertical/horizontal
97 axis).
98
99 open [-r] <paths ...>
100 Add the given paths to the list of open images. If the -r option is
101 specified, do so recursively. Shell expansions may be used. Aliased
102 to o.
103
104 close [index|all]
105 Close the currently selected image, or the image at the given
106 index, or all images.
107
108 fullscreen
109 Toggle fullscreen.
110
111 overlay
112 Toggle the overlay.
113
114 exec <command>
115 Execute a shell command. imv provides various environment variables
116 to the command executed. These are documented in the Environment
117 Variables section.
118
119 center
120 Recenter the selected image.
121
122 reset
123 Reset the view, centering the image and using the current scaling
124 mode to rescale it.
125
126 next_frame
127 If an animated gif is currently being displayed, load the next
128 frame.
129
130 toggle_playing
131 Toggle playback of the current image if it is an animated gif.
132
133 scaling <none|shrink|full|crop|next>
134 Set the current scaling mode. Setting the mode to next advances it
135 to the next mode in the list.
136
137 upscaling <linear|nearest_neighbour|next>
138 Set the current upscaling method. Setting the method to next
139 advances it to the next method in the list.
140
141 slideshow <+amount|-amount|duration>
142 Increase or decrease the slideshow duration by the given amount in
143 seconds, or set its duration directly. Aliased to ss.
144
145 background <checks|hexadecimal-code>
146 Set the background color. checks for a chequerboard pattern, or
147 specify a 6-digit hexadecimal color code. Aliased to bg.
148
149 bind <keys> <commands>
150 Binds an action to a set of key inputs. Uses the same syntax as the
151 config file, but without an equals sign between the keys and the
152 commands. For more information on syntax, see imv(5).
153
155 imv comes with several binds configured by default
156
157 q
158 Quit
159
160 Left arrow,
161 Previous image
162
163 Right arrow
164 Next Image
165
166 gg
167 Go to first image
168
169 G
170 Go to last image
171
172 j
173 Pan down
174
175 k
176 Pan up
177
178 h
179 Pan left
180
181 l
182 Pan right
183
184 x
185 Close current image
186
187 f
188 Toggle fullscreen
189
190 d
191 Toggle overlay
192
193 p
194 Print current image to stdout
195
196 Up arrow
197 Zoom in
198
199 Down arrow
200 Zoom out
201
202 i
203 Zoom in
204
205 o
206 Zoom out
207
208 +
209 Zoom in
210
211 -
212 Zoom out
213
214 Ctrl+r
215 Rotate clockwise by 90 degrees
216
217 c
218 Center image
219
220 s
221 Next scaling mode
222
223 S
224 Next upscaling mode
225
226 a
227 Zoom to actual size
228
229 r
230 Reset zoom and pan
231
232 .
233 Next frame (for animations)
234
235 Space
236 Pause/play animations
237
238 t
239 Start slideshow/increase delay by 1 second
240
241 T
242 Stop slideshow/decrease delay by 1 second
243
245 The path to a config file can be given via the $imv_config environment
246 variable. If not found, imv will search for it in the following
247 locations:
248
249 • $XDG_CONFIG_HOME/imv/config (recommended)
250
251 • $HOME/.config/imv/config
252
253 • $HOME/.imv_config
254
255 • $HOME/.imv/config
256
257 • /usr/local/etc/imv_config
258
259 • /etc/imv_config
260
261 A default config file is shipped with imv into /etc/imv_config
262
263 For documentation on the config file format, see imv(5).
264
266 When imv executes a shell command, it provides a number of environment
267 variables, exposing imv’s state. These environment variables are also
268 available when customising the window’s title, or the overlay text.
269
270 $imv_pid
271 The pid of this instance of imv. Useful for running imv-msg in
272 scripts.
273
274 $imv_current_file
275 Path of currently selected image.
276
277 $imv_scaling_mode
278 Name of the current scaling mode.
279
280 $imv_loading
281 1 if a new image is loading, 0 otherwise.
282
283 $imv_current_index
284 Index of current image, from 1-N.
285
286 $imv_file_count
287 Total number of files.
288
289 $imv_width
290 Width of the current image.
291
292 $imv_height
293 Height of the current image.
294
295 $imv_scale
296 Scaling of current image in percent.
297
298 $imv_slideshow_duration
299 Number of seconds each image is shown for.
300
301 $imv_slideshow_elapsed
302 How long the current image has been shown for.
303
305 imv can accept commands from another process over a unix socket. Each
306 instance of imv will open a unix socket named
307 $XDG_RUNTIME_DIR/imv-$PID.sock. If $XDG_RUNTIME_DIR is undefined, the
308 socket is placed into /tmp/ instead.
309
310 The imv-msg(1) utility is provided to simpliy this from shell scripts.
311
313 imv is written and maintained by Harry Jeffery <me@harry.pm> with
314 contributions from other developers.
315
316 Full source code and other information can be found at
317 https://github.com/eXeC64/imv.
318
320 imv(5) imv-msg(1)
321
322
323
324 01/26/2021 IMV(1)