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

title, description, ha_category, ha_release, ha_quality_scale, ha_domain, ha_codeowners, ha_integration_type

title	description	ha_category	ha_release	ha_quality_scale	ha_domain	ha_codeowners	ha_integration_type
Media Player	Instructions on how to setup your media players with Home Assistant.	Media Player	0.7	internal	media_player	@home-assistant/core	entity

Interacts with media players on your network.

Services

Media control services

Available services: turn_on, turn_off, toggle, volume_up, volume_down, volume_set, volume_mute, media_play_pause, media_play, media_pause, media_stop, media_next_track, media_previous_track, clear_playlist, shuffle_set, repeat_set, play_media, select_source, select_sound_mode, join, unjoin

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.

Service media_player.volume_mute

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.
is_volume_muted	no	True/false for mute/unmute

Service media_player.volume_set

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.
volume_level	no	Float for volume level. Range 0..1

Service media_player.media_seek

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.
seek_position	no	Position to seek to. The format is platform dependent.

Service media_player.play_media

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.
media_content_id	no	A media identifier. The format of this is integration dependent. For example, you can provide URLs to Sonos and Cast but only a playlist ID to iTunes.
media_content_type	no	A media type. Must be one of music, tvshow, video, episode, channel or playlist. For example, to play music you would set media_content_type to music.
enqueue	yes	How the new media should interact with the queue. Must be one of add, next, play, replace. If the media player doesn't support this feature, the new media will play and the enqueue directive is ignored.
announce	yes	Set to true to request the media player to temporarily stop playing media to announce this media and then resume. If the media player doesn't support this feature, the announcement will play but the media player and will not resume playing the interrupted media once the announcement finishes.
extra	yes	Extra dictionary data to send, e.g., title, thumbnail. Possible values can be found below.

Extra dictionary data

{% configuration %} title: type: string description: Title of the media. required: false thumb: type: string description: Thumbnail image URL. required: false current_time: type: float description: Seconds since the beginning of the content. If the content is live content, and the position is not specified, the stream will start at the live position. required: false autoplay: type: boolean description: Whether the media will automatically play. default: true required: false stream_type: type: string description: "Describes the type of media artifact as one of the following: NONE, BUFFERED, LIVE." required: false subtitles: type: string description: URL of subtitle file to be shown on chromecast. required: false subtitles_lang: type: string description: Language for subtitles. required: false subtitles_mime: type: string description: Mimetype of subtitles. required: false subtitle_id: type: integer description: ID of subtitle to be loaded. required: false enqueue: type: boolean description: If True, enqueue the media instead of play it. default: false required: false media_info: type: map description: Additional MediaInformation attributes not explicitly listed. required: false metadata: type: map description: "Media metadata object, one of the following: GenericMediaMetadata, MovieMediaMetadata, TvShowMediaMetadata, MusicTrackMediaMetadata, PhotoMediaMetadata." required: false {% endconfiguration %}

Documentation:

• Google Dev Documentation MediaData
• Google Dev Documentation MediaInformation

Example of calling media_player service with title and image set:

service: media_player.play_media
target:
  entity_id: media_player.chromecast
data:
  media_content_type: music
  media_content_id: "https://fake-home-assistant.io.stream/aac"
  extra:
    thumb: "https://brands.home-assistant.io/_/homeassistant/logo.png"
    title: HomeAssistantRadio

Service media_player.select_source

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. To target all media players, use all.
source	no	Name of the source to switch to. Platform dependent.

Service media_player.select_sound_mode

Currently only supported on Denon AVR and Songpal.

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. For example media_player.marantz
sound_mode	no	Name of the sound mode to switch to. Platform dependent.

Service media_player.shuffle_set

Currently only supported on Sonos, Spotify, MPD, Kodi, Roon, OwnTone, Squeezebox and Universal.

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. For example media_player.spotify
shuffle	no	true/false for enabling/disabling shuffle

Service media_player.repeat_set

Service data attribute	Optional	Description
entity_id	yes	Target a specific media player. For example media_player.kitchen
repeat	no	off/all/one for setting repeat mode

Service media_player.join

Allows to group media players together for synchronous playback. Only works on supported multiroom audio systems.

Service data attribute	Optional	Description
entity_id	yes	The media player entity whose playback will be expanded to the players specified in group_members.
group_members	no	The player entities which will be synced with the playback from entity_id.

Service media_player.unjoin

Service data attribute	Optional	Description
entity_id	yes	Unjoin this media player from any player groups.

Device Class

The way media players are displayed in the frontend can be modified in the customize section. The following device classes are supported for media players:

• tv: Device is a television type device.
• speaker: Device is speaker or stereo type device.
• receiver: Device is audio video receiver type device taking audio and outputting to speakers and video to some display.