NAME SYNOPSIS DESCRIPTION OPTIONS GENERAL OPTIONS ENVIRONMENT SEE ALSO AUTHOR COPYRIGHT BUGS

"oyranos-device" 1 "May 13, 2021" "User Commands"

NAME ↑

oyranos-device v0.9.7 - Oyranos Color Devices

SYNOPSIS ↑

oyranos-device -a -c=CLASS -d=NUMBER [-p[=ICC_FILE_NAME]] [–system-wide]
oyranos-device -e -c=CLASS -d=NUMBER [–system-wide]
oyranos-device -s -c=CLASS -d=NUMBER
oyranos-device -u -c=CLASS -d=NUMBER
oyranos-device -l [-v] [–short] [–print-class]
oyranos-device -l [-c=CLASS] [-d=NUMBER|–device-name=NAME] [–short] [–path] [-r] [-v]
oyranos-device –list-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]
oyranos-device –list-taxi-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]
oyranos-device -f=icc|openicc+rank-map|openicc|openicc-rank-map -c=CLASS -d=NUMBER -j=FILENAME -k=FILENAME [-o=FILENAME] [–only-db] [-m]
oyranos-device -h=synopsis|... | -X=json|json+command|man|markdown | -V | -R=gui|cli|web|... [-v]

DESCRIPTION ↑

The oyranos-device program shows and administrates ICC profiles for color devices.

OPTIONS ↑

Set basic parameters

-c|–device-class=CLASS	use device class. Useful device classes are monitor, scanner, printer, camera. -c monitor # Monitor -c printer # Printer -c camera # Camera -c scanner # Scanner
-d|–device-pos=NUMBER	device position start from zero
–device-name=NAME	alternatively specify the name of a device
-2|–icc-version-2	Select ICC v2 Profiles
-4|–icc-version-4	Select ICC v4 Profiles
-r|–skip-x-color-region-target	skip X Color Management device profile

Assign profile to device

   oyranos-device -a -c=CLASS -d=NUMBER [-p[=ICC_FILE_NAME]] [–system-wide]

-a|–assign	add configuration to OpenICC DB
-p|–profile-name[=ICC_FILE_NAME]	profile file name Can be "" empty string or "automatic" or a real profile name.
–system-wide	add computer wide

Unassign profile from device

   oyranos-device -e -c=CLASS -d=NUMBER [–system-wide]

-e|–erase

remove configuration from OpenICC DB

Setup device

   oyranos-device -s -c=CLASS -d=NUMBER

-s|–setup

configure session from OpenICC DB

Unset device

   oyranos-device -u -c=CLASS -d=NUMBER

-u|–unset

reset session configuration to zero

List device classes

   oyranos-device -l [-v] [–short] [–print-class]

-l|–list	List device classes
-v|–verbose	verbose
–short	print module ID or profile name
–print-class	print the modules device class

List devices

   oyranos-device -l [-c=CLASS] [-d=NUMBER|–device-name=NAME] [–short] [–path] [-r] [-v]

  Needs -c option.

-l|–list	List device classes
-c|–device-class=CLASS	use device class. Useful device classes are monitor, scanner, printer, camera. -c monitor # Monitor -c printer # Printer -c camera # Camera -c scanner # Scanner
–short	print module ID or profile name
–path	print the full file name

List local DB profiles for selected device

   oyranos-device –list-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]

  Needs -c and -d options.

–list-profiles	List local DB profiles for selected device
–show-non-device-related	show as well non matching profiles

List Taxi DB profiles for selected device

   oyranos-device –list-taxi-profiles [-c=CLASS] [-d=NUMBER] [–show-non-device-related]

  Needs -c and -d options.

–list-taxi-profiles	List Taxi DB profiles for selected device
–show-non-device-related	show as well non matching profiles

Dump device color state

   oyranos-device -f=icc|openicc+rank-map|openicc|openicc-rank-map -c=CLASS -d=NUMBER -j=FILENAME -k=FILENAME [-o=FILENAME] [–only-db] [-m]

  Needs -c and -d options.

-f|–format=icc|openicc+rank-map|openicc|openicc-rank-map	dump configuration data -f icc # write assigned ICC profile -f fallback-icc # create fallback ICC profile -f openicc+rank-map # create OpenICC device color state JSON including the rank map -f openicc # create OpenICC device color state JSON -f openicc-rank-map # create OpenICC device color state rank map JSON
-o|–output=FILENAME	write to specified file
-j|–device-json=FILENAME	use device JSON alternatively to -c and -d options
-k|–rank-json=FILENAME	use rank map JSON alternatively to -c and -d options
–only-db	use only DB keys for -f=openicc
-m|–device-meta-tag	embedd device and driver information into ICC meta tag

GENERAL OPTIONS ↑

General options

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

-h|–help=synopsis|...	Print help text Show usage information and hints for the tool.
-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|...	Select Renderer Select and possibly configure Renderer. -R="gui" will just launch a graphical UI. -R="web:port=port_number:https_key=TLS_private_key_filename:https_cert=TLS_CA_certificate_filename:css=layout_filename.css" will launch a local Web Server, which listens on local port. -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	verbose

ENVIRONMENT ↑

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

SEE ALSO ↑

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

http://www.oyranos.org

AUTHOR ↑

Kai-Uwe Behrmann http://www.oyranos.org

COPYRIGHT ↑

© 2005-2021 Kai-Uwe Behrmann and others

License

newBSD http://www.oyranos.org

BUGS ↑

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