---
name: "samsung-mdc"
section: "1"
platform: "linux"
package: "python3-samsung-mdc"
version: "1.15.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/samsung-mdc"
---

# samsung-mdc(1)

Samsung Multiple Display Control Protocol

## NAME

Samsung-MDC - Samsung Multiple Display Control Protocol

## SYNOPSIS

samsung-mdc \[OPTIONS\] TARGET COMMAND \[ARGS\]...

Try 'samsung-mdc --help COMMAND' for help on individual commands.

TARGET may be:

- •

  DISPLAY\_ID@IP\[:PORT\]\
   (default port: 1515, example: 0@192.168.0.10:1515)

- •

  FILENAME with target list, separated by newline.

Commands run asynchronously, so the order of results may differ when working with multiple targets.

To connect via serial port, use:

- •

  DISPLAY\_ID@PORT\_NAME for Windows (example: 1@COM1)

- •

  DISPLAY\_ID@PORT\_PATH for Linux (example: 1@/dev/ttyUSB0).

Samsung-MDC tries to determine the connection mode from the port name, but you may want to specify the mode using **--mode**.

## DESCRIPTION

Samsung-MDC is an implementation of the Samsung Multiple Display Control Protocol using python and asyncio.

Samsung-MDC allows users to control compatible Samsung displays through the built-in RS-232C or Ethernet interface.

### Command-line options

- **--version**

  Show program version and exit.

- **-v**, **--verbose**

  Enable verbose output.

- **-m**, **--mode \[auto\|tcp\|serial\]**

  Connection mode (default: auto)

- **-p**, **--pin INTEGER**

  4-digit PIN for secure TLS connection. If a PIN is provided, "Secured Protocol" must be enabled on the remote device.

- **-t**, **--timeout FLOAT**

  Read/Write/Connect timeout in seconds (default: 5).\
   Connect can be overridden with a separate option.

- **--connect-timeout FLOAT**

  Connect timeout in seconds.

- **-h**, **--help**

  Show this message and exit.

## OPTIONS

- **status**

  (POWER\_STATE VOLUME MUTE\_STATE INPUT\_SOURCE\_STATE PICTURE\_ASPECT\_STATE N\_TIME\_NF F\_TIME\_NF)

- **video**

  (CONTRAST BRIGHTNESS SHARPNESS COLOR TINT COLOR\_TONE\_STATE COLOR\_TEMPERATURE \_IGNORE)

- **rgb**

  (CONTRAST BRIGHTNESS COLOR\_TONE\_STATE COLOR\_TEMPERATURE \_IGNORE RED\_GAIN GREEN\_GAIN BLUE\_GAIN)

- **serial\_number**

  (SERIAL\_NUMBER)

- **error\_status**

  (LAMP\_ERROR\_STATE TEMPERATURE\_ERROR\_STATE BRIGHTNESS\_SENSOR\_ERROR\_STATE INPUT\_SOURCE\_ERROR\_STATE TEMPERATURE FAN\_ERROR\_STATE)

- **software\_version**

  (SOFTWARE\_VERSION)

- **model\_number**

  (MODEL\_SPECIES MODEL\_CODE TV\_SUPPORT)

- **power**

  \[POWER\_STATE\]

- **volume**

  \[VOLUME\]

- **mute**

  \[MUTE\_STATE\]

- **input\_source**

  \[INPUT\_SOURCE\_STATE\]

- **picture\_aspect**

  \[PICTURE\_ASPECT\_STATE\]

- **screen\_mode**

  \[SCREEN\_MODE\_STATE\]

- **screen\_size**

  (INCHES)

- **network\_configuration**

  \[IP\_ADDRESS SUBNET\_MASK GATEWAY\_ADDRESS DNS\_SERVER\_ADDRESS\]

- **network\_mode**

  \[NETWORK\_MODE\_STATE\]

- **network\_ap\_config**

  SSID PASSWORD

- **weekly\_restart**

  \[WEEKDAY TIME\]

- **magicinfo\_channel**

  CHANNEL\_NUMBER

- **magicinfo\_server**

  \[MAGICINFO\_SERVER\_URL\]

- **magicinfo\_content\_orientation**

  \[ORIENTATION\_MODE\_STATE\]

- **mdc\_connection**

  \[MDC\_CONNECTION\_TYPE\]

- **contrast**

  \[CONTRAST\]

- **brightness**

  \[BRIGHTNESS\]

- **sharpness**

  \[SHARPNESS\]

- **color**

  \[COLOR\]

- **tint**

  \[TINT\]

- **h\_position**

  H\_POSITION\_MOVE\_TO

- **v\_position**

  V\_POSITION\_MOVE\_TO

- **auto\_power**

  \[AUTO\_POWER\_STATE\]

- **clear\_menu**

  - **ir\_state**

  \[IR\_STATE\]

- **rgb\_contrast**

  \[CONTRAST\]

