# Switches
Switches allows you to create custom accessories with actions that can't be done with the main accessory.
A custom switch can execute multiple or even all actions.
This for example will: Set a sleep time for 60 minutes, mute the TV, change the aspect ratio to 16:9 and switch the TV to channel 13.
{"name": "Multiple", "sleep": 60, "mute": true, "command": "KEY_16_9", "channel": 13}
# Settings
| Name | Description |
|---|---|
| name | Name of the switch |
| power | Power on TV before running actions |
| sleep | This will turn OFF the TV after a specific time |
| mute | Send the mute command |
| volume | Set audio volume of TV |
| app | Open a selected application |
| input | Select a specific input source |
| channel | Switch TV to a channel |
| picture_mode | Set picture mode of TV |
| command | Send command(s) to TV |
# name
(Required) The name of the switch to be used in Home app. The main device name will be appended to the switch name.
- Type:
string - Example:
My Switch
# Actions
# power
By default a switch will throw an error if the TV is OFF.
Setting the power parameter to true will first turn ON the TV then run other actions.
- Type:
boolean - Default
false - Possible values:
true/false
{"name": "My Switch", "power": true, "command": "KEY_VOLUP"}
# sleep
This allows you to set sleep command and turn OFF the TV after a specific time. The value is in minutes.
- Type:
number - Example
10
{"name": "Sleep", "sleep": 10}
# mute
This action sends the KEY_MUTE to TV.
Unfortunately there is no method to get the state of volume from the TV.
This results in a toggle command. This means that if your TV is already on mute and you switch this accessory, it will unmute it.
- Type:
boolean - Default
false - Possible values:
true/false
{"name": "Mute", "mute": true}
# volume
WARNING
In order to use this type of action you must have SmartThings API configured.
Set the speaker volume of TV.
- Type:
number - Example:
10
{"name": "Volume 10", "volume": 10}
# application
This option allow you to open an installed application. You can find a list with applications on the Applications page.
- Type:
string - Example
11101200001
{"name": "Netflix", "app": "11101200001"}
# input
WARNING
In order to use this type of action you must have SmartThings API configured.
Select a specific input source.
- Type:
string - Example
HDMI1 - Possible values:
digitalTv/USB/HDMI1/HDMI2/HDMI3/HDMI4/HDMI5/HDMI6
{"name": "My Xbox", "input": "HDMI1"}
# channel
Change the TV to a specific channel.
- Type:
number - Example
13
{"name": "Channel 13", "channel": 13}
# picture_mode
WARNING
In order to use this type of action you must have SmartThings API configured.
Set the picture mode of TV.
- Type:
string - Example
Standard - Possible values:
Dynamic/Standard/Natural/Movie
{"name": "Picture Movie", "picture_mode": "Movie"}
# command
Send commands to TV. You can find a list with known commands on the Commands page.
- Type:
string - Example
KEY_VOLUP
Example of sending a command
{"name": "Vol Up", "command": "KEY_VOLUP"}
Example of sending multiple commands
{"name": "Multiple commands", "command": "KEY_LEFT,KEY_RIGHT,KEY_UP"}
Example of sending a command multiple times. This will send the command KEY_VOLUP 5 times
{"name": "Vol Up", "command": "KEY_VOLUP*5"}
Example of holding a key for 5 seconds
{"name": "Vol Up", "command": "KEY_VOLUP*5s"}