MediaPlayer Usage and Examples


Refer to the integration's installation and configuration pages on the left.


You can add the mediaplayer to your dashboard by using a Media Control Card, and selecting your entity (for the above example, media_player.hass_agent_test_mediaplayer).

It'll show up as follows:


Media Control

The entity allows you to control your PC as if it were a regular media player, regardless of what application is actually playing.

For the 'what's playing' functionality, the playing application needs to use Windows' media API. An example application that does this, is Spotify. An example application that doesn't do this, is VLC.

If your application supports it, your current playing media will show up in Home Assistant:



By using this integration, you can use your PC as a text-to-speech target. You can easily test the functionality by using the developer tools in Home Assistant:


Or through YAML:

service: tts.google_translate_say
  entity_id: media_player.hass_agent_test_mediaplayer
  message: this is a test message

Replace google_translate_say if you're using any other TTS service.


Some extra info:

  • Besides TTS, you can play any .mp3 file on HASS.Agent directly
  • This file can be online (http(s)) or local (C:\path\to\file.mp3)
  • The media_content_type must be music
  • Currently running audio will be aborted when a new file is received

YAML to play a .mp3 file on the agent:

service: media_player.play_media
  # Hosted on Home Assistant (/config/www folder)
  media_content_id: media-source://media_source/local/Alarm1.mp3
  # Or streamed from another server
  # media_content_id:
  media_content_type: music
  entity_id: media_player.hass_agent_test_mediaplayer

If you're not getting your current-song information from Spotify, make sure this setting is enabled: