NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT EXAMPLES SEE ALSO AUTHOR COPYRIGHT BUGS

"oyranos-monitor" 1 "February 22, 2018" "User Commands"

NAME ↑

oyranos-monitor v0.9.7 - Monitor configuration with Oyranos CMS

SYNOPSIS ↑

oyranos-monitor | -s [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [-v]
oyranos-monitor [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–system-wide] [-v] ICC_FILE_NAME
oyranos-monitor -e -u [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–system-wide] [-v]
oyranos-monitor -l [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–short] [–path] [-c] [-v] [–module=MODULENAME] [-2] [-4]
oyranos-monitor -f=edid|icc|edid_icc|vcgt... -a –modules -L [-o=OUT_FILENAME|default:stdout] [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–display=NAME] [-m] [-v] [-2] [-4]
oyranos-monitor –daemon [-v]
oyranos-monitor –add-edid=FILENAME –add-vcgt=FILENAME –profile=ICC_FILE_NAME [–name=NAME] [-v]
oyranos-monitor -h[=synopsis|...] -X=json|json+command|man|markdown -R=gui|cli|web|... -V [-v]

DESCRIPTION ↑

The oyranos-monitor programm let you query and set the monitor profile(s) within the Oyranos color management system (CMS). Profiles are stored in a data base, the Oyranos DB.

OPTIONS ↑

Set basic parameters

-x=PIXEL	select the screen at the x position. The Oyranos screens are if possible real devices. A screen position must be unique and not shared by different screens, otherwise it will be ambiguous.
-y=PIXEL	select the screen at the y position.
-d|–device-pos=NUMBER	Position in device list. The numbering of monitors starts with zero for the first device. To get the number of all available devices use "oyranos-monitor -l | wc -l".
–display=NAME	Use DISPLAY
–module=MODULENAME	Select module See as well the –modules option.
-c|–x-color-region-target	show the X Color Management (XCM) device profile
–system-wide	do system wide, might need admin or root privileges
-2|–icc-version-2	Select ICC v2 Profiles
-4|–icc-version-4	Select ICC v4 Profiles

Activate Profiles

   oyranos-monitor | -s [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [-v]

  Set up the X11 server with the Oyranos DB stored monitor ICC profile(s).

|	No args Run command without arguments
-s|–setup	Setup a ICC profile for all or a selected monitor

Set New Profile

   oyranos-monitor [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–system-wide] [-v] ICC_FILE_NAME

  Assign a monitor ICC profile to the selected screen and store in the Oyranos DB.

ICC_FILE_NAME

ICC device profile for a monitor

Erase Profile

   oyranos-monitor -e -u [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–system-wide] [-v]

-e|–erase	Release a ICC profile from a monitor device Reset the hardware gamma table to the defaults and erase from the Oyranos DB
-u|–unset	Release a ICC profile from a monitor device Reset the hardware gamma table to the defaults.

List Devices

   oyranos-monitor -l [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–short] [–path] [-c] [-v] [–module=MODULENAME] [-2] [-4]

  List names and show details.

-l|–list	list devices
–short	show only the ICC profiles file name
–path	show the full ICC profile path and file name

Give Informations

   oyranos-monitor -f=edid|icc|edid_icc|vcgt... -a –modules -L [-o=OUT_FILENAME|default:stdout] [-x=PIXEL] [-y=PIXEL|-d=NUMBER] [–display=NAME] [-m] [-v] [-2] [-4]

-f|–format=edid|icc|edid_icc|vcgt...	Select data format Select a data format. Possible are edid for server side EDID data, icc for a server side ICC profile, edid_icc for a ICC profile created from server side EDID and vcgt for effect and monitor white point merged into a possibly altered VCGT tag. Without the -o/–ouput option the output is written to stdout.
-o|–output=OUT_FILENAME|default:stdout	Write data selected by -f/–format to the given filename.
-m|–device-meta-tag	(–device-meta-tag) switch is accepted by the -f=icc and -f=edid_icc option. It embeddes device and driver informations about the actual device for later easier ICC profile to device assignment. This becomes useful for sharing ICC profiles.
-a|–xcm-active	Show if X Color Management is active
–modules	List monitor modules
-L|–list-taxi	List Taxi Profiles

Run Daemon

   oyranos-monitor –daemon [-v]

  Keep a session up to date.

–daemon

Run as daemon to observe monitor hotplug events and update the setup.

Add Device Meta Data

   oyranos-monitor –add-edid=FILENAME –add-vcgt=FILENAME –profile=ICC_FILE_NAME [–name=NAME] [-v]

  Add device information to a profile for automated selection.

–add-edid=FILENAME	EDID Filename Embedd EDID keys to a ICC profile as meta tag. Requires –profile.
–add-vcgt=FILENAME	VCGT Filename Embedd VCGT calibration to a ICC profile as vcgt tag. FILENAME can be output from 'xcalib -p'. Requires –profile.
–profile=ICC_FILE_NAME	ICC profile.
–name=NAME	String for ICC profile internal name.

General Options

   oyranos-monitor -h[=synopsis|...] -X=json|json+command|man|markdown -R=gui|cli|web|... -V [-v]

-h|–help[=synopsis|...]	Print help text Show usage information and hints for the tool. -h - # Full Help : Print help for all groups -h synopsis # Synopsis : List groups - Show all groups including syntax
-X|–export=json|json+command|man|markdown	Export formated text Get UI converted into text formats -X man # Man : Unix Man page - Get a unix man page -X markdown # Markdown : Formated text - Get formated text -X json # Json : GUI - Get a Oyjl Json UI declaration -X json+command # Json + Command : GUI + Command - Get Oyjl Json UI declaration incuding command -X export # Export : All available data - Get UI data for developers. The format can be converted by the oyjl-args tool.
-V|–version	Version
-R|–render=gui|cli|web|...	Render -R gui # Gui : Show UI - Display a interactive graphical User Interface. -R cli # Cli : Show UI - Print on Command Line Interface. -R web # Web : Start Web Server - Start a local Web Service to connect a Webbrowser with. Use the -R=web:help sub option to see more information. -R -
-v|–verbose	increase verbosity

ENVIRONMENT ↑

DISPLAY

  On X11 systems the display is selected by this variable.

OY_DEBUG

  set the Oyranos debug level. Alternatively the -v option can be used.

XDG_DATA_HOME XDG_DATA_DIRS

  route Oyranos to top directories containing resources. The derived paths for ICC profiles have a "color/icc" appended.
  http://www.oyranos.com/wiki/index.php?title=OpenIccDirectoryProposal

OY_MODULE_PATH

  route Oyranos to additional directories containing modules.

EXAMPLES ↑

Put the following in a setup script like .xinitrc

  oyranos-monitor
  Select a monitor profile, load the binary blob into X and fill the VideoCardGammaTable, if appropriate

Assign a ICC profile to a screen

  oyranos-monitor -x pos -y pos profilename

Reset a screens hardware LUT in order to do a calibration

  oyranos-monitor -e -x pos -y pos profilename

Query the server side, network transparent profile

  oyranos-monitor -x pos -y pos

List all Oyranos monitor devices

  oyranos-monitor -l

Show the first Oyranos monitor device verbosely

  oyranos-monitor -l -v -d 0

Pass the monitor profile to a external tool

  iccDumpProfile -v "`oyranos-monitor -l -d 0 -c --path`"

List all monitor devices through the oyX1 module

  oyranos-monitor -l –module oyX1

Dump data in the format following the -f option

  oyranos-monitor -f=[edid|icc|edid_icc] -o=edid.bin -x=pos -y=pos -m

Embedd device informations into ICC meta tag

  oyranos-monitor –add-edid=edid_filename –profile=profilename.icc –name=profilename

SEE ALSO ↑

  oyranos-config-fltk(1)  oyranos-policy(1)  oyranos-profiles(1)  oyranos(3)

https://gitlab.com/oyranos/oyranos

AUTHOR ↑

Kai-Uwe Behrmann https://gitlab.com/beku

COPYRIGHT ↑

© 2005-2024 Kai-Uwe Behrmann and others

License

newBSD https://gitlab.com/oyranos/oyranos

BUGS ↑

https://www.gitlab.com/oyranos/oyranos/issues