home-assistant.io/source/_components/cover.command_line.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	Command Line Cover	How to control a cover with the command line.	2016-06-28 17:30	true	false	true	true	command_line.png	Cover	0.14	Local Polling

A command_linecover platform that issues specific commands when it is moved up, down and stopped. It allows anyone to integrate any type of cover into Home Assistant that can be controlled from the command line.

To enable a command line cover in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
cover:
- platform: command_line
  covers:
    Garage door:
      opencmd: move_command up kitchen
      closecmd: move_command down kitchen
      stopcmd: move_command stop kitchen
      statecmd: state_command kitchen
      value_template: {% raw %}>
        {% if value == 'open' %}
        100
        {% elif value == 'closed' %}
        0
        {% endif %}
        {% endraw %}

Configuration variables:

• covers (Required): The array that contains all command line covers.
  • entry (Required): Name of the command line cover. Multiple entries are possible.
    • opencmd (Required): The command to open the cover.
    • closecmd (Required): The action to close the cover.
    • stopcmd (Required): The action to stop the cover.
    • statecmd (Optional): If given, this will act as a sensor that runs in the background and updates the state of the cover. If the command returns a 0 the indicates the cover is fully closed, whereas a 100 indicates the cover is fully open.
    • value_template (optional - default: '{% raw %}{{ value }}{% endraw%}'): if specified, statecmd will ignore the result code of the command but the template evaluating will indicate the position of the cover. For example, if your statecmd returns a string "open", using value_template as in the example config above will allow you to translate that into the valid state 100.