You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Go to file
Juraj Nyíri 74fe0bae96
Add: List support for kodi
4 years ago
.vscode Update: WIP Typescript refactor 4 years ago
dist Add: List support for kodi 4 years ago
images Add: Plex cast image 4 years ago
src Add: List support for kodi 4 years ago
.eslintignore Update: WIP Typescript refactor 4 years ago
.eslintrc Update: Full functionality with typescript 4 years ago
.gitignore no message 4 years ago
.prettierignore Update: WIP Typescript refactor 4 years ago
.prettierrc Update: WIP Typescript refactor 4 years ago
LICENSE Initial commit 4 years ago
README.md Update: Readme no longer needs custom repo 4 years ago
hacs.json Revert 4 years ago
package-lock.json no message 4 years ago
package.json Update: Move css styles outside of main card 4 years ago
rollup.config.js no message 4 years ago
tsconfig.json Update: WIP Typescript refactor 4 years ago

README.md

PlexMeetsHomeAssistant

Custom Home Assistant card which integrates plex into Home Assistant and makes it possible to launch movies or tv shows on TV with a simple click.

Supported are ALL Plex clients, some even with enhanced functionality. Kodi with PlexKodiConnect is also supported.

Video of the card:

Youtube video

More images at the end of the readme.

Installation

  • Install Plex Meets Home Assistant from HACS.
  • Reload browser, clear cache as usual
  • Create a new Home Assistant tab, turn on panel mode
  • Add a new card, see configuration below.

Configuration

type: 'custom:plex-meets-homeassistant'

token: Enter your Plex Token

ip: Enter ip address of plex server. You can also enter hostname without protocol or port.

port: Enter port of your plex sever.

protocol: Optional Protocol to use for Plex. Defaults to "http".

maxCount: Optional Maximum number of items to display in card.

sort: Optional Define sort by. See detailed instructions

entity: You need to configure at least one supported media_player entity.

Example of card configuration:

type: 'custom:plex-meets-homeassistant'
token: QWdsqEXAMPLETOKENqwerty
ip: 192.168.13.37
port: 32400
libraryName: Movies
protocol: http
maxCount: 10
entity:
  kodi: media_player.kodi_123456qwe789rty
  androidtv: media_player.living_room_nvidia_shield
  plexPlayer: 192.168.13.38

If you are using Home Assistant via HTTPS, you need to specify port https for Plex and have Plex available on https connection.

Detailed configuration instructions for end devices

You can combine multiple supported entities, in that case, entity for supported content will be chosen in order how you entered them.

As an example, if content can be played / shown both by kodi and androidtv, and you entered kodi first, it will be shown by kodi. If it cannot be played by kodi but can be played by androidtv, androidtv will be used.

This will also work with play button being shown, it will only show when you can actually play content on your device.

Play button is only visible if all the conditions inside Availability section of end devices below are met.

Android TV or Fire TV

Difficulty to setup: Easy

Steps:

  • Install plex application on your Android TV device. Open it and do the default setup so that you can see and navigate your libraries.
  • Setup Android TV. You need just a default configuration, no optional parameters needed.
  • Use entity_id of media_player provided by Android TV integration in card, example: androidtv: media_player.living_room_nvidia_shield.

Availability:

  • Provided entity ID needs to exists
  • Provided entity ID needs to have attributes
  • Provided entity ID needs to have attribute adb_response

Supported play types:

Movies

Show

Season

Episodes

Kodi

Difficulty to setup: Moderate

Steps:

Images of installation of Kodi Recently Added Media

Click on add integration in integrations

Find integration Kodi Media Sensors

Configure integration Kodi Media Sensors

  • Use entity_id of media_player provided by Kodi integration in card, example: media_player.kodi_123456qwe789rty.

Availability:

  • Provided entity ID needs to exists
  • Entity 'sensor.kodi_media_sensor_search' needs to exist
  • State of both entities cannot be 'unavailable'
  • State of kodi cannot be 'off'

Supported play types:

Movies

Show

Season

Episodes

All other plex clients

Difficulty to setup: Very Easy to Moderate

Steps:

Easy setup:

Notice: While easy, it might not work if you have multiple devices with the same name, or you buy a second device with the same name in the future. Some plex clients also incorrectly report theirs IP Address, so addition by that might not be working. Take a look at Machine ID setup below if this is a concern for you.

  • Open Plex app on the device you wish to add
  • Open your Plex web GUI
  • Click on cast on the top right corner and note down name of your device

Plex cast

  • Add it to card, example:
entity:
  plexPlayer: TV 2020

Instead of device name, you can also enter device IP address or product name.

  • Save card configuration, if you see play buttons everywhere configuration was successful.

If you do not see play button, or have multiple devices with the same name, follow Machine ID setup below.

Machine ID setup:

  • Open Plex app on the device you wish to add
  • Open your Plex web GUI
  • Modify URL so that just after the port, just after the first slash, you enter clients?X-Plex-Token=PLEX_TOKEN. Replace PLEX_TOKEN with your plex token. Example final URL http://192.168.13.37:32400/clients?X-Plex-Token=qweRTY123456.
  • You will get a list of all currently connected Plex clients.
  • Find the client you wish to add, and copy machineIdentifier key without quotes.
  • Add machineIdentifier into card, for example:
entity:
  plexPlayer: mYaweS0meMacHin3Id3ntiFI3r
  • Save card configuration, if you see play buttons everywhere configuration was successful.

Availability:

  • Plex needs to run on the defined device

Supported play types:

Movies

Show

Season

Episodes

Sorting

You can use :desc or :asc after every value to change the order from ascending to descending. For example, titlesort would become titleSort:asc, or titleSort:desc.

TV Shows

Sort Value Description
titleSort Sorts by title, removing words like "the"
title Sorts by title, without removing words like "the"
year Sorts by year
originallyAvailableAt Sorts by release date
rating Sorts by critic rating
audienceRating Sorts by audience rating
userRating Sorts by user rating
contentRating Sorts by content rating
unviewedLeafCount Sorts by unplayed count
episode.addedAt Sorts by last episode date added
addedAt Sorts by date added
lastViewedAt Sorts by date viewed

Movies

Sort Value Description
titleSort Sorts by title, removing words like "the"
title Sorts by title, without removing words like "the"
originallyAvailableAt Sorts by release date
rating Sorts by critic rating
audienceRating Sorts by audience rating
userRating Sorts by user rating
duration Sorts by duration
viewOffset Sorts by progress
viewCount Sorts by plays
addedAt Sorts by date added
lastViewedAt Sorts by date viewed
mediaHeight Sorts by resolution
mediaBitrate Sorts by bitrate

Ask for help or help development

Join Discord or Home Assistant Community.

Images

View without hover

View with hover

Expanded movie view

Disclaimer

Author is in no way affiliated with Kodi, Plex, Roku, Android TV, Google or any other companies mentioned above.

Author does not guarantee functionality of this card and is not responsible for any damage.

All product names, trademarks and registered trademarks in this repository, are property of their respective owners.

This card provides user interface for navigating plex library and playing plex content on users devices. It does not host any content on its own and does not provide any plex server.