Skip to content

v0.1.0 - Initial Release

Choose a tag to compare

@troykelly troykelly released this 26 Nov 07:54

πŸŽ‰ Emby Media Integration v0.1.0

First stable release of the Home Assistant Emby Media integration.

✨ Highlights

  • Full Media Player Control - Play, pause, stop, seek, volume control for all Emby clients
  • Real-time Updates - WebSocket connection for instant state synchronization
  • Complete Media Browsing - Navigate your entire Emby library from Home Assistant
  • Voice Assistant Ready - Search media with Assist/Alexa/Google Home
  • Multiple Entity Types - Media player, remote, notify, and button entities
  • Automation Triggers - React to playback events in your automations

πŸ“¦ Installation

HACS (Recommended)

  1. Add this repository to HACS as a custom repository
  2. Search for "Emby Media" and install
  3. Restart Home Assistant
  4. Add integration via Settings β†’ Devices & Services

Manual

  1. Download embymedia.zip from this release
  2. Extract to custom_components/embymedia/
  3. Restart Home Assistant

🎬 Features

Media Player Entities

  • Full playback control (play, pause, stop, next, previous, seek)
  • Volume control and mute
  • Media browsing with artwork
  • Now playing information with progress

Media Browsing

  • Movies (A-Z, by year, decade, genre, collections)
  • TV Shows (seasons, episodes, by year, genre)
  • Music (artists, albums, genres, playlists)
  • Live TV channels
  • Playlists and collections

Additional Entities

  • Remote - Navigation commands (up, down, left, right, select, back, home)
  • Notify - Send on-screen messages to clients
  • Button - Server actions (refresh library)

Services

  • embymedia.send_message - Display notifications on clients
  • embymedia.send_command - Send navigation commands
  • embymedia.mark_played / mark_unplayed - Manage watch status
  • embymedia.add_favorite / remove_favorite - Manage favorites
  • embymedia.refresh_library - Trigger library scan

Options

  • Configurable scan interval (5-300 seconds)
  • WebSocket enable/disable
  • Device filtering
  • Transcoding options (direct play, container, bitrate)
  • Entity name prefix toggles ("Emby" prefix per entity type)

πŸ“‹ Requirements

  • Home Assistant 2025.11.3 or newer
  • Emby Server with API access
  • API key with appropriate permissions

πŸ“– Documentation

See the README for complete documentation.

πŸ”§ Technical Details

  • Python 3.13+ support
  • 100% test coverage with 815+ tests
  • Strict type checking with mypy
  • WebSocket with exponential backoff reconnection

Full Changelog: https://github.com/troykelly/homeassistant-emby/blob/main/CHANGELOG.md