Oyranos  git-devel
Oyranos is a full featured Color Management System
oyranos-monitor

NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT EXAMPLES SEE ALSO AUTHOR COPYRIGHT BUGS

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

NAME

oyranos-monitor - Oyranos CMS monitor configuration

SYNOPSIS

oyranos-monitor | -s [-x=num] [-y=num] [-d=NUMBER] [-v]
oyranos-monitor [-x=num] [-y=num] [-d=NUMBER] [--system-wide] [-v] PROFILENAME
oyranos-monitor -e [-x=num] [-y=num] [-d=NUMBER] [--system-wide] [-v]
oyranos-monitor -l [-x=num] [-y=num] [-d=NUMBER] [--short] [--path] [-c] [-v] [--module=MODULENAME]
oyranos-monitor --modules [-v]
oyranos-monitor -f=edid|icc|edid_icc|vcgt [-o=OUT_FILENAME|default:stdout] [-x=num] [-y=num] [-d=NUMBER] [-m] [-v]
oyranos-monitor --add-edid=FILENAME --profile=FILENAME [--name=NAME] [-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

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

| No args
Run command without arguments
-s|–setup Setup a ICC profile for a all or a selected monitor [default] Set up the X11 server with the Oyranos DB stored monitor ICC profile(s). This option is optional.
-x num POSITION , -x=POSITION select the screen at the x position. by different screens, otherwise it will be ambiguous.
-y num POSITION , -y=POSITION select the screen at the y position.
-d NUMBER , -d=NUMBER position in device list. "oyranos-monitor -l | wc -l".
-v|–verbose increase verbosity

  oyranos-monitor [-x=num] [-y=num] [-d=NUMBER] [--system-wide] [-v] PROFILENAME

PROFILENAME assign a ICC profile to a monitor device
Assign a monitor ICC profile to the selected screen and store in the Oyranos DB.
-x num POSITION , -x=POSITION select the screen at the x position. by different screens, otherwise it will be ambiguous.
-y num POSITION , -y=POSITION select the screen at the y position.
-d NUMBER , -d=NUMBER position in device list. "oyranos-monitor -l | wc -l".
–system-wide do system wide, might need admin or root privileges
-v|–verbose increase verbosity

  oyranos-monitor -e [-x=num] [-y=num] [-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
-x num POSITION , -x=POSITION select the screen at the x position. by different screens, otherwise it will be ambiguous.
-y num POSITION , -y=POSITION select the screen at the y position.
-d NUMBER , -d=NUMBER position in device list. "oyranos-monitor -l | wc -l".
–system-wide do system wide, might need admin or root privileges
-v|–verbose increase verbosity

  oyranos-monitor -l [-x=num] [-y=num] [-d=NUMBER] [--short] [--path] [-c] [-v] [--module=MODULENAME]

-l|–list list devices
-x num POSITION , -x=POSITION select the screen at the x position. by different screens, otherwise it will be ambiguous.
-y num POSITION , -y=POSITION select the screen at the y position.
-d NUMBER , -d=NUMBER position in device list. "oyranos-monitor -l | wc -l".
–short show only the ICC profiles file name
–path show the full ICC profile path and file name
-c|–x-color-region-target show the X Color Management (XCM) device profile
-v|–verbose increase verbosity
–module MODULENAME select module

  oyranos-monitor --modules [-v]

–modules list monitor modules
list monitor modules
-v|–verbose increase verbosity

  oyranos-monitor -f=edid|icc|edid_icc|vcgt [-o=OUT_FILENAME|default:stdout] [-x=num] [-y=num] [-d=NUMBER] [-m] [-v]

-f|–format edid|icc|edid_icc|vcgt [edid|icc|edid_icc|vcgt] Get data
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 OUT_FILENAME Write data selected by -f/–format to the given filename.
-x num POSITION , -x=POSITION select the screen at the x position. by different screens, otherwise it will be ambiguous.
-y num POSITION , -y=POSITION select the screen at the y position.
-d NUMBER , -d=NUMBER position in device list. "oyranos-monitor -l | wc -l".
-m (–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.
-v|–verbose increase verbosity

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

–add-edid FILENAME EDID_FILENAME
Embedd EDID keys to a ICC profile as meta tag. Requires –profile.
–profile FILENAME ICC_FILENAME ICC profile.
–name NAME ICC_INTERNAL_NAME String for ICC profile internal name.
-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

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

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)

http://www.oyranos.org

AUTHOR

Kai-Uwe Behrmann (ku.b (at) gmx.de)

COPYRIGHT

*(c) 2005-2018, Kai-Uwe Behrmann and others*

License

new BSD <http://www.opensource.org/licenses/BSD-3-Clause>

BUGS

at: https://github.com/oyranos-cms/oyranos/issues