VIMIV(1)

🌸 VIMIV — an image viewer with vim-like keybindings

okay bestie, pull up a chair, because we're about to talk about vimiv (that's the VIMIV(1) manual, section 1, general commands, iykyk) and honestly? it's giving main character energy in the terminal.

✨ NAME ✨

vimiv — an image viewer with vim-like keybindings

💅 SYNOPSIS 💅

[--slideshow-delay SLIDESHOW-DELAY] [-g, --geometry GEOMETRY]
[--temp-basedir] [--config FILE] [--debug] [FILE] ...```

---

# 🦋 DESCRIPTION 🦋

Vimiv is an image viewer with vim-like keybindings. It is written in `python3` using the `Gtk3` toolkit. Some of the features are:

- Thumbnail mode
- Simple library browser
- Basic image editing
- Command line with tab completion

> the full documentation did NOT fit in this manpage, so it lives at
> ⟨http://karlch.github.io/vimiv/documentation/⟩ 💖

---

# 👑 OPTIONS 👑

- **`-b`, `--bar`** — display the statusbar
- **`-f`, `--fullscreen`** — start in fullscreen
- **`-h`, `--help`** — display a simple help text
- **`-l`, `--library`** — display the library
- **`-r`, `--recursive`** — search the directory recursively for images
- **`-s`, `--shuffle`** — shuffle the filelist
- **`-v`, `--version`** — show version information and exit
- **`--start-from-desktop`** — start using the `desktop_start_dir` as path
- **`--slideshow`** — start in slideshow mode
- **`--slideshow-delay SLIDESHOW_DELAY`** — set the slideshow delay
- **`-g`, `--geometry GEOMETRY`** — set the starting geometry
- **`--temp-basedir`** — use a temporary basedir
- **`--config FILE`** — use *FILE* as local configuration file instead of `$XDG_CONFIG_HOME/vimiv/vimivrc` and `~/.vimiv/vimivrc`.
- **`--debug`** — run in debug mode

not me being obsessed with the negate trick: <rainbow>ALL CAPITALS NEGATE THE SETTING</rainbow>, so like, `-B` means do **not** display the statusbar. and for the long version you just prepend `no-`, so `--no-bar`. periodt. 💅✨

---

# 💀 BUGS 💀

Probably. 😭 Please contact me under `<karlch at protonmail dot com>` or, even better, open an issue on the github homepage.

---

# 🎀 SEE ALSO 🎀

`vimivrc(5)`

---

# 🫶 THANKS TO 🫶

- James Campos, author of Pim ⟨https://github.com/Narrat/Pim⟩ upon which vimiv is built.
- Bert Muennich, author of sxiv ⟨https://github.com/muennich/sxiv⟩ which inspired many of the features of vimiv.
- Anyone who has contributed or reported bugs.

---

# 🌈 RESOURCES 🌈

- Website ⟨https://karlch.github.io/vimiv/⟩
- Github ⟨https://github.com/karlch/vimiv/⟩

---

and that's the whole page, bestie 🧚 this was the <hotpink>vimiv</hotpink> manual, `Linux`, <lavender>May 2017</lavender>, version `vimiv` — go be the main character of your own file browser, ily, bye 💖✨🌸