homebridge-plex-intermission 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [1.0.1] - 2026-10-23
+
+### Fixed
+
+- Players added later with *Change servers, players and libraries* now reach the sensors. Sensors that watched exactly
+  the old choices of players, people or libraries follow the new ones; filters set by hand stay as they are.
+- Sensors saved before this fix that leave out a player chosen in setup get a notice on the Sensors tab, with *Add to
+  the sensor* or *Leave as is*.
+
+### Changed
+
+- Players with the same name, such as Plex and Infuse on one Apple TV, are shown with their app (or the start of their
+  ID) in sensor summaries, filters, the diagnostics file and the log.
+- Saved players take Plex's current name and app when setup runs again.
+- Diagnostics: the log is newest first, and *Watch live* shows the log as it happens, in local time and with names,
+  without downloading anything.
+
 ## [1.0.0] - 2026-10-23
 
 First public release.
@@ -55,5 +72,6 @@ First public release.
   Home app.
 - Lost connections to Plex are retried with their reasons logged, with a warning if Plex stays unreachable.
 
-[Unreleased]: https://github.com/maxrogers/homebridge-plex-intermission/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/maxrogers/homebridge-plex-intermission/compare/v1.0.1...HEAD
+[1.0.1]: https://github.com/maxrogers/homebridge-plex-intermission/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/maxrogers/homebridge-plex-intermission/releases/tag/v1.0.0

package/README.md

@@ -33,7 +33,7 @@ Intermission never controls your lights; you choose what happens in the Home app
   ratings or Plex labels.
 - **A Guide** in the settings page with the Home automations for your preset, including gentle fades, with screenshots.
 - **Diagnostics** in one file for bug reports, never with your Plex sign-in, and without titles or names unless you
-  include them.
+  include them. **Watch live** shows the log as it happens, right in the settings page.
 
 ## Presets
 
@@ -92,7 +92,8 @@ Intermission talks only to plex.tv and your Plex servers, with no analytics. See
 
 - **Something didn't happen when it should have:** in the plugin's settings, open **Settings**, then **Diagnostics**,
   and download the diagnostics file soon afterwards. It includes Intermission's recent log, so you don't need to turn on
-  extra logging first. It leaves out your Plex sign-in, and titles and names unless you include them.
+  extra logging first. It leaves out your Plex sign-in, and titles and names unless you include them. To see what
+  Intermission makes of something as you do it, press **Watch live** there instead.
 - **Webhooks:** **Settings**, then **Plex Pass and webhooks**, shows whether Plex has the webhook, whether your server's
   Webhooks setting is on, and whether Intermission is listening on its port.
 - **Sensors not in the Home app:** with the child bridge, add Intermission in the Home app with the code on the Sensors

package/dist/controller.js

@@ -246,7 +246,7 @@ export class Controller {
             if (config.type === 'button' || (mediaOnly && !hasMediaConditions(config.media))) {
                 continue;
             }
-            const reason = filterMismatch(config.filters, context, { player: session.playerTitle, library: session.media.librarySectionTitle })
+            const reason = filterMismatch(config.filters, context, { player: session.playerTitle, product: session.product, library: session.media.librarySectionTitle })
                 ?? (hasMediaConditions(config.media) ? mediaMismatch(config.media, this.factsFor(session.media)) : undefined);
             this.options.log.debug('  %s: %s', config.name, reason ? `ignores this playback: ${reason}` : 'follows this playback');
         }

package/dist/diagnostics.js

