gliv(1)

💖 gliv — the OpenGL Image Viewer 💖

okay bestie, gather round, because gliv is literally the moment. it's a manual page from section 1 (general commands), and it's giving image viewer energy. ✨

---

🌸 SYNOPSIS 🌸

gliv [OPTIONS]... [FILES]...

---

🦋 DESCRIPTION 🦋

so here's the tea: gliv uses gdk-pixbuf to load your images and OpenGL to render them. that's the whole vibe. and it lets you do some moving, rotating, zooming and slide show. iconic behavior, no notes. 💅

---

✨ OPTIONS ✨

first things first, the order of operations, and this part matters so don't skip it:

the options get set to their default values first — "off" for flags — and then they're read either from ~/.glivrc or /etc/glivrc or a configuration file specified on the command line, and finally they're read from the command line. last one wins, basically. 🫶

also! omitting the argument for an option that takes an "on|off" argument (flags) is like giving it "on". so --foo is the same as --foo=on if foo is an on|off flag. you don't have to spell it out. lowkey convenient.

• -h, --help — print help and exit. the classic. 👑
• -V, --version — print version and exit.
• -a, --add-all[=on|off] — add all files in the directory. with this option, when you open a file on the command line or with the open dialog, all others files in the directory are added as well. yes, all of them. 🍓
• -R, --recursive[=on|off] — recursive directory traversal. if gliv tries to load a direcory, it will also load every image all its subdirectories. it goes deep. 🌈
• -S, --sort[=on|off] — show images in sorted order. the images list will be sorted before the slide show.
• -s, --shuffle[=on|off] — show images in random order. the images list will be shuffled before the slide show. chaos mode, but make it cute. 🔥
• -F, --force-load[=on|off] — try to load every file. when loading a file, the loader is chosen according to the filename extension in order to optimize the loading time. if the extension is unknown, the file is ignored — with this option gliv will always try to load the file. no file left behind. 💖
• -C, --client[=on|off] — connect to a running gliv, appending to the list. with this option, gliv will open the files passed in the arguments in the gliv server window. it can also be used with the -0 option. the gliv server is the latest launched gliv or the one which has been chosen using the Options menu. bestie-to-bestie communication fr fr.
• -c, --client-clear[=on|off] — connect to a running gliv, replacing the list. this is like the --client option except that the specified list on the client will replace the list on the server instead of being appended to. out with the old. 💀
• -e, --build-menus[=on|off] — no images menu at startup. disabling the images menus creation at startup makes it faster, especially with many files on the command line. speed. ⭐
• -g, --glivrc[=FILE] — use this configuration file or none. specify it to disable loading of the rc file. with a filename as argument it will use it as a configuration file.
• -w, --slide-show[=on|off] — start the slide show immediately. this way you will not have to start it manually from the menu. main character energy from the jump. 🎀
• -0, --null[=on|off] — read null-terminated filenames. this can be used with "find -print0" or with "tr '\n' '\0'" when you have a very long list of filenames to pass to gliv. unlike xargs(1) it allows an unlimited number of filenames. unlimited!! 🦋
• -o, --collection[=FILE] — output a collection. with this option, gliv creates a collection from the loaded files and outputs it to stdout or in the specified file.
• -G, --geometry=GEOMETRY — initial window geometry. this option can be used to specify the position and dimension of the gliv window. it expects a geometry argument in the XParseGeometry(3X11) format like: 640x480+20-30 for example.

---

🎀 COLLECTIONS 🎀

starting with version 1.8, gliv supports a file format called "GLiv collection". it contains an images list and the associated thumbnails — this way, when you load a collection the images menus rebuilding is faster since it does not have to make thumbnails. the glow-up is real. ✨

gliv supports also transparent decompression, so the collections can be compressed in bzip2, gzip or compress(1) provided that you have the corresponding decompressor. yes you need the decompressor, that's not optional, that's just how it is. 💜

---

👑 CONTROLS 👑

okay this is the good part. the keyboard lore. memorise it, it's giving cheat sheet:

• ESC, q — Quit
• f — Full-screen/window
• +/=/- — Zoom in/in/out
• n/p — Next/previous image
• Pause — Start/stop the slide show
• l — Reduce the image to the window
• M — Maximize the image to the window
• m — Make the image fit the window
• r — Reset position and size
• b — Toggle display of the menu bar
• i — Toggle display of the info bar
• s — Toggle display of the scrollbars
• a — Toggle display of the alpha checks
• h — Toggle display of the help box
• w — Toggle display of floating windows
• o — Display the open dialog
• g — Display the image selector
• t — Display the options dialog
• d — Hide the cursor
• u — Undo
• y — Redo
• c — Clear the history
• Delete — Delete the current file
• C-up — Rotate by +90 degrees
• C-down — Rotate by -90 degrees
• C-left — Rotate by +0.1 degree
• C-right — Rotate by -0.1 degree
• z — Horizontal flip
• e — Vertical flip

---

and now the mouse, because the mouse is also doing a lot:

the first mouse button and the arrow keys will move the image unless the Control key is pressed. in which case the image will be rotated around the window center. 🌸

the mouse wheel zooms the image, and when you hold its button pressed at the same time it switches to the neighbouring image. multitasking queen. 💅

you can also zoom by dragging the mouse vertically while holding Shift and the first button.

Space and Backspace act like n and p.

draw a rectangle with the third button and gliv will zoom in it. so satisfying, iykyk. 🫶

---

💜 FILE 💜

• ~/.glivrc — This file is absolutely not mandatory. like, genuinely optional. it's just there if you want it. 🙈

---

⭐ AUTHOR ⭐

Guillaume Chazarain <guichaz@gmail.com>

See http://guichaz.free.fr/gliv

---

and that's the whole page, bestie 💖 version 1.9, brought to you by Guillaume Chazarain, and this manual page is for gliv in section 1 of the manual — go forth and view some images, you ate. ✨🎀🦋