tiv

1# tiv — minimal GUI image viewer (Linux)
2 
3`tiv` is a small, Linux-focused, GUI image viewer. It opens an image in a window and lets you move **next/previous** with buttons or the keyboard while showing the **current file name**.
4 
5## Features
6 
7- GTK-based GUI viewer (uses system image loaders)
8- `←/→` or `p/n` for previous/next
9- Shows current image name and controls
10- If opened with a file path, it loads all images in that folder and starts at that file
11 
12## Build
13 
14```sh
15make
16```
17 
18## Run
19 
20```sh
21./tiv path/to/image.png
22```
23 
24Controls:
25- Next: `→` or `n`
26- Previous: `←` or `p`
27- Zoom in/out: `+` / `-` (reset `0`)
28- Crop: `c` then drag a rectangle, press `Enter` (saves `*_crop.png`)
29- Quit: `q` or `Esc`
30 
31## Install (system-wide)
32 
33```sh
34sudo make install
35```
36 
37This installs:
38- Binary: `/usr/local/bin/tiv`
39- Desktop entry: `/usr/local/share/applications/tiv.desktop`
40 
41## File manager integration
42 
43Set `tiv` as the default application for image types in your desktop environment, or run:
44 
45```sh
46xdg-mime default tiv.desktop image/png
47xdg-mime default tiv.desktop image/jpeg
48xdg-mime default tiv.desktop image/webp
49```
50 
51Desktop entry: `packaging/tiv.desktop`.
52 
53## Arch package (local)
54 
55```sh
56make dist
57cp dist/tiv-$(cat VERSION).tar.gz packaging/arch/tiv-$(cat VERSION).tar.gz
58cd packaging/arch
59makepkg -si
60```
61 
62## AppImage (local)
63 
64This AppImage is minimal and **does not bundle GTK4** (your system still needs `gtk4`).
65 
66```sh
67./packaging/appimage/build-appimage.sh
68```
69 
70Output:
71- `dist/tiv-<version>-<arch>.AppImage`
72