.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "UEBERZUG" "1" "March 2022" "18.2.2" "User Commands"
.hy
.SH NAME
.PP
\f[B]ueberzug\f[R] - command line utility which draws images on
terminals
.SH SYNOPSIS
.PP
\f[B]ueberzug\f[R] \f[B]layer\f[R] [\f[I]OPTIONS\f[R]]
.PP
\f[B]ueberzug\f[R] \f[B]library\f[R]
.PP
\f[B]ueberzug\f[R] \f[B]version\f[R]
.SH DESCRIPTION
.PP
\f[B]ueberzug\f[R] is a command line utility which can draw images on
terminals by using child windows.
It possesses many advantages over w3mimgdisplay, including: the use of
chars as the size unit for position/size, tmux support, processing of
expose events, and support for terminals that do not support WINDOWID.
.PP
\f[B]ueberzug\f[R] takes the following arguments:
.IP
.nf
\f[C]
layer [OPTIONS]
    Display image

library
    Print the path to the bash library

version
    Print version information and exit
\f[R]
.fi
.SH OPTIONS
.PP
The \f[I]layer\f[R] argument supports the following options:
.PP
-p, --parser [ \f[I]json\f[R] | \f[I]simple\f[R] | \f[I]bash\f[R] ]
.IP
.nf
\f[C]
json: JSON object per line (default)

simple: Key-values separated by a tab character

bash: associative array dumped via \[ga]declare -p\[ga]
\f[R]
.fi
.PP
-l, --loader [ \f[I]thread\f[R] | \f[I]process\f[R] |
\f[I]synchronous\f[R] ]
.IP
.nf
\f[C]
thread: load image in thread (default)

process: load image in additional process

synchronous: load image right away
\f[R]
.fi
.PP
-s, --silent
.IP
.nf
\f[C]
Print STDERR to /dev/null
\f[R]
.fi
.SH COPYRIGHT
.PP
Copyright (c) 2018-2019 Nico Bäurer <https://github.com/seebye>
.SH LICENSE
.PP
Ueberzug is licensed under the GNU General Public License v3.0
.SH AUTHOR
.PP
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
.SH SEE ALSO
.PP
\f[B]w3mimgdisplay\f[R](1)
.PP
Example scripts using ueberzug in /usr/share/doc/ueberzug/examples