Shortcuts - jsiegenthaler/homebridge-samsungtvht GitHub Wiki

The TV and HT state can be read and controlled in the iOS Shortcuts app and in the Home app. I have added as many characteristics as possible to provide for maximum flexibility. Please note that the descriptions below are written for iOS 15.6, and last updated for iOS 18. Older iOS versions before 15.6 may have slightly different displayed text.

Supported Shortcut Actions

The shortcut actions supported for a TV accessory are:

Get state - Gets the state of a Home accessory
Control Home - Set the state of your home
Toggle Accessory or Scene - Toggles the state of the specified accessory or scene
Show Remote Control - Shows the Apple TV remote in Control

Shortcut actions are part of the iOS operating system and are thus under the control of Apple. Only Apple can add more actions.

To see the available actions, search for Home in the Shortcuts app or the Home app. Select the desired action from the displayed list to use it.

Action: Get state (Reading the TV or HT state)

Displays initially as Get (Accessory State) in (HomeName). Tap on Accessory State to select the desired accessory, then select on the displayed characteristic to select the desired characteristic. The plugin has no ability to read the status of the TV or home theater, thus some the characteristics always return default values. Note that as of iOS/iPadOS 18.4, many of the chacteristics can no longer be selected in the Apple Home app, but they are still available in other Home apps such as Eve.

Supported accessory characteristics for the TV or HT are:

Active

Power state, On or Off. See https://developers.homebridge.io/#/characteristic/Active

Active Identifier

The selected TV input, 1 is the first input in the list, 2 the next, and so on. Returns the value of the currently selected input in the Home app, this may not be the same as the current input on the TV, as the plugin cannot read the TV status. If no input is selected in the Home app, returns 999. See https://developers.homebridge.io/#/characteristic/ActiveIdentifier

NOTE: Active Identifier is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Configured Name

The accessory name. See https://developers.homebridge.io/#/characteristic/ConfiguredName

NOTE: Configured Name is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Current Media State

The accessory current media state, one of 0 (PLAY), 1 (PAUSE), 2 (STOP), 4 (LOADING) or 5 (INTERRUPTED). Always returns 2 as the plugin cannot read the TV media status. See https://developers.homebridge.io/#/characteristic/CurrentMediaState

Name

The accessory name as at last restart of Homebridge. See https://developers.homebridge.io/#/characteristic/Name

NOTE: Name is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Power Mode Selection

Menu command sent by the accessory. For control only. If Shortcuts tries to get the state of this characteristic then the error Operation is not supported is displayed. See https://developers.homebridge.io/#/characteristic/PowerModeSelection

NOTE: Power Mode Selection is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Remote Key

Remote control keys sent by the Apple TV Remote. For control only. If Shortcuts tries to get the state of this characteristic then the error Operation is not supported is displayed. See https://developers.homebridge.io/#/characteristic/RemoteKey

NOTE: Remote Key is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Sleep Discovery Mode

Always 1 (ALWAYS_DISCOVERABLE). See https://developers.homebridge.io/#/characteristic/SleepDiscoveryMode

NOTE: Sleep Discovery Mode is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Status Fault

Indicates if the plugin has detected a fault or not, returns No for NO_FAULT and Yes for GENERAL_FAULT. See https://developers.homebridge.io/#/characteristic/StatusFault

NOTE: Status Fault is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Target Media State

The accessory target media state, one of 0 (PLAY), 1 (PAUSE) or 2 (STOP). Always returns 2 as the plugin cannot read the TV media status. See https://developers.homebridge.io/#/characteristic/TargetMediaState

NOTE: Target Media State is no longer available in the Apple Home app as of iOS/iPadOS 18.4. Use another app such as Eve to access this characteristic.

Action: Control Home (Controlling the TV or HT)

Displays initially as Set (Scenes and Accessories) in (HomeName). Tap on Scenes and Accessories to select the desired accessory.

You can only control the items accessible through the Home app accessory tile. Unfortunately, this is an Apple limitation. Hopefully Apple will improve Shortcut’s control in the future. Press and hold to adjust the accessory.

Supported accessory control capabilities for the TV or HT are:

Active

The power button. Power state, On or Off. See https://developers.homebridge.io/#/characteristic/Active

Active Identifier

The channel list (also known as input list). In the channel list, the Active Identifier 0 is the first in the list, 1 the next, and so on. See https://developers.homebridge.io/#/characteristic/ActiveIdentifier

Note that you can send any key code from the Input list, so feel free to be creative and configure key codes such as KEY_MUTE, KEY_VOLUP, KEY_VOLDOWN as inputs. See the Wiki Siri page for more creative information on how to control your TV or HT using scenes.

Action: Toggle Accessory or Scene

The Samsung TV or HT can also be toggled: turn on if off, or turn off if on. This is not especially useful.

Action: Show Remote Control (part of Apple TV Remote)

The Samsung TV or HT can also be controlled by the iOS Remote Control. In the Shortcuts app, search for Apple TV Remote then select Show Remote Control.

Running the action Show remote control for (Apple TV) will open the iOS remote control. Apple TV is shown to indicate you should select an Apple TV, but you do not have to. Leave the Apple TV input empty, or pass an empty Magic Variable to open the remote control with the last used device selected.

NOTE: Show Remote Control with no Apple TV selected works in iOS 14 and iOS 18. It does not work in iOS 15/16/17: when running Show remote control for (Apple TV) with no Apple TV selected, an error is displayed: Could Not Run Show Remote Control - An unknown error occurred