Watching now

Version 1.1.3 · plug-in API >=1.14 <2.0

PublishedHow to add it
On this page

Watching now: For developers

How Watching now is built, for anyone who wants to change it or make one like it. It is MIT, by TheMightyTRexUK, and works with plug-in API >=1.14 <2.0.

Its files

Containers

Container Network Folders Runs as Starts Limits
main lan None 10001:10001 always 48 MB, 0.1 core

Each image is pinned by digest in the manifest:

  • main: ghcr.io/themightytrex/starboard-plugin-examples@sha256:83b980f1828cdee537bcdf03702ddf6458710cba53f9009938225df430d34d9e

What Starboard calls

Path What it is
GET /health Health: 200 while it can work
GET /card The Watching now card (list)

How it works

  • Each time the card is asked, app.py asks Jellyfin for /Sessions?ActiveWithinSeconds=120 through jellyfin() in sbplugin.py, and lists each session that has something playing. It keeps nothing, so it needs no folder.
  • The card's status comes from band(): running with how many are watching, or idle when nobody is.
  • Without a Jellyfin key, jellyfin() raises "Starboard has no Jellyfin key to give yet: add Jellyfin in Settings, Apps", and the card answers 502 with that message.

Find out more

This page on GitHub, where the help is written.