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_i…

Referenced By

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

July 29, 2012 User Commands