Command Line

Documentation / CyMonitor

• Overview of Display Preferences
  • What It Does
  • What It Is Not
• Using Display Preferences
  • DPI And Readability
  • Dry Run Before You Commit
  • Identify Heads
  • First-Run Dense Framebuffers
• Command Line
  • Probe And Identify
  • Apply And Dry Run
  • First-Run Scale
• Copyright

Command Line

cymonitor-prefs is the Motif Display Preferences panel. The same binary also runs headless for session start and scripts.

cymonitor-prefs [options]

Standard: -h/--help, -V/--version, --selftest, --caps, --log SPEC, -v/--verbose, -q/--quiet.

Unrecognized options are handed to the X Toolkit (-display, -geometry, -xrm, ...). Anything left after that is reported as a typo.

Only one cymonitor-prefs runs per screen; a second launch replaces the first.

Probe And Identify

• --probe -- run the monitor probe, print what it found, exit
• --identify -- flash a short OSD label on each connected display (connector + model), then exit

DPI Candidate

• --dpi N -- open with N as the candidate DPI (48..384). With --apply or --dryrun, act on N instead of the conf value

Apply And Dry Run

• --apply / --startup -- replay everything saved for the monitors now plugged in: DPI / font-scale, resolution, rotation, and multi-head layout, then exit (session start)
• --dryrun -- print the xrdb/xrandr commands an apply would run; change nothing; exit
• --server-dpi -- with --apply or --dryrun, also run (or show) xrandr --dpi

First-Run Scale

• --apply-first-run-scale -- if the framebuffer is denser than HD and no readability prefs exist yet, write readability_mode=font_scale and font_scale=150, show a one-shot CyOSD, then exit. Used by startcyanotype on first login to a dense panel

Examples

cymonitor-prefs
cymonitor-prefs --probe
cymonitor-prefs --identify
cymonitor-prefs --dpi 120 --dryrun
cymonitor-prefs --apply
cymonitor-prefs --apply --server-dpi

See Also

• Using Display Preferences
• Overview of Display Preferences