You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 23, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+18-4Lines changed: 18 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ With vv you can display image files directly in your terminal. This works both l
13
13
The following types of image files can be viewed in vv:
14
14
15
15
- BC (Block Compression, also known as DXTC, S3TC), in DDS container,
16
-
- OpenEXR HDR images,
16
+
- OpenEXR,
17
17
- HEIF (High Efficiency Image File Format),
18
18
- AVIF (AV1 Image File Format),
19
19
- JPEG,
@@ -30,20 +30,30 @@ The following types of image files can be viewed in vv:
30
30
- PIC (Softimage),
31
31
- PPM and PGM (only binary),
32
32
- TIFF,
33
-
- WebP,
33
+
- WebP (with animations),
34
34
- PDF,
35
35
- SVG.
36
36
37
-
### Tone mapping
37
+
### High dynamic range
38
38
39
-
OpenEXRHDR images are properly tone mapped using the Khronos PBR Neutral operator.
39
+
Loading of HDR images is supported for OpenEXR, HEIF, AVIF, JPEG XL, and RGBE formats. HDR images are properly tone mapped using the Khronos PBR Neutral operator for display on the SDR terminal.
40
40
41
41
<divalign="center">
42
42
43
43

44
44
45
45
</div>
46
46
47
+
### Color management
48
+
49
+
Color profiles embedded in images are taken into account to ensure that images look exactly as they should.
50
+
51
+
<divalign="center">
52
+
53
+

54
+
55
+
</div>
56
+
47
57
### Transparency
48
58
49
59
Images with an alpha channel are rendered with transparency over the terminal background color. If this is not suitable, vv gives you the option to render the image with either a checkerboard background or a solid color backdrop of your choice.
@@ -81,3 +91,7 @@ In order to be able to view images with vv, you need to use a terminal that impl
81
91
Certain terminal features, such as Unicode fonts or true color support, are assumed to be always available.
82
92
83
93
On some terminals (e.g. Konsole), images may appear pixelated when using a high DPI monitor. This problem is caused by implementation details of the terminal itself, and cannot be fixed by vv. Try a different terminal if this bothers you.
94
+
95
+
### Animation
96
+
97
+
Animated images in WebP format can be played. The text-only fallback mode is driven by vv outputting images on its own. The Kitty graphics protocol allows much more sophisticated control of the animation, in which case the image will continue to play even after vv exits. Note that support for Kitty animations in terminal implementations is currently very limited.
0 commit comments