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

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_iot_class	ha_release	redirect_from
page	cmus	Instructions on how to integrate cmus Music Player into Home Assistant.	2016-06-17 18:45	true	false	true	true	Media Player	Local Polling	0.23	/components/media_player.cmus/

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 configuration.yaml file if running locally it 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 %}