Skip to main content
Version: 9.8 (latest)

Plex Now Playing

Show what's playing on your Plex Media Server: movies, TV episodes, and music, laid out to fit any board.

Overview​

The Plex plugin shows:

  • The movie, TV episode, or track that is playing
  • Show name, season and episode, or artist and album
  • Playback state: playing, paused, or buffering
  • Who is watching, on which device, and how much time is left

It lays the title out to fit your board. A long title wraps onto a second line and the rest of the layout moves down to make room. The same page works on a Note, a Flagship, or a Note Array.

Setup​

1. Find Your Plex Token​

  1. Open Plex Web and sign in with an account on your server
  2. Open any movie or episode in your library
  3. Click the ⋯ menu, choose Get Info, then View XML
  4. Copy the value after X-Plex-Token= at the end of the new tab's address

Treat the token like a password: it grants access to your Plex account.

2. Enable in the Web UI​

  1. Open http://localhost:4420
  2. Go to the Integrations page
  3. Toggle Plex Now Playing on
  4. Enter your Plex Server URL (for example http://192.168.1.100:32400) and paste your Plex Token
  5. Optionally, set Plex User to show only one person's streams
  6. Click Save Changes

If FiestaBoard runs in Docker, use your Plex server's LAN IP address, not localhost.

Display Lines​

line_1, line_2, and line_3 hold a ready-made layout for the board being rendered. Center them for the classic look:

{{plex.line_1}}
{{plex.line_2}}
{{plex.line_3}}
PlayingTitle fits one lineTitle needs two lines
Movietitle / blank / yeartitle / title / year
TV episodeshow / season+episode / episode titleshow / show / season+episode
Musictrack / artist / albumtrack / track / artist
Nothingblank / Nothing playing / blank

A third line that doesn't fit the board ends in .... With Plex yellow accents on, the year or season/episode line is framed by two yellow tiles on each side.

Available Variables​

VariableDescriptionExample
{{plex.line_1}}First display lineBREAKING BAD
{{plex.line_2}}Second display lineS05 E14
{{plex.line_3}}Third display lineOZYMANDIAS
{{plex.title}}Movie, episode, or track titleOZYMANDIAS
{{plex.year}}Release year2013
{{plex.show}}TV show nameBREAKING BAD
{{plex.season_episode}}Season and episodeS05 E14
{{plex.artist}}Artist (music)DAFT PUNK
{{plex.album}}Album (music)DISCOVERY
{{plex.media_type}}Movie, Episode, Track, or ClipEPISODE
{{plex.state}}Playing, Paused, Buffering, or Idle, color-codedPLAYING
{{plex.is_playing}}Whether something is playingtrue
{{plex.user}}Plex user watching or listeningALEX
{{plex.player}}Device playing the streamLIVING ROOM TV
{{plex.progress_percent}}Progress through the item (0-100)64
{{plex.minutes_left}}Minutes remaining18
{{plex.stream_count}}Number of active streams2

When several people are streaming, the plugin features whichever stream is playing, ahead of buffering or paused ones. Every stream is also available as {{plex.sessions.0.title}}, {{plex.sessions.1.title}}, and so on, with the same fields.

Next Steps​