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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
[](https://travis-ci.org/eXeC64/imv)
imv - X11/Wayland Image Viewer
==============================
`imv` is a command line image viewer intended for use with tiling window managers.
Features
--------
* Wayland Support
* Support for over 30 different image file formats including:
* Photoshop PSD files
* Animated GIFS
* Various RAW formats
Usage
-----
### Opening images
imv image1.png another_image.jpeg yet_another.TIFF
### Opening images via stdin
find . "*.png" | imv
### Open an image fullscreen
imv -f image.jpeg
### Viewing images in a random order
find . "*.png" | shuf | imv
### Viewing images from stdin
curl http://somesi.te/img.png | imv -
### Image picker
imv can be used to select images in a pipeline by using the `p` hotkey to print
the current image's path to stdout. The `-l` flag can also be used to tell imv
to list the remaining paths on exit for a "open set of images, close unwanted
ones with `x`, then quit imv to pass the remaining images through" workflow.
#### Picking a wallpaper
custom-set-wallpaper-script "$(find ./wallpaper -type f -name '*.jpg' | imv | tail -n1)"
#### Deleting unwanted images
find -type f -name '*.jpg' | imv | xargs rm -v
#### Choosing pictures to email
find ./holiday_pics -type f -name '*.jpg' | imv | xargs cp -t ~/outbox
#### Viewing images from the web
curl -Osw '%{filename_effective}\n' 'http://www.example.com/[1-10].jpg' | imv
### Slideshow
imv can be used to display slideshows. You can set the number of seconds to
show each image for with the `-t` option at start up, or you can configure it
at runtime using the `t` and `T` hotkeys to increase and decrease the image
display time, respectively.
To cycle through a folder of pictures, showing each one for 10 seconds:
imv -t 10 ~/Pictures/London
The `-x` switch can be used to exit imv after the last picture instead of
cycling through the list.
Installation
------------
`imv` depends on `pthreads`, `FontConfig`, `SDL2`, `SDL_TTF`, and `FreeImage`.
$ make
# make install
Macro `PREFIX` controls installation prefix. If more control over installation
paths is required, macros `BINPREFIX`, `MANPREFIX` and `DATAPREFIX` are
available. Eg. to install `imv` to home directory, run:
$ BINPREFIX=~/bin PREFIX=~/.local make install
In case something goes wrong during installation process you may use verbose
mode to inspect commands issued by make:
$ V=1 make
Tests
-----
`imv` has a work-in-progress test suite. The test suite requires `cmocka`.
$ make check
Contact
-------
There's an official irc channel for imv discussion and development on
Freenode: `#imv`.
License
-------
`imv` is published under the [GPLv2](LICENSE) license.
|
