UEBERZUG(1)

📦
version 18.3.2 · 6 versions
, in ubuntu stonking

👑 UEBERZUG — the manual page, but make it make sense 💅

okay bestie, so this is the man page for ueberzug (section 1 of the User Commands manual, in case anyone asks) — the little command line utility that draws images on your terminal. yes, actual images. in your terminal. we love to see it. 🌸

✨ NAME ✨

ueberzug — a command line utility which draws images on terminals 🖼️✨

🌈 SYNOPSIS 🌈

ueberzug layer [OPTIONS]

ueberzug library

ueberzug version

💖 DESCRIPTION 💖

so ueberzug is a command line utility that can draw images on terminals using child windows. iconic behaviour honestly.

it has a bunch of glow-ups over w3mimgdisplay, like, genuinely:

  • it uses chars as the size unit for position/size
  • tmux support 🫶
  • it processes expose events
  • and it supports terminals that don't even have WINDOWID, which is giving main character energy for real

ueberzug takes the following arguments, bestie — here's the rundown:

  • layer [OPTIONS] — Display image 🖼️
  • library — Print the path to the bash library 📚
  • version — Print version information and exit 👋

🎀 OPTIONS 🎀

the layer argument supports the following options — no cap, this is the whole list:

  • -p, --parser [ json | simple | bash ] — pick how you're feeding it data:
    • json: JSON object per line (the default) ✅
    • simple: Key-values separated by a tab character
    • bash: associative array dumped via declare -p
  • -l, --loader [ thread | process | synchronous ] — how the image actually gets loaded:
    • thread: load image in thread (the default) 🧵
    • process: load image in additional process
    • synchronous: load image right away, no waiting around
  • -s, --silent — Print STDERR to /dev/null 🤫
heads up bestie: -p and -l both want a value from that little bracket list, so don't just yell them into the void, okay? 🫶

Copyright (c) 2018-2023 Ueberzug Developers 👑

💜 LICENSE 💜

Ueberzug is licensed under the GNU General Public License v3.0 — free software, as it should be. periodt. 💅

🦋 AUTHOR 🦋

This manual page is based on the ueberzug help documentation. It was created by Nick Morrott nickm@debian.org for the Debian GNU/Linux system, but may be used by others 🫶

⭐ SEE ALSO ⭐

  • w3mimgdisplay(1) 👀
  • Example scripts using ueberzug in /usr/share/doc/ueberzug/examples — go look, they're lowkey so useful 🍓

and that's the whole vibe check, bestie. this page is version 18.3.2, dated November 2024 🎀✨ stay slaying, and remember: images. on. your. terminal. iconic fr fr 💖

📦 where this page comes from