aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: a8388eff4ffa04f16ef2ae16f9827dc4546d34fd (plain)
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
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 -i

### Autoscale images to fit the window
    imv -s *.gif

### Open an image fullscreen (and scale to fit screen)
    imv -fs image.jpeg

### Viewing images in a random order
    find . "*.png" | shuf | imv -i

### 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.

#### 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 -p | xargs cp -t ~/outbox

Installation
------------

    $ make
    # make install

License
-------
`imv` is published under the [GPLv2](LICENSE) license.