mons
POSIX-compliant shell script for managing multi-monitor displays on X
TLDR
Enable only the primary monitor
SYNOPSIS
mons [-o] [-s] [-d] [-m] [-e side] [-O id] [-S id1,id2:pos] [--dpi value]
DESCRIPTION
mons is a POSIX-compliant shell script for managing multi-monitor displays on X Window System. It simplifies switching between display configurations without extensive dependencies.
The tool wraps xrandr to provide intuitive commands for common dual-monitor setups: primary only, secondary only, duplicate, mirror, and extend modes. It supports daemon mode for automatic display management when monitors are connected or disconnected.
PARAMETERS
-o
Enable primary monitor only-s
Enable secondary monitor only-d
Duplicate primary monitor output onto secondary-m
Mirror primary display onto secondary-e _side_
Extend primary monitor; side: top, left, right, bottom-n _side_
Cycle through display modes sequentially-O _id_
Enable specific monitor by identifier-S _id1,id2:pos_
Enable two specific monitors; pos: R (right), T (top)-a
Daemon mode; auto-enable display on monitor changes-x _script_
Execute custom script on monitor count changes--dpi _value_
Set display DPI (0-27432 range)--primary _name_
Designate primary output monitor-h
Display help-v
Show version
CAVEATS
Requires X Window System and xrandr. Does not work with Wayland compositors. Limited to configurations that xrandr supports. The secondary monitor is determined by connection order; use -O or -S for explicit control with multiple monitors.
HISTORY
mons was developed by Thomas� Venturini (Ventto) as a lightweight alternative to graphical display configuration tools. It provides a minimal, scriptable interface for common multi-monitor operations.
