feat(orbit): in-app diagnostics popover with copyable event log (#524)

* feat(orbit): in-app diagnostics popover with copyable event log

Multiple users on Discord report Orbit guests stopping after the first
song with no errors anywhere — Settings → Debug → Export Logs is too
buried for non-technical reporters, and the relevant code branches
have no logging at all (silent fail). This adds a one-click "Copy log"
path right inside the Orbit session bar.

The new Activity-icon button next to Help opens a popover with:

- Live mini-display: role, host vs. guest track id + position, drift,
  age of the host's last state write — all updating once a second.
- Scrolling event log textarea fed by an in-memory ring (200 events).
- Copy + Clear buttons. Copy formats `[ISO] [scope] body` lines and
  drops them on the clipboard — paste straight into a Discord report.

Instrumentation lands at the previously-silent decision points:

- Guest pull tick: full snapshot of host vs. guest state on every read.
- Each branch of the divergence detection in `useOrbitGuest.ts` logs
  which path it took and why (initial / track-change-followed /
  track-change-diverged / play-pause-flip), making the
  "stuck after first song" symptom diagnosable from the buffer alone.
- Host pushes log track id, isPlaying, queue length, guest count.

Events are also bridged to the existing `frontend_debug_log` Tauri
command when Settings → Logging is on Debug, so power users still get
the same data in `psysonic-logs-*.log` for offline triage.

i18n: full `orbit.diag.*` namespace in all eight locales. EN + DE are
native; ES / FR / NB / NL / RU / ZH are first-pass and may want a
polish from native speakers later.

* docs(changelog): add orbit diagnostics popover entry
This commit is contained in:
Frank Stellmacher
2026-05-09 21:49:17 +02:00
committed by GitHub
parent acadc1be34
commit a702a5dd5b
15 changed files with 610 additions and 3 deletions
+21
View File
@@ -1696,6 +1696,27 @@ export const deTranslation = {
endTooltip: 'Session beenden',
leaveTooltip: 'Session verlassen',
helpTooltip: 'Wie Orbit funktioniert',
diag: {
openTooltip: 'Diagnose — kopierbares Ereignis-Log',
title: 'Orbit-Diagnose',
role: 'Rolle',
hostTrack: 'Host-Track-ID',
hostPos: 'Host-Position',
guestTrack: 'Meine Track-ID',
guestPos: 'Meine Position',
drift: 'Versatz',
stateAge: 'Zustand-Alter',
eventLog: 'Ereignis-Log ({{count}})',
copyLabel: 'Kopieren',
copyTooltip: 'Log in Zwischenablage kopieren',
clearLabel: 'Leeren',
clearTooltip: 'Puffer leeren',
empty: 'Noch keine Ereignisse — sie erscheinen sobald Orbit synchronisiert.',
hint: 'Vor dem Reproduzieren des Problems öffnen, dann Kopieren klicken und in den Bug-Report einfügen.',
copied: '{{count}} Zeilen kopiert',
copyFailed: 'Konnte nicht in Zwischenablage kopieren',
cleared: 'Puffer geleert',
},
helpTitle: 'Wie Orbit funktioniert',
helpIntro: 'Orbit macht aus Psysonic einen gemeinsamen Hörraum. Der Host bestimmt die Musik; Gäste hören synchron mit und können Songs vorschlagen.',
helpHostOnly: '(Host)',
+21
View File
@@ -1702,6 +1702,27 @@ export const enTranslation = {
endTooltip: 'End session',
leaveTooltip: 'Leave session',
helpTooltip: 'How Orbit works',
diag: {
openTooltip: 'Diagnostics — copyable event log',
title: 'Orbit diagnostics',
role: 'Role',
hostTrack: 'Host track id',
hostPos: 'Host position',
guestTrack: 'My track id',
guestPos: 'My position',
drift: 'Drift',
stateAge: 'State age',
eventLog: 'Event log ({{count}})',
copyLabel: 'Copy',
copyTooltip: 'Copy log to clipboard',
clearLabel: 'Clear',
clearTooltip: 'Wipe the buffer',
empty: 'No events yet — events appear as Orbit syncs.',
hint: 'Open this before reproducing a problem, then click Copy and paste into the bug report.',
copied: 'Copied {{count}} event lines',
copyFailed: 'Could not copy to clipboard',
cleared: 'Buffer cleared',
},
helpTitle: 'How Orbit works',
helpIntro: 'Orbit turns Psysonic into a shared listening room. A host picks the music; guests listen in sync and can suggest tracks.',
helpHostOnly: '(host)',
+21
View File
@@ -1654,6 +1654,27 @@ export const esTranslation = {
endTooltip: 'Terminar sesión',
leaveTooltip: 'Salir de la sesión',
helpTooltip: 'Cómo funciona Orbit',
diag: {
openTooltip: 'Diagnóstico — registro de eventos copiable',
title: 'Diagnóstico de Orbit',
role: 'Rol',
hostTrack: 'ID de pista del anfitrión',
hostPos: 'Posición del anfitrión',
guestTrack: 'Mi ID de pista',
guestPos: 'Mi posición',
drift: 'Desfase',
stateAge: 'Edad del estado',
eventLog: 'Registro de eventos ({{count}})',
copyLabel: 'Copiar',
copyTooltip: 'Copiar registro al portapapeles',
clearLabel: 'Borrar',
clearTooltip: 'Vaciar el búfer',
empty: 'Aún sin eventos — aparecen cuando Orbit sincroniza.',
hint: 'Abre esto antes de reproducir el problema, luego pulsa Copiar y pega en el reporte.',
copied: '{{count}} líneas copiadas',
copyFailed: 'No se pudo copiar al portapapeles',
cleared: 'Búfer vaciado',
},
helpTitle: 'Cómo funciona Orbit',
helpIntro: 'Orbit convierte Psysonic en una sala de escucha compartida. Un anfitrión elige la música; los invitados escuchan en sincronía y pueden sugerir canciones.',
helpHostOnly: '(anfitrión)',
+21
View File
@@ -1650,6 +1650,27 @@ export const frTranslation = {
endTooltip: 'Terminer la session',
leaveTooltip: 'Quitter la session',
helpTooltip: 'Fonctionnement d\'Orbit',
diag: {
openTooltip: 'Diagnostic — journal d\'événements copiable',
title: 'Diagnostic Orbit',
role: 'Rôle',
hostTrack: 'ID de piste de l\'hôte',
hostPos: 'Position de l\'hôte',
guestTrack: 'Mon ID de piste',
guestPos: 'Ma position',
drift: 'Décalage',
stateAge: 'Âge de l\'état',
eventLog: 'Journal d\'événements ({{count}})',
copyLabel: 'Copier',
copyTooltip: 'Copier le journal dans le presse-papiers',
clearLabel: 'Effacer',
clearTooltip: 'Vider le tampon',
empty: 'Aucun événement — ils apparaissent dès qu\'Orbit synchronise.',
hint: 'Ouvre ceci avant de reproduire le problème, puis clique Copier et colle dans le rapport.',
copied: '{{count}} lignes copiées',
copyFailed: 'Impossible de copier dans le presse-papiers',
cleared: 'Tampon vidé',
},
helpTitle: 'Fonctionnement d\'Orbit',
helpIntro: 'Orbit transforme Psysonic en salle d\'écoute partagée. Un hôte choisit la musique ; les invités écoutent en synchro et peuvent suggérer des morceaux.',
helpHostOnly: '(hôte)',
+21
View File
@@ -1649,6 +1649,27 @@ export const nbTranslation = {
endTooltip: 'Avslutt økt',
leaveTooltip: 'Forlat økt',
helpTooltip: 'Hvordan Orbit fungerer',
diag: {
openTooltip: 'Diagnose — kopierbar hendelseslogg',
title: 'Orbit-diagnose',
role: 'Rolle',
hostTrack: 'Vertens spor-ID',
hostPos: 'Vertens posisjon',
guestTrack: 'Min spor-ID',
guestPos: 'Min posisjon',
drift: 'Avvik',
stateAge: 'Tilstandens alder',
eventLog: 'Hendelseslogg ({{count}})',
copyLabel: 'Kopier',
copyTooltip: 'Kopier loggen til utklippstavlen',
clearLabel: 'Tøm',
clearTooltip: 'Tøm bufferen',
empty: 'Ingen hendelser ennå — de dukker opp når Orbit synkroniserer.',
hint: 'Åpne dette før du reproduserer problemet, klikk Kopier og lim inn i feilrapporten.',
copied: '{{count}} linjer kopiert',
copyFailed: 'Kunne ikke kopiere til utklippstavlen',
cleared: 'Buffer tømt',
},
helpTitle: 'Hvordan Orbit fungerer',
helpIntro: 'Orbit gjør Psysonic til et delt lytterom. En vert velger musikken; gjester lytter synkronisert og kan foreslå spor.',
helpHostOnly: '(vert)',
+21
View File
@@ -1649,6 +1649,27 @@ export const nlTranslation = {
endTooltip: 'Sessie beëindigen',
leaveTooltip: 'Sessie verlaten',
helpTooltip: 'Hoe Orbit werkt',
diag: {
openTooltip: 'Diagnose — kopieerbaar gebeurtenissen-log',
title: 'Orbit-diagnose',
role: 'Rol',
hostTrack: 'Track-ID van host',
hostPos: 'Positie van host',
guestTrack: 'Mijn track-ID',
guestPos: 'Mijn positie',
drift: 'Verschil',
stateAge: 'Leeftijd van staat',
eventLog: 'Gebeurtenissen-log ({{count}})',
copyLabel: 'Kopiëren',
copyTooltip: 'Log naar klembord kopiëren',
clearLabel: 'Wissen',
clearTooltip: 'Buffer leegmaken',
empty: 'Nog geen gebeurtenissen — ze verschijnen zodra Orbit synchroniseert.',
hint: 'Open dit voor je het probleem reproduceert, klik dan Kopiëren en plak in de bugmelding.',
copied: '{{count}} regels gekopieerd',
copyFailed: 'Kon niet naar klembord kopiëren',
cleared: 'Buffer gewist',
},
helpTitle: 'Hoe Orbit werkt',
helpIntro: 'Orbit maakt van Psysonic een gedeelde luisterruimte. Een host kiest de muziek; gasten luisteren synchroon mee en kunnen nummers voorstellen.',
helpHostOnly: '(host)',
+21
View File
@@ -1712,6 +1712,27 @@ export const ruTranslation = {
endTooltip: 'Завершить сессию',
leaveTooltip: 'Покинуть сессию',
helpTooltip: 'Как работает Orbit',
diag: {
openTooltip: 'Диагностика — копируемый журнал событий',
title: 'Диагностика Orbit',
role: 'Роль',
hostTrack: 'ID трека хоста',
hostPos: 'Позиция хоста',
guestTrack: 'Мой ID трека',
guestPos: 'Моя позиция',
drift: 'Расхождение',
stateAge: 'Возраст состояния',
eventLog: 'Журнал событий ({{count}})',
copyLabel: 'Копировать',
copyTooltip: 'Скопировать журнал в буфер обмена',
clearLabel: 'Очистить',
clearTooltip: 'Очистить буфер',
empty: 'Пока нет событий — они появятся когда Orbit начнёт синхронизацию.',
hint: 'Открой это перед воспроизведением проблемы, затем нажми Копировать и вставь в баг-репорт.',
copied: 'Скопировано строк: {{count}}',
copyFailed: 'Не удалось скопировать в буфер обмена',
cleared: 'Буфер очищен',
},
helpTitle: 'Как работает Orbit',
helpIntro: 'Orbit превращает Psysonic в общую комнату прослушивания. Хост выбирает музыку; гости слушают синхронно и могут предлагать треки.',
helpHostOnly: '(хост)',
+21
View File
@@ -1642,6 +1642,27 @@ export const zhTranslation = {
endTooltip: '结束会话',
leaveTooltip: '离开会话',
helpTooltip: 'Orbit 的工作原理',
diag: {
openTooltip: '诊断 — 可复制的事件日志',
title: 'Orbit 诊断',
role: '角色',
hostTrack: '主持人曲目 ID',
hostPos: '主持人位置',
guestTrack: '我的曲目 ID',
guestPos: '我的位置',
drift: '偏差',
stateAge: '状态时长',
eventLog: '事件日志 ({{count}})',
copyLabel: '复制',
copyTooltip: '将日志复制到剪贴板',
clearLabel: '清除',
clearTooltip: '清空缓冲区',
empty: '暂无事件 — Orbit 同步时会显示。',
hint: '在重现问题前打开此面板,然后点击复制并粘贴到错误报告中。',
copied: '已复制 {{count}} 行',
copyFailed: '无法复制到剪贴板',
cleared: '缓冲区已清空',
},
helpTitle: 'Orbit 的工作原理',
helpIntro: 'Orbit 将 Psysonic 变成一个共享的收听空间。主持人选择音乐;访客同步收听并可以推荐曲目。',
helpHostOnly: '(主持人)',