oyranos-monitor man page

oyranos-monitor — Oyranos CMS monitor configuration

Synopsis

oyranos-monitor |-s [[-x num] [-y num]|-d NUMBER] [-v] oyranos-monitor PROFILENAME [[-x num] [-y num]|-d NUMBER] [-v] oyranos-monitor -e [[-x num] [-y num]|-d NUMBER] [-v] oyranos-monitor -l [[-x num] [-y num]|-d NUMBER] [-v]
               [ --module MODULENAME ] oyranos-monitor --modules [-v] oyranos-monitor -f [edid|icc|edid_icc] [-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

-s Setup a ICC profile for a all or a selected monitor

-s, --setup [default] Set up the X11 server with the Oyranos DB stored monitor ICC profile(s). This option is optional.

-d NUMBER , -d=NUMBER position in device list.
-x POSITION , -x=POSITION select the screen at the x position.
-y POSITION , -y=POSITION select the screen at the y position.

PROFILENAME  assign a ICC profile to a monitor device

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

-d NUMBER , -d=NUMBER position in device list.
-x POSITION , -x=POSITION select the screen at the x position.
-y POSITION , -y=POSITION select the screen at the y position.

-e, --erase release a ICC profile from a monitor device

Reset the hardware gamma table to the defaults and erase from the Oyranos DB

-d NUMBER , -d=NUMBER position in device list.
-x POSITION , -x=POSITION select the screen at the x position.
-y POSITION , -y=POSITION select the screen at the y position.

-l, --list list devices

-v increase verbosity
--short show only the ICC profiles file name

--modules

list monitor modules

-f, --format [edid|icc|edid_icc] Get data

Select a data format. Possible are edid for server side EDID data, icc for a server side ICC profile and edid_icc for a ICC profile created from server side EDID. Without the -o/--ouput option the output is written to stdout.

-d NUMBER , -d=NUMBER position in device list.
-x POSITION , -x=POSITION select the screen at the x position.
-y POSITION , -y=POSITION select the screen at the y position.
-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.
-o, --output OUT_FILENAME Write data selected by -f/--format to the given filename.

--add-edid EDID_FILENAME

Embedd EDID keys to a ICC profile as meta tag. Requires --profile.
--profile ICC_FILENAME ICC profile.
--name ICC_INTERNAL_NAME String for ICC profile internal name.

General Options

-d NUMBER
, -d=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".
-x POSITION , -x=POSITION 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 POSITION , -y=POSITION select the screen at the y position
-v, --verbose increase verbosity
--module select module
--daemon

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

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

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

Author

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

See Also

oyranos-config-fltk(1) oyranos-policy(1) oyranos-profiles(1) oyranos(3) http://www.oyranos.org

Bugs

at: http://sourceforge.net/tracker/?group_id=177017&atid=879553

Referenced By

oyranos(3), oyranos-config(3), oyranos-config-fltk(1), oyranos-monitor-daemon(1), oyranos-policy(1).

July 29, 2012 User Commands