home-assistant.io/source/_integrations/cmus.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale
cmus	Instructions on how to integrate cmus Music Player into Home Assistant.	Media player	Local Polling	0.23	cmus	media_player	integration	legacy

The cmus platform allows you to control a cmus music player on a remote or local machine from Home Assistant.

To add cmus to your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

Running it locally will look like:

# Example configuration.yaml entry
media_player:
  - platform: cmus

If cmus is running on a remote server:

# Example configuration.yaml entry
media_player:
  - platform: cmus
    host: IP_ADDRESS_OF_CMUS_PLAYER
    password: YOUR_PASSWORD

{% configuration %} host: description: Hostname or IP address of the machine running cmus. Note if a remote cmus is configured that instance must be configured to listen to remote connections, which also requires a password to be set. required: inclusive type: string password: description: Password for your cmus player. required: inclusive type: string port: description: Port of the cmus socket. required: false default: 3000 type: integer name: description: The name you'd like to give the cmus player in Home Assistant. required: false default: cmus type: string {% endconfiguration %}