b13aa865948ac30e469587241e34cd56db370b3b
Remote Media Player - Home Assistant Integration
A Home Assistant custom integration that allows you to control a remote PC's media playback as a media player entity.
Features
- Full media player controls (play, pause, stop, next, previous)
- Volume control and mute
- Seek support with smooth timeline updates
- Displays current track info (title, artist, album, artwork)
- Real-time updates via WebSocket (with HTTP polling fallback)
- Script buttons - Execute pre-defined scripts (shutdown, restart, lock, sleep, etc.)
- Configurable via Home Assistant UI
Requirements
- Home Assistant 2024.1.0 or newer
- A running Media Server on your PC
Media Server
This integration requires the Media Server to be running on the PC you want to control.
Media Server Repository: media-player-server
See the Media Server documentation for installation and setup instructions.
Installation
HACS (Recommended)
- Open HACS in Home Assistant
- Click the three dots menu > Custom repositories
- Add this repository URL:
https://git.dolgolyov-family.by/alexei.dolgolyov/haos-hacs-integration-media-player - Select category: Integration
- Click Add
- Search for "Remote Media Player" and click Download
- Restart Home Assistant
Manual Installation
- Download the latest release from the Releases page
- Extract and copy the
custom_components/remote_media_playerfolder to your Home Assistantconfig/custom_components/directory - Restart Home Assistant
Configuration
- Go to Settings > Devices & Services
- Click + Add Integration
- Search for "Remote Media Player"
- Enter the connection details:
- Host: IP address or hostname of your PC running Media Server
- Port: Server port (default: 8765)
- API Token: The authentication token from your Media Server
- Name: Display name for this media player (optional)
Usage
Once configured, the integration creates:
Media Player Entity
A full-featured media player entity with:
- Play/Pause/Stop controls
- Next/Previous track
- Volume control and mute
- Seek functionality
- Current track information
Script Button Entities
Button entities for each script defined on your Media Server:
- Lock/unlock workstation
- Shutdown, restart, sleep, hibernate
- Custom scripts
Example Lovelace Card
type: media-control
entity: media_player.remote_media_player
Documentation
For detailed documentation, see custom_components/remote_media_player/README.md.
Support
License
MIT License
Description
Languages
Python
100%