- **rgb\_brightness**

  \[BRIGHTNESS\]

- **auto\_adjustment\_on**

  - **color\_tone**

  \[COLOR\_TONE\_STATE\]

- **color\_temperature**

  \[HECTO\_KELVIN\]

- **standby**

  \[STANDBY\_STATE\]

- **auto\_lamp**

  \[MAX\_TIME MAX\_LAMP\_VALUE MIN\_TIME MIN\_LAMP\_VALUE\]

- **manual\_lamp**

  \[LAMP\_VALUE\]

- **inverse**

  \[INVERSE\_STATE\]

- **video\_wall\_mode**

  \[VIDEO\_WALL\_MODE\]

- **safety\_lock**

  \[LOCK\_STATE\]

- **panel\_lock**

  \[LOCK\_STATE\]

- **channel\_change**

  CHANGE\_TO

- **volume\_change**

  CHANGE\_TO

- **ticker**

  \[ON\_OFF START\_TIME END\_TIME POS\_HORIZ POS\_VERTI MOTION\_ON\_OFF MOTION\_DIR MOTION\_SPEED FONT\_SIZE FOREGROUND\_COLOR BACKGROUND\_COLOR FOREGROUND\_OPACITY BACKGROUND\_OPACITY MESSAGE\]

- **device\_name**

  (DEVICE\_NAME)

- **osd**

  \[OSD\_ENABLED\]

- **picture\_mode**

  \[PICTURE\_MODE\_STATE\]

- **sound\_mode**

  \[SOUND\_MODE\_STATE\]

- **all\_keys\_lock**

  \[LOCK\_STATE\]

- **panel\_on\_time**

  (MIN10)

- **video\_wall\_state**

  \[VIDEO\_WALL\_STATE\]

- **video\_wall\_model**

  \[MODEL SERIAL\]

- **model\_name**

  (MODEL\_NAME)

- **energy\_saving**

  \[ENERGY\_SAVING\_STATE\]

- **reset**

  RESET\_TARGET

- **osd\_type**

  \[OSD\_TYPE OSD\_ENABLED\]

- **timer\_13**

  TIMER\_ID \[ON\_TIME ON\_ENABLED OFF\_TIME OFF\_ENABLED REPEAT MANUAL\_WEEKDAY VOLUME INPUT\_SOURCE\_STATE HOLIDAY\_APPLY\]

- **timer\_15**

  TIMER\_ID \[ON\_TIME ON\_ENABLED OFF\_TIME OFF\_ENABLED ON\_REPEAT ON\_MANUAL\_WEEKDAY OFF\_REPEAT OFF\_MANUAL\_WEEKDAY VOLUME INPUT\_SOURCE\_STATE HOLIDAY\_APPLY\]

- **clock\_m**

  \[DATETIME\]

- **holiday\_set**

  HOLIDAY\_MANAGE START\_MONTH START\_DAY END\_MONTH END\_DAY

- **holiday\_get**

  \[INDEX\]

- **virtual\_remote**

  KEY\_CODE

- **network\_standby**

  \[NETWORK\_STANDBY\_STATE\]

- **dst**

  \[DST\_STATE START\_MONTH START\_WEEK START\_WEEKDAY START\_TIME END\_MONTH END\_WEEK END\_WEEKDAY END\_TIME OFFSET\]

- **auto\_id\_setting**

  \[AUTO\_ID\_SETTING\_STATE\]

- **display\_id**

  DISPLAY\_ID\_STATE

- **clock\_s**

  \[DATETIME\]

- **launcher\_play\_via**

  \[PLAY\_VIA\_MODE\]

- **launcher\_url\_address**

  \[URL\_ADDRESS\]

- **osd\_menu\_orientation**

  \[ORIENTATION\_MODE\_STATE\]

- **osd\_source\_content\_orientation**

  \[ORIENTATION\_MODE\_STATE\]

- **osd\_aspect\_ratio**

  \[ASPECT\_RATIO\_STATE\]

- **osd\_pip\_orientation**

  \[ORIENTATION\_MODE\_STATE\]

- **osd\_menu\_size**

  \[MENU\_SIZE\_STATE\]

- **auto\_source\_switch**

  \[AUTO\_SOURCE\_SWITCH\_STATE\]

- **auto\_source**

  \[PRIMARY\_SOURCE\_RECOVERY PRIMARY\_SOURCE SECONDARY\_SOURCE\]

- **panel**

  \[PANEL\_STATE\]

- **screen\_mute**

  \[SCREEN\_MUTE\_STATUS\]

- **script**

  \[OPTIONS\] SCRIPT\_FILE

- **raw**

  \[OPTIONS\] COMMAND \[DATA\]

## REPORTING BUGS

Samsung-MDC is maintained on GitHub. Please report all bugs to the issue tracker at https://github.com/vgavro/samsung-mdc/issues