1oyranos-monitor(1)          General Commands Manual         oyranos-monitor(1)
2
3
4

NAME

6       oyranos-monitor - Oyranos CMS monitor configuration
7

SYNOPSIS

9       oyranos-monitor |-s [[-x num] [-y num]|-d NUMBER] [-v]
10       oyranos-monitor PROFILENAME [[-x num] [-y num]|-d NUMBER] [-v]
11       oyranos-monitor -e [[-x num] [-y num]|-d NUMBER] [-v]
12       oyranos-monitor -l [[-x num] [-y num]|-d NUMBER] [-v]
13                       [ --module MODULENAME ]
14       oyranos-monitor --modules [-v]
15       oyranos-monitor  -f [edid|icc|edid_icc] [-o OUT_FILENAME | default:std‐
16       out] [[-x num] [-y num]|-d NUMBER] [-m] [-v]
17       oyranos-monitor --add-edid FILENAME --profile  FILENAME  [--name  NAME]
18       [-v]
19

DESCRIPTION

21       The  oyranos-monitor  programm  let  you query and set the monitor pro‐
22       file(s) within the Oyranos color management system (CMS). Profiles  are
23       stored in a data base, the Oyranos DB.
24

OPTIONS

26       -s Setup a ICC profile for a all or a selected monitor
27
28              -s,  --setup [default] Set up the X11 server with the Oyranos DB
29              stored monitor ICC profile(s). This option is optional.
30
31              -d NUMBER , -d=NUMBER position in device list.
32              -x POSITION , -x=POSITION select the screen at the x position.
33              -y POSITION , -y=POSITION select the screen at the y position.
34
35       PROFILENAME  assign a ICC profile to a monitor device
36              Assign a monitor ICC profile to the selected screen and store in
37              the Oyranos DB.
38
39              -d NUMBER , -d=NUMBER position in device list.
40              -x POSITION , -x=POSITION select the screen at the x position.
41              -y POSITION , -y=POSITION select the screen at the y position.
42
43       -e, --erase  release a ICC profile from a monitor device
44              Reset  the  hardware  gamma table to the defaults and erase from
45              the Oyranos DB
46
47              -d NUMBER , -d=NUMBER position in device list.
48              -x POSITION , -x=POSITION select the screen at the x position.
49              -y POSITION , -y=POSITION select the screen at the y position.
50
51       -l, --list list devices
52              -v increase verbosity
53              --short show only the ICC profiles file name
54
55       --modules
56              list monitor modules
57
58       -f, --format [edid|icc|edid_icc] Get data
59              Select a data format. Possible are edid  for  server  side  EDID
60              data,  icc  for a server side ICC profile and edid_icc for a ICC
61              profile created from server side EDID.  Without  the  -o/--ouput
62              option the output is written to stdout.
63
64              -d NUMBER , -d=NUMBER position in device list.
65              -x POSITION , -x=POSITION select the screen at the x position.
66              -y POSITION , -y=POSITION select the screen at the y position.
67              -m  (--device-meta-tag)  switch  is  accepted  by the -f=icc and
68              -f=edid_icc option. It embeddes device and  driver  informations
69              about  the  actual device for later easier ICC profile to device
70              assignment.  This becomes useful for sharing ICC profiles.
71              -o, --output OUT_FILENAME Write data selected by -f/--format  to
72              the given filename.
73
74       --add-edid EDID_FILENAME
75              Embedd  EDID  keys to a ICC profile as meta tag. Requires --pro‐
76              file.
77              --profile ICC_FILENAME ICC profile.
78              --name ICC_INTERNAL_NAME String for ICC profile internal name.
79

GENERAL OPTIONS

81       -d NUMBER , -d=NUMBER position in device list.  The numbering of  moni‐
82       tors  starts  with  zero for the first device. To get the number of all
83       available devices use "oyranos-monitor -l | wc -l".
84       -x POSITION , -x=POSITION select the screen at  the  x  position.   The
85       Oyranos screens are if possible real devices. A screen position must be
86       unique and not shared  by  different  screens,  otherwise  it  will  be
87       ambiguous.
88       -y POSITION , -y=POSITION select the screen at the y position
89       -v, --verbose increase verbosity
90       --module select module
91
92       --daemon
93              Run  as  daemon to observe monitor hotplug events and update the
94              setup.
95

ENVIRONMENT

97       DISPLAY
98              On X11 systems the display is selected by this variable.
99
100       OY_DEBUG
101              set the Oyranos debug level. Alternatively the -v option can  be
102              used.
103
104       XDG_DATA_HOME XDG_DATA_DIRS
105              route  Oyranos  to  top  directories  containing  resources. The
106              derived paths for ICC profiles have a "color/icc" appended.
107              http://www.oyranos.com/wiki/index.php?title=OpenIccDirectoryProposal
108
109       OY_MODULE_PATH
110              route Oyranos to additional directories containing modules.
111

EXAMPLES

113       Put the following in a setup script like .xinitrc:
114              # select a monitor profile, load the binary blob into X and
115              # fill the VideoCardGammaTable, if appropriate
116              oyranos-monitor
117
118       Assign a ICC profile to a screen:
119              oyranos-monitor -x pos -y pos profilename
120
121       Reset a screens hardware LUT in order to do a calibration:
122              oyranos-monitor -e -x pos -y pos profilename
123
124       Query the server side, network transparent profile:
125              oyranos-monitor -x pos -y pos
126
127       List all Oyranos monitor devices:
128              oyranos-monitor -l
129
130       Show the first Oyranos monitor device verbosely:
131              oyranos-monitor -l -v -d 0
132
133       List all monitor devices through the oyX1 module:
134              oyranos-monitor -l --module oyX1
135
136       Dump data in the format following the -f option:
137              oyranos-monitor -f=[edid|icc|edid_icc] -o=edid.bin -x=pos -y=pos
138              -m
139
140       Embedd device informations into ICC meta tag:
141              oyranos-monitor    --add-edid=edid_filename   --profile=profile‐
142              name.icc --name=profilename
143

AUTHOR

145       Kai-Uwe Behrmann (ku.b (at) gmx.de)
146
148       (c) 2005-2012, Kai-Uwe Behrmann and others
149       License: new BSD <http://www.opensource.org/licenses/bsd-license.php>
150

SEE ALSO

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

BUGS

156       at: http://sourceforge.net/tracker/?group_id=177017&atid=879553
157
158
159
160User Commands                    July 29, 2012              oyranos-monitor(1)
Impressum