alexei.dolgolyov/haos-hacs-integration-media-player

Files

alexei.dolgolyov e66f2f3b36 Add turn_on/turn_off/toggle support

- Add API_TURN_ON, API_TURN_OFF, API_TOGGLE constants
- Add turn_on(), turn_off(), toggle() methods to MediaServerClient
- Implement async_turn_on, async_turn_off, async_toggle in media player
- Add TURN_ON and TURN_OFF to supported features
- Update README with turn on/off/toggle documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-05 03:44:25 +03:00

4.0 KiB

Raw Permalink Blame History

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)
Turn on/off/toggle support - Execute custom actions (e.g., lock screen on turn off)
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_player folder to your Home Assistant config/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
Turn on/off/toggle actions (execute server-side callbacks)

Turn On/Off/Toggle

The media player supports media_player.turn_on, media_player.turn_off, and media_player.toggle actions. These execute optional callbacks configured on the Media Server (e.g., lock screen on turn off).

Configure callbacks in Media Server's config.yaml:

callbacks:
  on_turn_on:
    command: "echo PC turned on"
    timeout: 10
    shell: true

  on_turn_off:
    command: "rundll32.exe user32.dll,LockWorkStation"
    timeout: 5
    shell: true

  on_toggle:
    command: "echo Toggle triggered"
    timeout: 10
    shell: true

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

4.0 KiB Raw Permalink Blame History