@@ -1,4 +1,4 @@
-import { appendFile, mkdir, readFile, rename, stat } from 'node:fs/promises';
+import { appendFile, mkdir, open, readFile, rename, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 /*
  * Private values (titles, people, players, command lines) are wrapped in invisible markers when
@@ -147,3 +147,29 @@ export async function readDiagnostics(directory, maxLines = 6_000) {
     const lines = [...await read(PREVIOUS_FILE), ...await read(DIAGNOSTICS_FILE)];
     return lines.slice(-maxLines);
 }
+/** The last `maxLines` lines of the kept log, oldest first, reading only the end of the files. */
+export async function tailDiagnostics(directory, maxLines = 200, maxBytes = 64_000) {
+    const tail = async (name, bytes) => {
+        const file = await open(join(directory, name), 'r').catch(() => undefined);
+        if (!file) {
+            return [];
+        }
+        try {
+            const { size } = await file.stat();
+            const length = Math.min(size, bytes);
+            const buffer = Buffer.alloc(length);
+            await file.read(buffer, 0, length, size - length);
+            const lines = buffer.toString('utf8').split('\n').filter(Boolean);
+            // The first line is likely cut part way unless the whole file was read.
+            return length < size ? lines.slice(1) : lines;
+        }
+        finally {
+            await file.close();
+        }
+    };
+    let lines = await tail(DIAGNOSTICS_FILE, maxBytes);
+    if (lines.length < maxLines) {
+        lines = [...await tail(PREVIOUS_FILE, maxBytes), ...lines];
+    }
+    return lines.slice(-maxLines);
+}

package/dist/report.js

@@ -1,5 +1,5 @@
 import { readFile } from 'node:fs/promises';
-import { commandLine, person, player, readDiagnostics, redact, scrubSecrets } from './diagnostics.js';
+import { commandLine, person, player, readDiagnostics, redact, scrubSecrets, tailDiagnostics } from './diagnostics.js';
 import { hidePublicAddresses, maskAddress } from './network.js';
 import { webhookOptionsFrom } from './setup-service.js';
 const PORT_STATES = {
@@ -91,7 +91,13 @@ export async function setupReport(service, input) {
 export async function diagnosticsReport(service, input, now) {
     const config = input.config;
     const selection = (config.selection ?? {});
-    const playerNames = new Map((selection.players ?? []).map((p) => [p.id, p.name ?? p.id]));
+    const players = new Map((selection.players ?? []).map((p) => [p.id, p]));
+    // The app and the start of the ID tell apart players with the same name.
+    const describePlayer = (id) => {
+        const found = players.get(id);
+        const tell = [found?.product, id.slice(0, 8)].filter(Boolean).join(', ');
+        return found?.name ? `${player(found.name)} (${tell})` : id;
+    };
     const libraryNames = new Map((selection.libraries ?? []).map((l) => [l.key, l.title ?? l.key]));
     const commands = new Map((config.commands?.list ?? []).map((c) => [c.id, c]));
     const list = (values, name, all) => {
@@ -114,7 +120,7 @@ export async function diagnosticsReport(service, input, now) {
         lines.push(sensor.type === 'button'
             ? `  pressed on: ${list(sensor.events, (e) => e, 'nothing')}`
             : `  on while: ${String(sensor.state)}${Array.isArray(sensor.except) && sensor.except.length ? `, except ${sensor.except.join(' and ')}` : ''}`);
-        lines.push(`  players: ${list(f.players, (id) => player(playerNames.get(id) ?? id), 'all')}`);
+        lines.push(`  players: ${list(f.players, describePlayer, 'all')}`);
         lines.push(`  people: ${list(f.users, (u) => person(u), 'all')}`);
         lines.push(`  libraries: ${list(f.libraries, (k) => libraryNames.get(k) ?? k, 'all')}`);
         if (sensor.media && Object.keys(sensor.media).length) {
@@ -130,10 +136,24 @@ export async function diagnosticsReport(service, input, now) {
             lines.push(`${command.name ?? '?'}: ${commandLine(command.command ?? '')}`);
         }
     }
-    const log = await readDiagnostics(service.storage.directory);
-    lines.push('', `== Recent log (${log.length} lines, oldest first, detailed) ==`, ...(log.length ? log : ['Nothing logged yet. Restart Homebridge once, so Intermission starts keeping its log.']));
+    const log = (await readDiagnostics(service.storage.directory)).reverse();
+    lines.push('', `== Recent log (${log.length} lines, newest first, detailed) ==`, ...(log.length ? log : [NOTHING_LOGGED]));
+    return hidePublicAddresses(scrubSecrets(redact(lines.join('\n'), input.includeNames === true), await secretsOf(service)));
+}
+const NOTHING_LOGGED = 'Nothing logged yet. Restart Homebridge once, so Intermission starts keeping its log.';
+/**
+ * The newest lines of the kept log, newest first, for watching on the settings page. Shown only on
+ * this machine, so names are kept; secrets are still removed.
+ */
+export async function liveLog(service, maxLines = 200) {
+    const log = (await tailDiagnostics(service.storage.directory, maxLines)).reverse();
+    if (log.length === 0) {
+        return [NOTHING_LOGGED];
+    }
+    return scrubSecrets(redact(log.join('\n'), true), await secretsOf(service)).split('\n');
+}
+async function secretsOf(service) {
     const credentials = await service.storage.readCredentials();
     const { webhookSecret } = await service.storage.state();
-    const secrets = [webhookSecret, credentials?.accountToken, ...Object.values(credentials?.serverTokens ?? {})].filter((s) => Boolean(s));
-    return hidePublicAddresses(scrubSecrets(redact(lines.join('\n'), input.includeNames === true), secrets));
+    return [webhookSecret, credentials?.accountToken, ...Object.values(credentials?.serverTokens ?? {})].filter((s) => Boolean(s));
 }

package/dist/sensors/rules.js

@@ -76,7 +76,9 @@ export function mediaMatches(conditions, facts) {
 /** Why a filter leaves out this playback, or undefined when it allows it. For detailed logging. */
 export function filterMismatch(filters, context, names = {}) {
     if (filters.players.length > 0 && (context.playerId === undefined || !filters.players.includes(context.playerId))) {
-        return `player ${playerName(names.player ?? context.playerId ?? 'unknown')} is not chosen`;
+        // The app or ID tells apart players with the same name, such as two apps on one Apple TV.
+        const tell = names.product ?? context.playerId?.slice(0, 8);
+        return `player ${playerName(names.player ?? context.playerId ?? 'unknown')}${names.player && tell ? ` (${tell})` : ''} is not chosen`;
     }
     if (filters.users.length > 0 && (context.user === undefined || !filters.users.includes(context.user))) {
         return `${context.user === undefined ? 'the person is unknown' : `${person(context.user)} is not chosen`}`;

package/homebridge-ui/public/app.css

@@ -162,6 +162,7 @@
 .im .im-field small { display: block; margin-top: 0.1rem; }
 .im .im-field:last-child { border-bottom: 0; }
 .im .im-report { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.8rem; white-space: pre; }
+.im .im-live-log { height: 24rem; overflow: auto; }
 
 .im .im-recipe ol { padding-left: 1.2rem; }
 .im .im-recipe li { margin-bottom: 0.3rem; }

package/homebridge-ui/public/app.js

@@ -4,7 +4,7 @@ import {
   CONDITIONS, DEFAULT_WEBHOOK_PORT, EVENTS, EXCEPTIONS, CAN_EXCEPT, CREDITS_MODES, LIBRARY_KINDS, PLATFORM, PRESETS, DEFAULT_PRESET, SENSOR_TYPES, TIMING_FIELDS,
   SHAPES, RESOLUTIONS, DYNAMIC_RANGES, RATINGS,
   applyPreset, defaultSelection, creditsMode, describeFacts, groupIntact, groupPreset, hasMediaConditions, homeKitName, libraryRef, needsPlexPass, presetSensors, sensorId, usesCredits,
-  reconcileSelection, reconcileSensors, newChildBridge, newSensor, playerRef, setTiming, summarize, timingValue,
+  reconcileSelection, reconcileSensors, followSelection, missingSetupPlayers, playerLabel, newChildBridge, newSensor, playerRef, setTiming, summarize, timingValue,
 } from './model.js';
 
 const root = document.getElementById('intermission');
@@ -348,9 +348,14 @@ async function loadDiscovery(next, { keepSelection = false } = {}) {
 }
 
 async function finishSetup() {
+  // Sensors that watched exactly the old choices follow the new ones.
+  const followed = followSelection(state.config.sensors, state.config.selection, state.selection);
+  state.config.sensors = followed.sensors;
   if (state.setupServers) {
     if (state.config.sensors.length > 0) {
-      state.config.sensors = reconcileSensors(state.config.sensors, state.discovery, savedServerIds(), state.config.selection?.libraries ?? []);
+      const others = state.config.sensors.filter((s) => !followed.followedLibraries.has(s.id));
+      const reconciled = reconcileSensors(others, state.discovery, savedServerIds(), state.config.selection?.libraries ?? []);
+      state.config.sensors = state.config.sensors.map((s) => reconciled.find((r) => r.id === s.id) ?? s);
     }
     state.config.servers = state.setupServers;
     state.setupServers = undefined;
@@ -412,6 +417,7 @@ function render() {
     root.innerHTML = `<div class="im-alert im-alert-danger">Something went wrong showing this page: ${escape(error.message)}</div>
       <button class="btn btn-outline-secondary" data-action="reload">Reload</button>${footer()}`;
   }
+  showLiveLog();
   homebridge.fixScrollHeight?.();
 }
 
@@ -668,7 +674,7 @@ function sensorsTab() {
       ${members.map(([s, i]) => sensorCard(s, i, sel)).join('')}
     </div>`);
   });
-  return `${pairingCard()}${webhookNotice()}
+  return `${pairingCard()}${webhookNotice()}${missingPlayersNotice()}
     ${parts.join('') || '<p class="im-muted">No sensors yet. Add a preset, or a sensor of your own.</p>'}
     <div class="d-flex flex-wrap gap-2 mt-2">
       <button class="btn btn-im" data-action="add" data-type="occupancy">Add sensor</button>
@@ -679,6 +685,25 @@ function sensorsTab() {
     <p class="im-muted small mt-3">Drag cards to reorder. Changes apply after you press Save and restart Homebridge. Renaming keeps your Home automations.</p>`;
 }
 
+/** Offers to add players chosen in setup that sensors leave out, such as a second app on the same Apple TV. */
+function missingPlayersNotice() {
+  const sel = selection();
+  const { players, sensorIds } = missingSetupPlayers(state.config.sensors, sel);
+  if (players.length === 0) {
+    return '';
+  }
+  const names = players.map((p) => playerLabel(p, sel.players)).join(', ');
+  const count = sensorIds.length;
+  return `<div class="im-card im-banner mb-3" id="im-missing-players">
+    <strong>${players.length === 1 ? 'A player you chose is' : 'Players you chose are'} not on ${count === 1 ? '1 sensor' : `${count} sensors`}</strong>
+    <p class="small mb-2 mt-1">${escape(names)} ${players.length === 1 ? 'was' : 'were'} chosen in setup, but ${count === 1 ? 'a sensor only watches' : 'these sensors only watch'} the other players, so playback there is ignored.</p>
+    <div class="d-flex flex-wrap gap-2">
+      <button class="btn btn-sm btn-im" data-action="add-missing-players">Add to ${count === 1 ? 'the sensor' : 'them'}</button>
+      <button class="btn btn-sm btn-outline-secondary" data-action="dismiss-missing-players">Leave as is</button>
+    </div>
+  </div>`;
+}
+
 /** The preset list, and the "Add alongside / Replace" choice when sensors already exist. */
 function presetPanel() {
   const count = state.config.sensors.length;
@@ -750,7 +775,7 @@ function editor(sensor, sel) {
         (e) => `${EVENTS[e].label}${EVENTS[e].plexPass ? ' ★' : ''}`, (e) => noPass && EVENTS[e].plexPass)}</div>
         <div class="im-hint">★ needs Plex Pass</div>`}
     <label class="im-label">Players</label>
-    ${filter('players', players, (p) => p.name, 'All players')}
+    ${filter('players', players, (p) => playerLabel(p, players), 'All players')}
     <label class="im-label">People</label>
     ${filter('users', users, (u) => u, 'All Plex Home users')}
     <label class="im-label">Libraries</label>
@@ -1012,7 +1037,7 @@ function advancedTab() {
       <strong>Your setup</strong>
       <dl class="im-facts">
         <dt>Plex servers</dt><dd>${escape(servers().map((s) => s.name).join(', ') || 'None')}</dd>
-        <dt>Players</dt><dd>${escape(sel.allPlayers ? 'All players' : sel.players.map((p) => p.name).join(', ') || 'None')}</dd>
+        <dt>Players</dt><dd>${escape(sel.allPlayers ? 'All players' : sel.players.map((p) => playerLabel(p, sel.players)).join(', ') || 'None')}</dd>
         <dt>People</dt><dd>${escape(sel.allUsers === false ? sel.users.join(', ') : 'All Plex Home users')}</dd>
         <dt>Libraries</dt><dd>${escape(libraryNames)}</dd>
         <dt>Bridge</dt><dd>${state.config._bridge ? `Intermission's own bridge${state.pairing?.paired ? ', in the Home app' : ''}` : 'Main Homebridge bridge'}</dd>
@@ -1067,7 +1092,7 @@ function advancedTab() {
     ${collapsible('advanced', 'Advanced', 'Timing, logging and commands. These rarely need changing.', `
       ${fields}
       <div class="im-field">
-        <label for="im-detailed"><strong>Detailed logging</strong><small>Shows every Plex report, event and decision in the Homebridge log, including why each sensor follows or ignores a playback. Diagnostics includes this detail either way, so you only need it to watch along live.</small></label>
+        <label for="im-detailed"><strong>Detailed logging</strong><small>Shows every Plex report, event and decision in the Homebridge log, including why each sensor follows or ignores a playback. Diagnostics and Watch live include this detail either way, so you only need it to see the detail in the Homebridge log.</small></label>
         <div class="form-check form-switch"><input id="im-detailed" class="form-check-input" type="checkbox" data-detailed ${state.config.detailedLogging ? 'checked' : ''}></div>
       </div>
       ${commandsSection()}`)}
@@ -1100,11 +1125,61 @@ function diagnosticsCard() {
         <button class="btn btn-sm btn-im" data-action="download-diagnostics">Download diagnostics</button>
         <button class="btn btn-sm btn-outline-secondary" data-action="copy-diagnostics">Copy</button>
         <button class="btn btn-sm btn-outline-secondary" data-action="show-diagnostics">${state.report ? 'Refresh' : 'Show'}</button>
+        <button class="btn btn-sm btn-outline-secondary" data-action="toggle-live" aria-pressed="${state.live ? 'true' : 'false'}">${state.live ? 'Stop watching' : 'Watch live'}</button>
       </div>
-      ${state.report ? `<textarea class="form-control im-report mt-2" readonly rows="16">${escape(state.report)}</textarea>` : ''}
+      ${state.live ? `<p class="im-hint mt-2 mb-1">The log as it happens, newest first, in your local time and with names, since only you see it here. Updates every 2 seconds.</p>
+        <pre class="form-control im-report im-live-log mb-0" id="im-live-log" tabindex="0"></pre>` : ''}
+      ${state.report && !state.live ? `<textarea class="form-control im-report mt-2" readonly rows="16">${escape(state.report)}</textarea>` : ''}
     </div>`;
 }
 
+/* ---------- watch live ---------- */
+
+/** Fills the live log after a render, which replaces the element. */
+function showLiveLog() {
+  const box = document.getElementById('im-live-log');
+  if (box && state.live) {
+    // Local time, since this is read as it happens; the file keeps UTC.
+    box.textContent = state.live.lines.map((line) => line.replace(/^\d{4}-\d\d-\d\dT[\d:.]+Z/, (iso) => new Date(iso).toLocaleTimeString())).join('\n');
+  }
+}
+
+function startLive() {
+  state.live = { lines: ['Loading…'], timer: undefined };
+  render();
+  void pollLive();
+}
+
+function stopLive() {
+  if (state.live) {
+    clearTimeout(state.live.timer);
+    state.live = undefined;
+  }
+}
+
+/** Reads the newest lines every 2 seconds while the live log is on screen. */
+async function pollLive() {
+  const live = state.live;
+  if (!live) {
+    return;
+  }
+  try {
+    live.lines = await request('/diagnostics/live', {});
+  } catch (error) {
+    live.lines = [`Could not read the log: ${error.message}`];
+  }
+  if (state.live !== live) {
+    return;
+  }
+  if (!document.getElementById('im-live-log')) {
+    // Another tab or view: stop until asked again.
+    stopLive();
+    return;
+  }
+  showLiveLog();
+  live.timer = setTimeout(() => void pollLive(), POLL_MS);
+}
+
 async function loadDiagnostics() {
   const includeNames = state.includeNames === true;
   state.report = await request('/diagnostics', { ...reportBody(), includeNames });
@@ -1369,6 +1444,20 @@ const actions = {
     return changed();
   }),
   'cancel-confirm': () => { state.confirming = undefined; render(); },
+  'add-missing-players': () => {
+    const sel = selection();
+    const { players, sensorIds } = missingSetupPlayers(state.config.sensors, sel);
+    state.config.sensors = state.config.sensors.map((s) => (sensorIds.includes(s.id)
+      ? { ...s, filters: { ...s.filters, players: [...new Set([...s.filters.players, ...players.map((p) => p.id)])] } }
+      : s));
+    return changed();
+  },
+  'dismiss-missing-players': () => {
+    const sel = selection();
+    const { players } = missingSetupPlayers(state.config.sensors, sel);
+    state.config.selection = { ...sel, dismissedPlayers: [...new Set([...(sel.dismissedPlayers ?? []), ...players.map((p) => p.id)])] };
+    return changed();
+  },
   'zoom-shot': (el) => {
     el.closest('.im-shot').classList.toggle('im-shot-zoom');
     homebridge.fixScrollHeight?.();
@@ -1490,7 +1579,18 @@ const actions = {
     state.webhookPlan = { add: false, remove: [] };
     homebridge.toast.success('The Intermission webhook was removed from your Plex account.', 'Plex webhooks');
   })),
-  'show-diagnostics': () => busy('Collecting diagnostics…', loadDiagnostics),
+  'show-diagnostics': () => {
+    stopLive();
+    return busy('Collecting diagnostics…', loadDiagnostics);
+  },
+  'toggle-live': () => {
+    if (state.live) {
+      stopLive();
+      render();
+    } else {
+      startLive();
+    }
+  },
   'copy-diagnostics': async () => {
     // Text already shown, and still for the same name setting, is copied inside the click.
     const fresh = state.report && state.reportNames === (state.includeNames === true);

package/homebridge-ui/public/model.js

@@ -337,15 +337,89 @@ function list(names, empty) {
   return names.length <= 2 ? names.join(' or ') : `${names.slice(0, 2).join(', ')} or ${names.length - 2} more`;
 }
 
+/** A product name without the "Plex for" prefix, for example "Apple TV" or "Infuse". */
+const shortProduct = (product) => (product ? product.replace(/^Plex (for|Media Player for) /i, '') : undefined);
+
+/**
+ * A player's name, with its app or the start of its ID added when another player in `players` has the
+ * same name (two apps on one Apple TV are both called "Apple TV").
+ */
+export function playerLabel(player, players = []) {
+  if (!player) {
+    return '';
+  }
+  const twins = players.filter((p) => p.id !== player.id && p.name === player.name);
+  if (twins.length === 0) {
+    return player.name;
+  }
+  const product = shortProduct(player.product);
+  const tell = product && product !== player.name && !twins.some((t) => shortProduct(t.product) === product) ? product : player.id.slice(0, 8);
+  return `${player.name} (${tell})`;
+}
+
+/**
+ * Brings sensors along when the setup choices change: a sensor whose players, people or libraries
+ * were exactly the old choices gets the new ones; filters set by hand stay as they are. Returns the
+ * sensors, and the IDs of those whose libraries followed.
+ */
+export function followSelection(sensors, before, after) {
+  if (!before) {
+    return { sensors, followedLibraries: new Set(), changed: 0 };
+  }
+  const was = filtersFrom(before);
+  const now = filtersFrom(after);
+  const same = (a = [], b = []) => a.length === b.length && a.every((v) => b.includes(v));
+  const followedLibraries = new Set();
+  let changed = 0;
+  const result = sensors.map((sensor) => {
+    const filters = { ...sensor.filters };
+    let touched = false;
+    for (const key of ['players', 'users', 'libraries']) {
+      if (same(filters[key], was[key]) && !same(was[key], now[key])) {
+        filters[key] = [...now[key]];
+        touched = true;
+        if (key === 'libraries') {
+          followedLibraries.add(sensor.id);
+        }
+      }
+    }
+    changed += touched ? 1 : 0;
+    return touched ? { ...sensor, filters } : sensor;
+  });
+  return { sensors: result, followedLibraries, changed };
+}
+
+/**
+ * Players chosen in setup that some sensors leave out, though those sensors otherwise watch only
+ * setup players (so they look like they were meant to follow setup). Players in `dismissedPlayers` are
+ * left out. Returns the players and sensor IDs.
+ */
+export function missingSetupPlayers(sensors, selection) {
+  const dismissed = selection?.dismissedPlayers ?? [];
+  const all = selection?.allPlayers ? [] : (selection?.players ?? []);
+  const ids = all.map((p) => p.id);
+  const chosen = all.filter((p) => !dismissed.includes(p.id));
+  const affected = sensors.filter((s) => {
+    const players = s.filters?.players ?? [];
+    return players.length > 0 && players.every((id) => ids.includes(id)) && chosen.some((p) => !players.includes(p.id));
+  });
+  const missing = chosen.filter((p) => affected.some((s) => !s.filters.players.includes(p.id)));
+  return { players: missing, sensorIds: affected.map((s) => s.id) };
+}
+
 /** One plain-language line describing what a sensor does. */
 export function summarize(sensor, selection = {}) {
   const name = (items, id, key, field = 'id') => items?.find((item) => item[field] === id)?.[key] ?? id;
+  const player = (id) => {
+    const found = selection.players?.find((p) => p.id === id);
+    return found ? playerLabel(found, selection.players) : id;
+  };
   const except = CAN_EXCEPT.includes(sensor.state) ? (sensor.except ?? []) : [];
   const when = SENSOR_TYPES[sensor.type]?.state
     ? `On while ${({ idle: 'nothing is playing', active: 'playing or paused', credits: 'in the credits', intro: 'in the intro' })[sensor.state] ?? (CONDITIONS[sensor.state] ?? CONDITIONS.playing).toLowerCase()}${except.length ? `, except during ${except.map((e) => EXCEPTIONS[e]?.label ?? e).join(' and ')}` : ''}`
     : `Pressed when ${list((sensor.events ?? []).map((e) => EVENTS[e]?.phrase ?? e), 'nothing (choose an event)')}`;
   const f = sensor.filters ?? emptyFilters();
-  const where = list(f.players.map((id) => name(selection.players, id, 'name')), 'any player');
+  const where = list(f.players.map(player), 'any player');
   const what = list(f.libraries.map((key) => name(selection.libraries, key, 'title', 'key')), 'anything');
   const who = list(f.users, 'anyone');
   const media = SENSOR_TYPES[sensor.type]?.state ? mediaPhrases(sensor.media) : [];
@@ -393,8 +467,14 @@ export function reconcileSelection(selection, discovery, previousServerIds = [])
   const keys = new Set(available.map((l) => l.key));
   const added = available.filter((l) => !previousServerIds.includes(l.serverId) && LIBRARY_KINDS[l.kind]?.preselect);
   const kept = (selection.libraries ?? []).filter((l) => keys.has(l.key));
+  // Saved players take Plex's current name and app, so same-name players can be told apart.
+  const players = (selection.players ?? []).map((p) => {
+    const found = discovery.players?.find((d) => d.id === p.id);
+    return found ? playerRef(found) : p;
+  });
   return {
     ...selection,
+    players,
     libraries: selection.allLibraries ? [] : [...kept, ...added.filter((l) => !kept.some((k) => k.key === l.key))],
   };
 }

package/homebridge-ui/server.js

@@ -6,7 +6,7 @@ import qrcode from 'qrcode-generator';
 
 import { CommandRunner } from '../dist/commands.js';
 import { PlexHttpError } from '../dist/plex/server.js';
-import { diagnosticsReport } from '../dist/report.js';
+import { diagnosticsReport, liveLog } from '../dist/report.js';
 import { SetupError, SetupService, webhookOptionsFrom } from '../dist/setup-service.js';
 import { Storage } from '../dist/storage.js';
 
@@ -62,6 +62,7 @@ class IntermissionUiServer extends HomebridgePluginUiServer {
       timeZone: typeof body.timeZone === 'string' ? body.timeZone.slice(0, 80) : undefined,
       includeNames: body.includeNames === true,
     }, new Date()));
+    this.handle('/diagnostics/live', () => liveLog(service));
     this.ready();
   }
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "homebridge-plex-intermission",
   "displayName": "Intermission for Plex",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Apple Home sensors for every moment of Plex playback: playing, paused, credits and nothing playing. Timed to Plex's credits markers, instant without polling.",
   "author": "maxrogers",
   "license": "MIT",