BlueGit

timfa filemanager

Merge feature/share-player-uses-shared-streaming-code: unify share and app video player code

timfa Tim Falken · pushed by timfa

Authored 2026-05-20 · 6 months ago

Hash
7eb2815977557636baf3f762a443e41b0423169f
8 files changed +1084 −962
.github/technical-reference.md +10 −1
@@ -120,6 +120,8 @@
120 120 - GET /api/share/preview/:token - Public. Streams file content inline for preview (files only, max 50 MB); 400 for directories, 410 expired.
121 121 - GET /api/share/download/:token - Public. Downloads the file or a zip of the directory for a valid token; 410 expired.
122 122 - GET /api/share/video-stream/:token - Public. Creates a short-lived HLS session for a shared video and returns playlistUrl, durationSeconds, subtitleTracks, imageSubtitleTracks, and subtitleSummary ({total, converted, imageBased, skipped}).
123 - GET /api/share/video-stream-subtitle-frame/:token - Public. Renders a PNG subtitle frame for shared-video bitmap subtitle tracks using the same cached PGS decode path as the authenticated player; returns 204 with X-Subtitle-Frame-Status when no frame is active or rendering fails.
124 - DELETE /api/share/video-stream/session/:sessionId - Public. Explicitly releases a shared HLS lease so the share page can clean up the backend stream session on close/unload instead of waiting for idle expiry.
123 125 - buildShareOpenGraphPage(token, req) - Reads share.html, injects OG meta tags (<og:title>, <og:description>, <og:image> for image files, twitter:card) based on DB lookup of token, and returns the full HTML string. Handles expired and not-found tokens. Exported and used by the /share/:token route in server/index.js.
124 126 - buildZip(dirPath, cacheKey) - Creates (or returns cached) zip in zip-cache/; prunes stale zips before building; exported for reuse in files.js.
125 127 - pruneZipCache() - Deletes zip files in zip-cache/ older than 1 day; called automatically before each zip build.
@@ -151,10 +153,17 @@
151 153 - Standalone public share page served at /share/:token; no auth required.
152 154 - Timer bar - Live HH:MM:SS countdown showing remaining validity; turns red and disables download when expired.
153 155 - tryPreview(name, isDir) - Renders inline preview (img/video/audio/text pre); no-op for unsupported types or directories.
154 - Share video preview - Uses the same Video.js playback behaviour as app previews: VOD UI enforcement, long forward buffer, forced caption overrides (text background opacity transparent + text edge style uniform), and subtitle/audio track restore/save by matching track names when available.
156 - Share video preview - Uses the shared browser video-player helper used by app previews: VOD UI enforcement, long forward buffer, forced caption overrides (text background opacity transparent + text edge style uniform), subtitle/audio track restore/save by matching track names, image-subtitle overlay support, and explicit backend session release on unload.
155 157 - Fetches /api/share/info/:token on load; shows error state for 404/410 responses.
156 158 - Download link points to /api/share/download/:token; labelled "Download als .zip" for directories.
157 159
160 ## public/shared-video-player.js
161 - applyDefaultTextTrackPrefs() - Writes the default Video.js caption override settings (transparent background, uniform edge style) so all streamed players start from the same text-track baseline.
162 - bindTrackPrefs(player, prefs, savePrefs) - Restores subtitle/audio track selections by track name and persists later track changes; shared by the authenticated player and the share page so both resolve track matches the same way.
163 - bindImageSubtitleOverlay(player, videojs, prefs, session, opts) - Adds the shared IM button/menu/overlay for bitmap subtitle tracks, restores saved image-subtitle selections, fetches rendered frames through a caller-supplied request builder, and disables the track after the first hard failure.
164 - configureVideoJsBuffering(videojs, opts) - Applies the long forward-buffer settings used for file playback when VHS exposes those knobs.
165 - ensureVideoPlaybackUi(player, durationSeconds) - Forces file streams into VOD UI mode, normalises the reported duration, stops live-tracker state, and hides the live badge when present.
166
158 167 ## public/index.html
159 168 - Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
160 169 - Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
@@ -120,6 +120,8 @@
120- GET /api/share/preview/:token - Public. Streams file content inline for preview (files only, max 50 MB); 400 for directories, 410 expired.
120- GET /api/share/preview/:token - Public. Streams file content inline for preview (files only, max 50 MB); 400 for directories, 410 expired.
121- GET /api/share/download/:token - Public. Downloads the file or a zip of the directory for a valid token; 410 expired.
121- GET /api/share/download/:token - Public. Downloads the file or a zip of the directory for a valid token; 410 expired.
122- GET /api/share/video-stream/:token - Public. Creates a short-lived HLS session for a shared video and returns playlistUrl, durationSeconds, subtitleTracks, imageSubtitleTracks, and subtitleSummary ({total, converted, imageBased, skipped}).
122- GET /api/share/video-stream/:token - Public. Creates a short-lived HLS session for a shared video and returns playlistUrl, durationSeconds, subtitleTracks, imageSubtitleTracks, and subtitleSummary ({total, converted, imageBased, skipped}).
123- GET /api/share/video-stream-subtitle-frame/:token - Public. Renders a PNG subtitle frame for shared-video bitmap subtitle tracks using the same cached PGS decode path as the authenticated player; returns 204 with X-Subtitle-Frame-Status when no frame is active or rendering fails.
124- DELETE /api/share/video-stream/session/:sessionId - Public. Explicitly releases a shared HLS lease so the share page can clean up the backend stream session on close/unload instead of waiting for idle expiry.
123- buildShareOpenGraphPage(token, req) - Reads share.html, injects OG meta tags (<og:title>, <og:description>, <og:image> for image files, twitter:card) based on DB lookup of token, and returns the full HTML string. Handles expired and not-found tokens. Exported and used by the /share/:token route in server/index.js.
125- buildShareOpenGraphPage(token, req) - Reads share.html, injects OG meta tags (<og:title>, <og:description>, <og:image> for image files, twitter:card) based on DB lookup of token, and returns the full HTML string. Handles expired and not-found tokens. Exported and used by the /share/:token route in server/index.js.
124- buildZip(dirPath, cacheKey) - Creates (or returns cached) zip in zip-cache/; prunes stale zips before building; exported for reuse in files.js.
126- buildZip(dirPath, cacheKey) - Creates (or returns cached) zip in zip-cache/; prunes stale zips before building; exported for reuse in files.js.
125- pruneZipCache() - Deletes zip files in zip-cache/ older than 1 day; called automatically before each zip build.
127- pruneZipCache() - Deletes zip files in zip-cache/ older than 1 day; called automatically before each zip build.
@@ -151,10 +153,17 @@
151- Standalone public share page served at /share/:token; no auth required.
153- Standalone public share page served at /share/:token; no auth required.
152- Timer bar - Live HH:MM:SS countdown showing remaining validity; turns red and disables download when expired.
154- Timer bar - Live HH:MM:SS countdown showing remaining validity; turns red and disables download when expired.
153- tryPreview(name, isDir) - Renders inline preview (img/video/audio/text pre); no-op for unsupported types or directories.
155- tryPreview(name, isDir) - Renders inline preview (img/video/audio/text pre); no-op for unsupported types or directories.
154- Share video preview - Uses the same Video.js playback behaviour as app previews: VOD UI enforcement, long forward buffer, forced caption overrides (text background opacity transparent + text edge style uniform), and subtitle/audio track restore/save by matching track names when available.
156- Share video preview - Uses the shared browser video-player helper used by app previews: VOD UI enforcement, long forward buffer, forced caption overrides (text background opacity transparent + text edge style uniform), subtitle/audio track restore/save by matching track names, image-subtitle overlay support, and explicit backend session release on unload.
155- Fetches /api/share/info/:token on load; shows error state for 404/410 responses.
157- Fetches /api/share/info/:token on load; shows error state for 404/410 responses.
156- Download link points to /api/share/download/:token; labelled "Download als .zip" for directories.
158- Download link points to /api/share/download/:token; labelled "Download als .zip" for directories.
157
159
160## public/shared-video-player.js
161- applyDefaultTextTrackPrefs() - Writes the default Video.js caption override settings (transparent background, uniform edge style) so all streamed players start from the same text-track baseline.
162- bindTrackPrefs(player, prefs, savePrefs) - Restores subtitle/audio track selections by track name and persists later track changes; shared by the authenticated player and the share page so both resolve track matches the same way.
163- bindImageSubtitleOverlay(player, videojs, prefs, session, opts) - Adds the shared IM button/menu/overlay for bitmap subtitle tracks, restores saved image-subtitle selections, fetches rendered frames through a caller-supplied request builder, and disables the track after the first hard failure.
164- configureVideoJsBuffering(videojs, opts) - Applies the long forward-buffer settings used for file playback when VHS exposes those knobs.
165- ensureVideoPlaybackUi(player, durationSeconds) - Forces file streams into VOD UI mode, normalises the reported duration, stops live-tracker state, and hides the live badge when present.
166
158## public/index.html
167## public/index.html
159- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
168- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
160- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
169- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
public/app.js +36 −683
@@ -370,697 +370,58 @@ function buildAuthHeaders ()
370 370
371 371 function applyUserVideoTextTrackPrefs ()
372 372 {
373 try
374 {
375 // Only override the two requested defaults and leave other settings at Video.js defaults.
376 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
377 } catch
378 {
379 // Ignore localStorage failures.
380 }
381 }
382
383 function normaliseTrackName (name)
384 {
385 return String(name || '').trim().toLowerCase();
373 const shared = sharedVideoPlayer();
374 if (!shared || typeof shared.applyDefaultTextTrackPrefs !== 'function') return;
375 shared.applyDefaultTextTrackPrefs();
386 376 }
387 377
388 function getTrackName (track)
378 function sharedVideoPlayer ()
389 379 {
390 if (!track || typeof track !== 'object') return '';
391 const label = String(track.label || '').trim();
392 if (label) return label;
393 const name = String(track.name || '').trim();
394 if (name) return name;
395 const language = String(track.language || '').trim();
396 if (language) return language;
397 const id = String(track.id || '').trim();
398 if (id) return id;
399 return '';
400 }
401
402 function trackListToArray (trackList)
403 {
404 if (!trackList || typeof trackList.length !== 'number') return [];
405 const out = [];
406 for (let i = 0; i < trackList.length; i++)
407 {
408 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
409 if (track) out.push(track);
410 }
411 return out;
412 }
413
414 function subtitleTracksFromPlayer (player)
415 {
416 if (!player || typeof player.textTracks !== 'function') return [];
417 return trackListToArray(player.textTracks()).filter((track) =>
418 {
419 const kind = String(track.kind || '').toLowerCase();
420 return kind === 'subtitles' || kind === 'captions';
421 });
422 }
423
424 function audioTracksFromPlayer (player)
425 {
426 if (!player || typeof player.audioTracks !== 'function') return [];
427 return trackListToArray(player.audioTracks());
428 }
429
430 function applySavedSubtitleTrack (player, savedName)
431 {
432 if (typeof savedName !== 'string') return;
433 const tracks = subtitleTracksFromPlayer(player);
434 if (!tracks.length) return;
435
436 const wanted = normaliseTrackName(savedName);
437 if (!wanted)
438 {
439 for (const track of tracks) track.mode = 'disabled';
440 return;
441 }
442
443 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
444 if (!match) return;
445
446 for (const track of tracks)
447 {
448 track.mode = track === match ? 'showing' : 'disabled';
449 }
450 }
451
452 function applySavedAudioTrack (player, savedName)
453 {
454 if (typeof savedName !== 'string') return;
455 const tracks = audioTracksFromPlayer(player);
456 if (!tracks.length) return;
457
458 const wanted = normaliseTrackName(savedName);
459 if (!wanted) return;
460
461 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
462 if (!match) return;
463
464 for (const track of tracks)
465 {
466 track.enabled = track === match;
467 }
468 }
469
470 function getSelectedSubtitleTrackName (player)
471 {
472 const tracks = subtitleTracksFromPlayer(player);
473 if (!tracks.length) return null;
474 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
475 return active ? getTrackName(active) : '';
476 }
477
478 function getSelectedAudioTrackName (player)
479 {
480 const tracks = audioTracksFromPlayer(player);
481 if (!tracks.length) return null;
482 const active = tracks.find((track) => !!track.enabled);
483 return active ? getTrackName(active) : '';
380 return window.FilemanagerSharedVideoPlayer || null;
484 381 }
485 382
486 383 function bindUserVideoTrackPrefs (player, prefs)
487 384 {
488 const applySavedTracks = () =>
489 {
490 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
491 applySavedAudioTrack(player, prefs.audioTrackName);
492 };
493
494 const captureSelectedTracks = () =>
385 const shared = sharedVideoPlayer();
386 if (!shared || typeof shared.bindTrackPrefs !== 'function')
495 387 {
496 const subtitleTrackName = getSelectedSubtitleTrackName(player);
497 const audioTrackName = getSelectedAudioTrackName(player);
498 const patch = {};
499
500 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
501 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
502
503 if (Object.keys(patch).length) saveUserVideoPrefs(patch);
504 };
505
506 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
507 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
508 const onTrackListChange = () => captureSelectedTracks();
509
510 if (textTrackList && typeof textTrackList.addEventListener === 'function')
511 {
512 textTrackList.addEventListener('change', onTrackListChange);
513 }
514
515 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
516 {
517 audioTrackList.addEventListener('change', onTrackListChange);
388 return {
389 applySavedTracks: () => {},
390 captureSelectedTracks: () => {},
391 detach: () => {},
392 };
518 393 }
519
520 return {
521 applySavedTracks,
522 captureSelectedTracks,
523 detach: () =>
524 {
525 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
526 {
527 textTrackList.removeEventListener('change', onTrackListChange);
528 }
529 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
530 {
531 audioTrackList.removeEventListener('change', onTrackListChange);
532 }
533 },
534 };
394 return shared.bindTrackPrefs(player, prefs, saveUserVideoPrefs);
535 395 }
536 396
537 397 function bindImageSubtitleOverlay (player, videojs, prefs, session, item)
538 398 {
539 const imageTracks = Array.isArray(session.imageSubtitleTracks)
540 ? session.imageSubtitleTracks.map((track) => ({
541 label: String(track.label || '').trim() || `Subtitle ${Number(track.streamIndex || 0) + 1}`,
542 language: String(track.language || '').trim(),
543 isDefault: !!track.default,
544 streamIndex: Number(track.streamIndex),
545 })).filter((track) => Number.isInteger(track.streamIndex) && track.streamIndex >= 0)
546 : [];
547
548 if (!imageTracks.length) return null;
549
550 const trackByStreamIndex = new Map(imageTracks.map((track) => [track.streamIndex, track]));
551 let selectedStreamIndex = null;
552 let menuOpen = false;
553 let requestToken = 0;
554 let activeBucket = -1;
555 let activeObjectUrl = null;
556 let overlayEl = null;
557 let overlayImgEl = null;
558 let menuEl = null;
559 let buttonEl = null;
560 let trackDisabled = false;
561 let failureNotified = false;
562
563 const closeObjectUrl = () =>
564 {
565 if (activeObjectUrl)
566 {
567 URL.revokeObjectURL(activeObjectUrl);
568 activeObjectUrl = null;
569 }
570 };
571
572 const hideOverlay = () =>
573 {
574 if (overlayEl) overlayEl.style.display = 'none';
575 if (overlayImgEl) overlayImgEl.removeAttribute('src');
576 closeObjectUrl();
577 };
578
579 const updateButtonState = () =>
580 {
581 if (!buttonEl) return;
582 const track = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
583 buttonEl.setAttribute('title', track ? `Image subtitles: ${track.label}` : 'Image subtitles');
584 buttonEl.setAttribute('aria-pressed', selectedStreamIndex === null ? 'false' : 'true');
585 };
586
587 const updateMenuState = () =>
588 {
589 if (!menuEl) return;
590 const items = menuEl.querySelectorAll('[data-image-subtitle-stream-index]');
591 for (const itemEl of items)
592 {
593 const value = itemEl.getAttribute('data-image-subtitle-stream-index');
594 const isSelected = value === (selectedStreamIndex === null ? 'off' : String(selectedStreamIndex));
595 itemEl.classList.toggle('is-selected', isSelected);
596 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
597 itemEl.style.background = isSelected ? 'rgba(90, 196, 255, 0.28)' : 'transparent';
598 itemEl.style.fontWeight = isSelected ? '600' : '400';
599 itemEl.style.boxShadow = isSelected ? 'inset 0 0 0 1px rgba(90, 196, 255, 0.55)' : 'none';
600 }
601 };
602
603 const closeMenu = () =>
604 {
605 menuOpen = false;
606 if (menuEl) menuEl.style.display = 'none';
607 };
608
609 const openMenu = () =>
610 {
611 menuOpen = true;
612 if (menuEl)
613 {
614 updateMenuState();
615 menuEl.style.display = 'block';
616 }
617 };
618
619 const toggleMenu = () =>
620 {
621 if (menuOpen) closeMenu();
622 else openMenu();
623 };
624
625 const saveSelection = () =>
626 {
627 const selectedTrack = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
628 saveUserVideoPrefs({
629 imageSubtitleTrackStreamIndex: selectedStreamIndex,
630 imageSubtitleTrackName: selectedTrack ? selectedTrack.label : null,
631 });
632 };
633
634 const disableTrack = () =>
635 {
636 trackDisabled = true;
637 selectedStreamIndex = null;
638 activeBucket = -1;
639 hideOverlay();
640 updateButtonState();
641 updateMenuState();
642 saveSelection();
643
644 if (!failureNotified)
645 {
646 failureNotified = true;
647 toast('Image subtitles could not be rendered for this file.', 'err');
648 }
649 };
650
651 const setSelectedStreamIndex = (streamIndex, { persist = true } = {}) =>
652 {
653 const nextStreamIndex = Number.isInteger(streamIndex) ? streamIndex : null;
654 if (nextStreamIndex !== null && !trackByStreamIndex.has(nextStreamIndex)) return;
655
656 trackDisabled = false;
657 failureNotified = false;
658 selectedStreamIndex = nextStreamIndex;
659 activeBucket = -1;
660 hideOverlay();
661 updateButtonState();
662 updateMenuState();
663 if (persist) saveSelection();
664
665 if (selectedStreamIndex !== null)
666 {
667 void refreshFrame(true);
668 }
669 };
670
671 const refreshFrame = async (force = false) =>
672 {
673 if (selectedStreamIndex === null) return;
674 if (!overlayEl || !overlayImgEl) return;
675 if (trackDisabled) return;
676
677 const currentTime = Number(player.currentTime());
678 if (!Number.isFinite(currentTime) || currentTime < 0) return;
679
680 const bucket = Math.floor(currentTime * 4);
681 if (!force && bucket === activeBucket) return;
682 activeBucket = bucket;
683
684 const token = ++requestToken;
685 const headers = buildAuthHeaders();
686 const url = `/api/files/video-stream-subtitle-frame?filePath=${encodeURIComponent(item.path)}&streamIndex=${selectedStreamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(session.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(session.videoHeight || ''))}`;
687
688 try
689 {
690 const res = await fetch(url, {
691 method: 'GET',
692 headers,
693 credentials: 'same-origin',
694 });
695
696 if (token !== requestToken) return;
697
698 if (res.status === 204)
699 {
700 const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase();
701 hideOverlay();
702 if (frameStatus === 'error') disableTrack();
703 return;
704 }
705
706 if (!res.ok)
707 {
708 disableTrack();
709 return;
710 }
711
712 const blob = await res.blob();
713 if (token !== requestToken) return;
714
715 if (!blob || blob.size === 0)
716 {
717 disableTrack();
718 return;
719 }
720
721 closeObjectUrl();
722 activeObjectUrl = URL.createObjectURL(blob);
723 overlayImgEl.src = activeObjectUrl;
724
725 // Apply placement from headers when available
726 const frameLeft = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Left') || ''), 10);
727 const frameTop = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Top') || ''), 10);
728 const frameWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Width') || ''), 10);
729 const frameHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Height') || ''), 10);
730 const canvasWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Width') || ''), 10);
731 const canvasHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Height') || ''), 10);
732
733 if (frameWidth > 0 && frameHeight > 0 && canvasWidth > 0 && canvasHeight > 0)
734 {
735 // Apply percentage-based sizing to scale the downscaled image properly
736 const widthPercent = (frameWidth / canvasWidth) * 100;
737 const heightPercent = (frameHeight / canvasHeight) * 100;
738 overlayImgEl.style.width = `${widthPercent}%`;
739 overlayImgEl.style.height = `${heightPercent}%`;
740 overlayImgEl.style.maxWidth = 'none';
741 overlayImgEl.style.maxHeight = 'none';
742 }
743 else
744 {
745 // Fallback: use auto sizing with max constraints
746 overlayImgEl.style.width = 'auto';
747 overlayImgEl.style.height = 'auto';
748 overlayImgEl.style.maxWidth = '100%';
749 overlayImgEl.style.maxHeight = '100%';
750 }
751
752 overlayEl.style.display = 'block';
753 overlayImgEl.style.display = 'block';
754 } catch
755 {
756 if (token === requestToken) disableTrack();
757 }
758 };
759
760 const dispose = () =>
761 {
762 requestToken++;
763 closeMenu();
764 hideOverlay();
765 if (overlayEl) overlayEl.remove();
766 if (menuEl) menuEl.remove();
767 player.imageSubtitleOverlayController = null;
768 buttonEl = null;
769 };
770
771 overlayEl = document.createElement('div');
772 overlayEl.className = 'video-subtitle-overlay';
773 overlayEl.style.position = 'absolute';
774 overlayEl.style.left = '0';
775 overlayEl.style.right = '0';
776 overlayEl.style.bottom = '3rem';
777 overlayEl.style.display = 'none';
778 overlayEl.style.zIndex = '3';
779 overlayEl.style.pointerEvents = 'none';
780 overlayEl.style.textAlign = 'center';
781 overlayEl.style.padding = '0 0.75rem';
782 overlayEl.style.maxHeight = '70%';
783 overlayEl.style.overflow = 'hidden';
784
785 overlayImgEl = document.createElement('img');
786 overlayImgEl.alt = 'Image subtitles';
787 overlayImgEl.style.display = 'none';
788 overlayImgEl.style.margin = '0 auto';
789 overlayImgEl.style.objectFit = 'contain';
790 overlayImgEl.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))';
791 overlayImgEl.style.maxWidth = '100%';
792 overlayImgEl.style.height = 'auto';
793 overlayEl.appendChild(overlayImgEl);
794
795 menuEl = document.createElement('div');
796 menuEl.className = 'video-subtitle-overlay-menu';
797 menuEl.style.position = 'absolute';
798 menuEl.style.right = '0.75rem';
799 menuEl.style.bottom = 'calc(3rem + 0.5rem)';
800 menuEl.style.minWidth = '14rem';
801 menuEl.style.maxWidth = '20rem';
802 menuEl.style.background = 'rgba(12, 12, 12, 0.96)';
803 menuEl.style.border = '1px solid rgba(255, 255, 255, 0.15)';
804 menuEl.style.borderRadius = '0.5rem';
805 menuEl.style.boxShadow = '0 12px 28px rgba(0, 0, 0, 0.35)';
806 menuEl.style.padding = '0.35rem';
807 menuEl.style.display = 'none';
808 menuEl.style.zIndex = '4';
809
810 const buildMenuItem = (label, streamIndex, isSelected) =>
811 {
812 const itemEl = document.createElement('button');
813 itemEl.type = 'button';
814 itemEl.className = 'video-subtitle-overlay-menu-item';
815 itemEl.setAttribute('data-image-subtitle-stream-index', streamIndex === null ? 'off' : String(streamIndex));
816 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
817 itemEl.style.display = 'block';
818 itemEl.style.width = '100%';
819 itemEl.style.margin = '0';
820 itemEl.style.padding = '0.5rem 0.75rem';
821 itemEl.style.border = '0';
822 itemEl.style.borderRadius = '0.35rem';
823 itemEl.style.background = isSelected ? 'rgba(255, 255, 255, 0.18)' : 'transparent';
824 itemEl.style.color = '#fff';
825 itemEl.style.textAlign = 'left';
826 itemEl.style.cursor = 'pointer';
827 itemEl.textContent = label;
828 itemEl.addEventListener('click', () =>
829 {
830 setSelectedStreamIndex(streamIndex);
831 closeMenu();
832 });
833 return itemEl;
834 };
835
836 menuEl.appendChild(buildMenuItem('Off', null, false));
837 for (const track of imageTracks)
838 {
839 menuEl.appendChild(buildMenuItem(track.label, track.streamIndex, false));
840 }
841
842 const registerButton = () =>
843 {
844 if (!videojs || typeof videojs.getComponent !== 'function' || typeof videojs.registerComponent !== 'function') return;
845 if (videojs.getComponent('ImageSubtitleButton')) return;
846
847 const Button = videojs.getComponent('Button');
848 class ImageSubtitleButton extends Button
849 {
850 buildCSSClass ()
851 {
852 return `${super.buildCSSClass()} vjs-image-subtitle-button`;
853 }
854
855 createEl ()
856 {
857 const el = super.createEl();
858 el.type = 'button';
859 el.setAttribute('title', 'Image subtitles');
860 el.setAttribute('aria-label', 'Image subtitles');
861 el.innerHTML = '<span aria-hidden="true">IM</span>';
862 return el;
863 }
864
865 handleClick ()
866 {
867 const controller = this.player().imageSubtitleOverlayController;
868 if (controller) controller.toggleMenu();
869 }
870 }
871
872 videojs.registerComponent('ImageSubtitleButton', ImageSubtitleButton);
873 };
874
875 const attachUi = () =>
876 {
877 if (!player.el()) return;
878 registerButton();
879 if (overlayEl.parentElement !== player.el()) player.el().appendChild(overlayEl);
880 if (menuEl.parentElement !== player.el()) player.el().appendChild(menuEl);
881 const controlBar = typeof player.getChild === 'function' ? player.getChild('controlBar') : null;
882 if (controlBar && typeof controlBar.addChild === 'function' && !buttonEl)
883 {
884 const button = controlBar.addChild('ImageSubtitleButton', {});
885 buttonEl = button && typeof button.el === 'function' ? button.el() : null;
886 updateButtonState();
887 }
888 };
889
890 const applySavedTracks = () =>
891 {
892 const savedName = normaliseTrackName(prefs.imageSubtitleTrackName);
893 if (savedName)
894 {
895 const savedByName = imageTracks.find((track) => normaliseTrackName(track.label) === savedName) || null;
896 if (savedByName)
897 {
898 setSelectedStreamIndex(savedByName.streamIndex, { persist: false });
899 return;
900 }
901 }
902
903 const savedIndex = Number(prefs.imageSubtitleTrackStreamIndex);
904 if (Number.isInteger(savedIndex) && trackByStreamIndex.has(savedIndex))
905 {
906 setSelectedStreamIndex(savedIndex, { persist: false });
907 return;
908 }
909
910 const defaultTrack = imageTracks.find((track) => track.isDefault) || null;
911 if (defaultTrack)
912 {
913 setSelectedStreamIndex(defaultTrack.streamIndex, { persist: false });
914 return;
915 }
916
917 setSelectedStreamIndex(null, { persist: false });
918 };
919
920 player.imageSubtitleOverlayController = {
921 toggleMenu,
922 closeMenu,
923 applySavedTracks,
924 captureSelectedTracks: saveSelection,
925 detach: dispose,
926 };
927
928 player.on('timeupdate', () => { void refreshFrame(); });
929 player.on('seeking', () => { void refreshFrame(true); });
930 player.on('play', () => { void refreshFrame(true); });
931 player.on('fullscreenchange', () => { closeMenu(); void refreshFrame(true); });
932 player.on('dispose', dispose);
933 player.ready(() =>
934 {
935 attachUi();
936 updateMenuState();
937 updateButtonState();
938 applySavedTracks();
939 if (menuOpen) openMenu();
399 const shared = sharedVideoPlayer();
400 if (!shared || typeof shared.bindImageSubtitleOverlay !== 'function') return null;
401
402 return shared.bindImageSubtitleOverlay(player, videojs, prefs, session, {
403 savePrefs: saveUserVideoPrefs,
404 buildFrameRequest: ({ currentTime, streamIndex, session: activeSession }) => ({
405 url: `/api/files/video-stream-subtitle-frame?filePath=${encodeURIComponent(item.path)}&streamIndex=${streamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(activeSession.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(activeSession.videoHeight || ''))}`,
406 headers: buildAuthHeaders(),
407 credentials: 'same-origin',
408 }),
409 onError: () => toast('Image subtitles could not be rendered for this file.', 'err'),
940 410 });
941
942 return player.imageSubtitleOverlayController;
943 411 }
944 412
945 413 function normaliseVideoDuration (player, durationSeconds)
946 414 {
947 const duration = Number(durationSeconds);
948 if (!player || !Number.isFinite(duration) || duration <= 0) return;
949
950 let originalDuration = null;
951 let durationWasChanged = false;
952 try
953 {
954 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
955 installDurationFallback(player, originalDuration, duration);
956 if (player.__filemanagerDurationApplied) return;
957
958 const current = originalDuration ? Number(originalDuration()) : NaN;
959 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
960 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
961 if (withinTolerance)
962 {
963 player.__filemanagerDurationApplied = true;
964 return;
965 }
966
967 if (originalDuration)
968 {
969 durationWasChanged = true;
970 originalDuration(duration);
971 }
972 } catch
973 {
974 // Ignore players that do not support setting duration.
975 }
976
977 try
978 {
979 const updated = originalDuration ? Number(originalDuration()) : NaN;
980 if (Number.isFinite(updated) && updated >= duration * 0.95)
981 {
982 player.__filemanagerDurationApplied = true;
983 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
984 return;
985 }
986
987 player.__filemanagerDurationApplied = true;
988 if (typeof player.trigger === 'function') player.trigger('durationchange');
989 } catch
990 {
991 // Ignore duration fallback failures.
992 }
993 }
994
995 function installDurationFallback (player, originalDuration, duration)
996 {
997 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
998
999 player.__filemanagerDurationFallback = true;
1000 player.duration = function durationWithFallback (...args)
1001 {
1002 if (args.length) return originalDuration(...args);
1003 const current = Number(originalDuration());
1004 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
1005 };
1006 }
1007
1008 function formatDurationForDebug (seconds)
1009 {
1010 const value = Number(seconds);
1011 if (!Number.isFinite(value) || value < 0) return 'unknown';
1012
1013 const totalSeconds = Math.floor(value);
1014 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
1015 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
1016 const ss = String(totalSeconds % 60).padStart(2, '0');
1017 return `${hh}:${mm}:${ss}`;
415 const shared = sharedVideoPlayer();
416 if (!shared || typeof shared.normaliseVideoDuration !== 'function') return;
417 shared.normaliseVideoDuration(player, durationSeconds);
1018 418 }
1019 419
1020 420 function ensureVideoPlaybackUi (player, durationSeconds)
1021 421 {
1022 if (!player || typeof player.on !== 'function') return;
1023
1024 const forceVodUi = () =>
1025 {
1026 normaliseVideoDuration(player, durationSeconds);
1027
1028 try
1029 {
1030 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
1031 {
1032 player.liveTracker.stopTracking();
1033 }
1034 } catch
1035 {
1036 // Ignore live tracker availability issues.
1037 }
1038
1039 try
1040 {
1041 if (typeof player.removeClass === 'function')
1042 {
1043 player.removeClass('vjs-live');
1044 }
1045 } catch
1046 {
1047 // Ignore class update failures.
1048 }
1049
1050 try
1051 {
1052 const display = player.el() && player.el().querySelector('.vjs-live-display');
1053 if (display) display.style.display = 'none';
1054 } catch
1055 {
1056 // Ignore missing DOM.
1057 }
1058 };
1059
1060 player.ready(forceVodUi);
1061 player.on('loadedmetadata', forceVodUi);
1062 player.on('durationchange', forceVodUi);
1063 player.on('loadedplaylist', forceVodUi);
422 const shared = sharedVideoPlayer();
423 if (!shared || typeof shared.ensureVideoPlaybackUi !== 'function') return;
424 shared.ensureVideoPlaybackUi(player, durationSeconds);
1064 425 }
1065 426
1066 427 async function reportWatchProgress (filePath, progress)
@@ -4470,20 +3831,12 @@ async function ensureVideoJsLoaded ()
4470 3831
4471 3832 function configureVideoJsBuffering (videojs)
4472 3833 {
4473 if (!VIDEO_FORWARD_BUFFER_OVERRIDE_ENABLED)
4474 return;
4475
4476 if (!videojs || !videojs.Vhs || videojs.__filemanagerBufferingConfigured) return;
4477 videojs.__filemanagerBufferingConfigured = true;
4478
4479 try
4480 {
4481 videojs.Vhs.GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
4482 videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
4483 } catch
4484 {
4485 // Ignore builds that do not expose VHS buffer configuration.
4486 }
3834 const shared = sharedVideoPlayer();
3835 if (!shared || typeof shared.configureVideoJsBuffering !== 'function') return;
3836 shared.configureVideoJsBuffering(videojs, {
3837 enabled: VIDEO_FORWARD_BUFFER_OVERRIDE_ENABLED,
3838 seconds: VIDEO_FORWARD_BUFFER_SECONDS,
3839 });
4487 3840 }
4488 3841
4489 3842 async function createVideoStreamSessionForItem (item)
@@ -370,697 +370,58 @@ function buildAuthHeaders ()
370
370
371function applyUserVideoTextTrackPrefs ()
371function applyUserVideoTextTrackPrefs ()
372{
372{
373 try
373 const shared = sharedVideoPlayer();
374 {
374 if (!shared || typeof shared.applyDefaultTextTrackPrefs !== 'function') return;
375 // Only override the two requested defaults and leave other settings at Video.js defaults.
375 shared.applyDefaultTextTrackPrefs();
376 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
377 } catch
378 {
379 // Ignore localStorage failures.
380 }
381}
382
383function normaliseTrackName (name)
384{
385 return String(name || '').trim().toLowerCase();
386}
376}
387
377
388function getTrackName (track)
378function sharedVideoPlayer ()
389{
379{
390 if (!track || typeof track !== 'object') return '';
380 return window.FilemanagerSharedVideoPlayer || null;
391 const label = String(track.label || '').trim();
392 if (label) return label;
393 const name = String(track.name || '').trim();
394 if (name) return name;
395 const language = String(track.language || '').trim();
396 if (language) return language;
397 const id = String(track.id || '').trim();
398 if (id) return id;
399 return '';
400}
401
402function trackListToArray (trackList)
403{
404 if (!trackList || typeof trackList.length !== 'number') return [];
405 const out = [];
406 for (let i = 0; i < trackList.length; i++)
407 {
408 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
409 if (track) out.push(track);
410 }
411 return out;
412}
413
414function subtitleTracksFromPlayer (player)
415{
416 if (!player || typeof player.textTracks !== 'function') return [];
417 return trackListToArray(player.textTracks()).filter((track) =>
418 {
419 const kind = String(track.kind || '').toLowerCase();
420 return kind === 'subtitles' || kind === 'captions';
421 });
422}
423
424function audioTracksFromPlayer (player)
425{
426 if (!player || typeof player.audioTracks !== 'function') return [];
427 return trackListToArray(player.audioTracks());
428}
429
430function applySavedSubtitleTrack (player, savedName)
431{
432 if (typeof savedName !== 'string') return;
433 const tracks = subtitleTracksFromPlayer(player);
434 if (!tracks.length) return;
435
436 const wanted = normaliseTrackName(savedName);
437 if (!wanted)
438 {
439 for (const track of tracks) track.mode = 'disabled';
440 return;
441 }
442
443 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
444 if (!match) return;
445
446 for (const track of tracks)
447 {
448 track.mode = track === match ? 'showing' : 'disabled';
449 }
450}
451
452function applySavedAudioTrack (player, savedName)
453{
454 if (typeof savedName !== 'string') return;
455 const tracks = audioTracksFromPlayer(player);
456 if (!tracks.length) return;
457
458 const wanted = normaliseTrackName(savedName);
459 if (!wanted) return;
460
461 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
462 if (!match) return;
463
464 for (const track of tracks)
465 {
466 track.enabled = track === match;
467 }
468}
469
470function getSelectedSubtitleTrackName (player)
471{
472 const tracks = subtitleTracksFromPlayer(player);
473 if (!tracks.length) return null;
474 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
475 return active ? getTrackName(active) : '';
476}
477
478function getSelectedAudioTrackName (player)
479{
480 const tracks = audioTracksFromPlayer(player);
481 if (!tracks.length) return null;
482 const active = tracks.find((track) => !!track.enabled);
483 return active ? getTrackName(active) : '';
484}
381}
485
382
486function bindUserVideoTrackPrefs (player, prefs)
383function bindUserVideoTrackPrefs (player, prefs)
487{
384{
488 const applySavedTracks = () =>
385 const shared = sharedVideoPlayer();
489 {
386 if (!shared || typeof shared.bindTrackPrefs !== 'function')
490 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
491 applySavedAudioTrack(player, prefs.audioTrackName);
492 };
493
494 const captureSelectedTracks = () =>
495 {
387 {
496 const subtitleTrackName = getSelectedSubtitleTrackName(player);
388 return {
497 const audioTrackName = getSelectedAudioTrackName(player);
389 applySavedTracks: () => {},
498 const patch = {};
390 captureSelectedTracks: () => {},
499
391 detach: () => {},
500 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
392 };
501 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
502
503 if (Object.keys(patch).length) saveUserVideoPrefs(patch);
504 };
505
506 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
507 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
508 const onTrackListChange = () => captureSelectedTracks();
509
510 if (textTrackList && typeof textTrackList.addEventListener === 'function')
511 {
512 textTrackList.addEventListener('change', onTrackListChange);
513 }
514
515 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
516 {
517 audioTrackList.addEventListener('change', onTrackListChange);
518 }
393 }
519
394 return shared.bindTrackPrefs(player, prefs, saveUserVideoPrefs);
520 return {
521 applySavedTracks,
522 captureSelectedTracks,
523 detach: () =>
524 {
525 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
526 {
527 textTrackList.removeEventListener('change', onTrackListChange);
528 }
529 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
530 {
531 audioTrackList.removeEventListener('change', onTrackListChange);
532 }
533 },
534 };
535}
395}
536
396
537function bindImageSubtitleOverlay (player, videojs, prefs, session, item)
397function bindImageSubtitleOverlay (player, videojs, prefs, session, item)
538{
398{
539 const imageTracks = Array.isArray(session.imageSubtitleTracks)
399 const shared = sharedVideoPlayer();
540 ? session.imageSubtitleTracks.map((track) => ({
400 if (!shared || typeof shared.bindImageSubtitleOverlay !== 'function') return null;
541 label: String(track.label || '').trim() || `Subtitle ${Number(track.streamIndex || 0) + 1}`,
401
542 language: String(track.language || '').trim(),
402 return shared.bindImageSubtitleOverlay(player, videojs, prefs, session, {
543 isDefault: !!track.default,
403 savePrefs: saveUserVideoPrefs,
544 streamIndex: Number(track.streamIndex),
404 buildFrameRequest: ({ currentTime, streamIndex, session: activeSession }) => ({
545 })).filter((track) => Number.isInteger(track.streamIndex) && track.streamIndex >= 0)
405 url: `/api/files/video-stream-subtitle-frame?filePath=${encodeURIComponent(item.path)}&streamIndex=${streamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(activeSession.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(activeSession.videoHeight || ''))}`,
546 : [];
406 headers: buildAuthHeaders(),
547
407 credentials: 'same-origin',
548 if (!imageTracks.length) return null;
408 }),
549
409 onError: () => toast('Image subtitles could not be rendered for this file.', 'err'),
550 const trackByStreamIndex = new Map(imageTracks.map((track) => [track.streamIndex, track]));
551 let selectedStreamIndex = null;
552 let menuOpen = false;
553 let requestToken = 0;
554 let activeBucket = -1;
555 let activeObjectUrl = null;
556 let overlayEl = null;
557 let overlayImgEl = null;
558 let menuEl = null;
559 let buttonEl = null;
560 let trackDisabled = false;
561 let failureNotified = false;
562
563 const closeObjectUrl = () =>
564 {
565 if (activeObjectUrl)
566 {
567 URL.revokeObjectURL(activeObjectUrl);
568 activeObjectUrl = null;
569 }
570 };
571
572 const hideOverlay = () =>
573 {
574 if (overlayEl) overlayEl.style.display = 'none';
575 if (overlayImgEl) overlayImgEl.removeAttribute('src');
576 closeObjectUrl();
577 };
578
579 const updateButtonState = () =>
580 {
581 if (!buttonEl) return;
582 const track = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
583 buttonEl.setAttribute('title', track ? `Image subtitles: ${track.label}` : 'Image subtitles');
584 buttonEl.setAttribute('aria-pressed', selectedStreamIndex === null ? 'false' : 'true');
585 };
586
587 const updateMenuState = () =>
588 {
589 if (!menuEl) return;
590 const items = menuEl.querySelectorAll('[data-image-subtitle-stream-index]');
591 for (const itemEl of items)
592 {
593 const value = itemEl.getAttribute('data-image-subtitle-stream-index');
594 const isSelected = value === (selectedStreamIndex === null ? 'off' : String(selectedStreamIndex));
595 itemEl.classList.toggle('is-selected', isSelected);
596 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
597 itemEl.style.background = isSelected ? 'rgba(90, 196, 255, 0.28)' : 'transparent';
598 itemEl.style.fontWeight = isSelected ? '600' : '400';
599 itemEl.style.boxShadow = isSelected ? 'inset 0 0 0 1px rgba(90, 196, 255, 0.55)' : 'none';
600 }
601 };
602
603 const closeMenu = () =>
604 {
605 menuOpen = false;
606 if (menuEl) menuEl.style.display = 'none';
607 };
608
609 const openMenu = () =>
610 {
611 menuOpen = true;
612 if (menuEl)
613 {
614 updateMenuState();
615 menuEl.style.display = 'block';
616 }
617 };
618
619 const toggleMenu = () =>
620 {
621 if (menuOpen) closeMenu();
622 else openMenu();
623 };
624
625 const saveSelection = () =>
626 {
627 const selectedTrack = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
628 saveUserVideoPrefs({
629 imageSubtitleTrackStreamIndex: selectedStreamIndex,
630 imageSubtitleTrackName: selectedTrack ? selectedTrack.label : null,
631 });
632 };
633
634 const disableTrack = () =>
635 {
636 trackDisabled = true;
637 selectedStreamIndex = null;
638 activeBucket = -1;
639 hideOverlay();
640 updateButtonState();
641 updateMenuState();
642 saveSelection();
643
644 if (!failureNotified)
645 {
646 failureNotified = true;
647 toast('Image subtitles could not be rendered for this file.', 'err');
648 }
649 };
650
651 const setSelectedStreamIndex = (streamIndex, { persist = true } = {}) =>
652 {
653 const nextStreamIndex = Number.isInteger(streamIndex) ? streamIndex : null;
654 if (nextStreamIndex !== null && !trackByStreamIndex.has(nextStreamIndex)) return;
655
656 trackDisabled = false;
657 failureNotified = false;
658 selectedStreamIndex = nextStreamIndex;
659 activeBucket = -1;
660 hideOverlay();
661 updateButtonState();
662 updateMenuState();
663 if (persist) saveSelection();
664
665 if (selectedStreamIndex !== null)
666 {
667 void refreshFrame(true);
668 }
669 };
670
671 const refreshFrame = async (force = false) =>
672 {
673 if (selectedStreamIndex === null) return;
674 if (!overlayEl || !overlayImgEl) return;
675 if (trackDisabled) return;
676
677 const currentTime = Number(player.currentTime());
678 if (!Number.isFinite(currentTime) || currentTime < 0) return;
679
680 const bucket = Math.floor(currentTime * 4);
681 if (!force && bucket === activeBucket) return;
682 activeBucket = bucket;
683
684 const token = ++requestToken;
685 const headers = buildAuthHeaders();
686 const url = `/api/files/video-stream-subtitle-frame?filePath=${encodeURIComponent(item.path)}&streamIndex=${selectedStreamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(session.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(session.videoHeight || ''))}`;
687
688 try
689 {
690 const res = await fetch(url, {
691 method: 'GET',
692 headers,
693 credentials: 'same-origin',
694 });
695
696 if (token !== requestToken) return;
697
698 if (res.status === 204)
699 {
700 const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase();
701 hideOverlay();
702 if (frameStatus === 'error') disableTrack();
703 return;
704 }
705
706 if (!res.ok)
707 {
708 disableTrack();
709 return;
710 }
711
712 const blob = await res.blob();
713 if (token !== requestToken) return;
714
715 if (!blob || blob.size === 0)
716 {
717 disableTrack();
718 return;
719 }
720
721 closeObjectUrl();
722 activeObjectUrl = URL.createObjectURL(blob);
723 overlayImgEl.src = activeObjectUrl;
724
725 // Apply placement from headers when available
726 const frameLeft = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Left') || ''), 10);
727 const frameTop = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Top') || ''), 10);
728 const frameWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Width') || ''), 10);
729 const frameHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Height') || ''), 10);
730 const canvasWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Width') || ''), 10);
731 const canvasHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Height') || ''), 10);
732
733 if (frameWidth > 0 && frameHeight > 0 && canvasWidth > 0 && canvasHeight > 0)
734 {
735 // Apply percentage-based sizing to scale the downscaled image properly
736 const widthPercent = (frameWidth / canvasWidth) * 100;
737 const heightPercent = (frameHeight / canvasHeight) * 100;
738 overlayImgEl.style.width = `${widthPercent}%`;
739 overlayImgEl.style.height = `${heightPercent}%`;
740 overlayImgEl.style.maxWidth = 'none';
741 overlayImgEl.style.maxHeight = 'none';
742 }
743 else
744 {
745 // Fallback: use auto sizing with max constraints
746 overlayImgEl.style.width = 'auto';
747 overlayImgEl.style.height = 'auto';
748 overlayImgEl.style.maxWidth = '100%';
749 overlayImgEl.style.maxHeight = '100%';
750 }
751
752 overlayEl.style.display = 'block';
753 overlayImgEl.style.display = 'block';
754 } catch
755 {
756 if (token === requestToken) disableTrack();
757 }
758 };
759
760 const dispose = () =>
761 {
762 requestToken++;
763 closeMenu();
764 hideOverlay();
765 if (overlayEl) overlayEl.remove();
766 if (menuEl) menuEl.remove();
767 player.imageSubtitleOverlayController = null;
768 buttonEl = null;
769 };
770
771 overlayEl = document.createElement('div');
772 overlayEl.className = 'video-subtitle-overlay';
773 overlayEl.style.position = 'absolute';
774 overlayEl.style.left = '0';
775 overlayEl.style.right = '0';
776 overlayEl.style.bottom = '3rem';
777 overlayEl.style.display = 'none';
778 overlayEl.style.zIndex = '3';
779 overlayEl.style.pointerEvents = 'none';
780 overlayEl.style.textAlign = 'center';
781 overlayEl.style.padding = '0 0.75rem';
782 overlayEl.style.maxHeight = '70%';
783 overlayEl.style.overflow = 'hidden';
784
785 overlayImgEl = document.createElement('img');
786 overlayImgEl.alt = 'Image subtitles';
787 overlayImgEl.style.display = 'none';
788 overlayImgEl.style.margin = '0 auto';
789 overlayImgEl.style.objectFit = 'contain';
790 overlayImgEl.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))';
791 overlayImgEl.style.maxWidth = '100%';
792 overlayImgEl.style.height = 'auto';
793 overlayEl.appendChild(overlayImgEl);
794
795 menuEl = document.createElement('div');
796 menuEl.className = 'video-subtitle-overlay-menu';
797 menuEl.style.position = 'absolute';
798 menuEl.style.right = '0.75rem';
799 menuEl.style.bottom = 'calc(3rem + 0.5rem)';
800 menuEl.style.minWidth = '14rem';
801 menuEl.style.maxWidth = '20rem';
802 menuEl.style.background = 'rgba(12, 12, 12, 0.96)';
803 menuEl.style.border = '1px solid rgba(255, 255, 255, 0.15)';
804 menuEl.style.borderRadius = '0.5rem';
805 menuEl.style.boxShadow = '0 12px 28px rgba(0, 0, 0, 0.35)';
806 menuEl.style.padding = '0.35rem';
807 menuEl.style.display = 'none';
808 menuEl.style.zIndex = '4';
809
810 const buildMenuItem = (label, streamIndex, isSelected) =>
811 {
812 const itemEl = document.createElement('button');
813 itemEl.type = 'button';
814 itemEl.className = 'video-subtitle-overlay-menu-item';
815 itemEl.setAttribute('data-image-subtitle-stream-index', streamIndex === null ? 'off' : String(streamIndex));
816 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
817 itemEl.style.display = 'block';
818 itemEl.style.width = '100%';
819 itemEl.style.margin = '0';
820 itemEl.style.padding = '0.5rem 0.75rem';
821 itemEl.style.border = '0';
822 itemEl.style.borderRadius = '0.35rem';
823 itemEl.style.background = isSelected ? 'rgba(255, 255, 255, 0.18)' : 'transparent';
824 itemEl.style.color = '#fff';
825 itemEl.style.textAlign = 'left';
826 itemEl.style.cursor = 'pointer';
827 itemEl.textContent = label;
828 itemEl.addEventListener('click', () =>
829 {
830 setSelectedStreamIndex(streamIndex);
831 closeMenu();
832 });
833 return itemEl;
834 };
835
836 menuEl.appendChild(buildMenuItem('Off', null, false));
837 for (const track of imageTracks)
838 {
839 menuEl.appendChild(buildMenuItem(track.label, track.streamIndex, false));
840 }
841
842 const registerButton = () =>
843 {
844 if (!videojs || typeof videojs.getComponent !== 'function' || typeof videojs.registerComponent !== 'function') return;
845 if (videojs.getComponent('ImageSubtitleButton')) return;
846
847 const Button = videojs.getComponent('Button');
848 class ImageSubtitleButton extends Button
849 {
850 buildCSSClass ()
851 {
852 return `${super.buildCSSClass()} vjs-image-subtitle-button`;
853 }
854
855 createEl ()
856 {
857 const el = super.createEl();
858 el.type = 'button';
859 el.setAttribute('title', 'Image subtitles');
860 el.setAttribute('aria-label', 'Image subtitles');
861 el.innerHTML = '<span aria-hidden="true">IM</span>';
862 return el;
863 }
864
865 handleClick ()
866 {
867 const controller = this.player().imageSubtitleOverlayController;
868 if (controller) controller.toggleMenu();
869 }
870 }
871
872 videojs.registerComponent('ImageSubtitleButton', ImageSubtitleButton);
873 };
874
875 const attachUi = () =>
876 {
877 if (!player.el()) return;
878 registerButton();
879 if (overlayEl.parentElement !== player.el()) player.el().appendChild(overlayEl);
880 if (menuEl.parentElement !== player.el()) player.el().appendChild(menuEl);
881 const controlBar = typeof player.getChild === 'function' ? player.getChild('controlBar') : null;
882 if (controlBar && typeof controlBar.addChild === 'function' && !buttonEl)
883 {
884 const button = controlBar.addChild('ImageSubtitleButton', {});
885 buttonEl = button && typeof button.el === 'function' ? button.el() : null;
886 updateButtonState();
887 }
888 };
889
890 const applySavedTracks = () =>
891 {
892 const savedName = normaliseTrackName(prefs.imageSubtitleTrackName);
893 if (savedName)
894 {
895 const savedByName = imageTracks.find((track) => normaliseTrackName(track.label) === savedName) || null;
896 if (savedByName)
897 {
898 setSelectedStreamIndex(savedByName.streamIndex, { persist: false });
899 return;
900 }
901 }
902
903 const savedIndex = Number(prefs.imageSubtitleTrackStreamIndex);
904 if (Number.isInteger(savedIndex) && trackByStreamIndex.has(savedIndex))
905 {
906 setSelectedStreamIndex(savedIndex, { persist: false });
907 return;
908 }
909
910 const defaultTrack = imageTracks.find((track) => track.isDefault) || null;
911 if (defaultTrack)
912 {
913 setSelectedStreamIndex(defaultTrack.streamIndex, { persist: false });
914 return;
915 }
916
917 setSelectedStreamIndex(null, { persist: false });
918 };
919
920 player.imageSubtitleOverlayController = {
921 toggleMenu,
922 closeMenu,
923 applySavedTracks,
924 captureSelectedTracks: saveSelection,
925 detach: dispose,
926 };
927
928 player.on('timeupdate', () => { void refreshFrame(); });
929 player.on('seeking', () => { void refreshFrame(true); });
930 player.on('play', () => { void refreshFrame(true); });
931 player.on('fullscreenchange', () => { closeMenu(); void refreshFrame(true); });
932 player.on('dispose', dispose);
933 player.ready(() =>
934 {
935 attachUi();
936 updateMenuState();
937 updateButtonState();
938 applySavedTracks();
939 if (menuOpen) openMenu();
940 });
410 });
941
942 return player.imageSubtitleOverlayController;
943}
411}
944
412
945function normaliseVideoDuration (player, durationSeconds)
413function normaliseVideoDuration (player, durationSeconds)
946{
414{
947 const duration = Number(durationSeconds);
415 const shared = sharedVideoPlayer();
948 if (!player || !Number.isFinite(duration) || duration <= 0) return;
416 if (!shared || typeof shared.normaliseVideoDuration !== 'function') return;
949
417 shared.normaliseVideoDuration(player, durationSeconds);
950 let originalDuration = null;
951 let durationWasChanged = false;
952 try
953 {
954 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
955 installDurationFallback(player, originalDuration, duration);
956 if (player.__filemanagerDurationApplied) return;
957
958 const current = originalDuration ? Number(originalDuration()) : NaN;
959 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
960 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
961 if (withinTolerance)
962 {
963 player.__filemanagerDurationApplied = true;
964 return;
965 }
966
967 if (originalDuration)
968 {
969 durationWasChanged = true;
970 originalDuration(duration);
971 }
972 } catch
973 {
974 // Ignore players that do not support setting duration.
975 }
976
977 try
978 {
979 const updated = originalDuration ? Number(originalDuration()) : NaN;
980 if (Number.isFinite(updated) && updated >= duration * 0.95)
981 {
982 player.__filemanagerDurationApplied = true;
983 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
984 return;
985 }
986
987 player.__filemanagerDurationApplied = true;
988 if (typeof player.trigger === 'function') player.trigger('durationchange');
989 } catch
990 {
991 // Ignore duration fallback failures.
992 }
993}
994
995function installDurationFallback (player, originalDuration, duration)
996{
997 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
998
999 player.__filemanagerDurationFallback = true;
1000 player.duration = function durationWithFallback (...args)
1001 {
1002 if (args.length) return originalDuration(...args);
1003 const current = Number(originalDuration());
1004 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
1005 };
1006}
1007
1008function formatDurationForDebug (seconds)
1009{
1010 const value = Number(seconds);
1011 if (!Number.isFinite(value) || value < 0) return 'unknown';
1012
1013 const totalSeconds = Math.floor(value);
1014 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
1015 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
1016 const ss = String(totalSeconds % 60).padStart(2, '0');
1017 return `${hh}:${mm}:${ss}`;
1018}
418}
1019
419
1020function ensureVideoPlaybackUi (player, durationSeconds)
420function ensureVideoPlaybackUi (player, durationSeconds)
1021{
421{
1022 if (!player || typeof player.on !== 'function') return;
422 const shared = sharedVideoPlayer();
1023
423 if (!shared || typeof shared.ensureVideoPlaybackUi !== 'function') return;
1024 const forceVodUi = () =>
424 shared.ensureVideoPlaybackUi(player, durationSeconds);
1025 {
1026 normaliseVideoDuration(player, durationSeconds);
1027
1028 try
1029 {
1030 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
1031 {
1032 player.liveTracker.stopTracking();
1033 }
1034 } catch
1035 {
1036 // Ignore live tracker availability issues.
1037 }
1038
1039 try
1040 {
1041 if (typeof player.removeClass === 'function')
1042 {
1043 player.removeClass('vjs-live');
1044 }
1045 } catch
1046 {
1047 // Ignore class update failures.
1048 }
1049
1050 try
1051 {
1052 const display = player.el() && player.el().querySelector('.vjs-live-display');
1053 if (display) display.style.display = 'none';
1054 } catch
1055 {
1056 // Ignore missing DOM.
1057 }
1058 };
1059
1060 player.ready(forceVodUi);
1061 player.on('loadedmetadata', forceVodUi);
1062 player.on('durationchange', forceVodUi);
1063 player.on('loadedplaylist', forceVodUi);
1064}
425}
1065
426
1066async function reportWatchProgress (filePath, progress)
427async function reportWatchProgress (filePath, progress)
@@ -4470,20 +3831,12 @@ async function ensureVideoJsLoaded ()
4470
3831
4471function configureVideoJsBuffering (videojs)
3832function configureVideoJsBuffering (videojs)
4472{
3833{
4473 if (!VIDEO_FORWARD_BUFFER_OVERRIDE_ENABLED)
3834 const shared = sharedVideoPlayer();
4474 return;
3835 if (!shared || typeof shared.configureVideoJsBuffering !== 'function') return;
4475
3836 shared.configureVideoJsBuffering(videojs, {
4476 if (!videojs || !videojs.Vhs || videojs.__filemanagerBufferingConfigured) return;
3837 enabled: VIDEO_FORWARD_BUFFER_OVERRIDE_ENABLED,
4477 videojs.__filemanagerBufferingConfigured = true;
3838 seconds: VIDEO_FORWARD_BUFFER_SECONDS,
4478
3839 });
4479 try
4480 {
4481 videojs.Vhs.GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
4482 videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
4483 } catch
4484 {
4485 // Ignore builds that do not expose VHS buffer configuration.
4486 }
4487}
3840}
4488
3841
4489async function createVideoStreamSessionForItem (item)
3842async function createVideoStreamSessionForItem (item)
public/index.html +1 −0
@@ -433,6 +433,7 @@
433 433 }
434 434 </script>
435 435 <script src="drag-move.js"></script>
436 <script src="shared-video-player.js"></script>
436 437 <script src="app.js"></script>
437 438 </body>
438 439
@@ -433,6 +433,7 @@
433 }
433 }
434 </script>
434 </script>
435 <script src="drag-move.js"></script>
435 <script src="drag-move.js"></script>
436 <script src="shared-video-player.js"></script>
436 <script src="app.js"></script>
437 <script src="app.js"></script>
437</body>
438</body>
438
439
public/share.html +61 −276
@@ -241,6 +241,7 @@
241 241 </div>
242 242 </div>
243 243
244 <script src="/shared-video-player.js"></script>
244 245 <script>
245 246 (function ()
246 247 {
@@ -249,15 +250,17 @@
249 250 const token = location.pathname.split('/').pop();
250 251 const VIDEO_FORWARD_BUFFER_SECONDS = 60 * 60;
251 252 const SHARE_VIDEO_PREFS_KEY = 'filemanager.share-video-prefs.v1';
252 const VIDEO_TEXT_TRACK_SETTINGS_KEY = 'vjs-text-track-settings';
253 const VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW = JSON.stringify({
254 backgroundOpacity: '0',
255 edgeStyle: 'uniform',
256 });
257 253 let expiresAt = null;
258 254 let timerInterval = null;
259 255 let shareVideoPlayer = null;
260 256 let shareTrackPrefs = null;
257 let shareImageSubtitleController = null;
258 let shareVideoSessionId = null;
259
260 function sharedVideoPlayer ()
261 {
262 return window.FilemanagerSharedVideoPlayer || null;
263 }
261 264
262 265 function loadShareVideoPrefs ()
263 266 {
@@ -287,195 +290,60 @@
287 290
288 291 function applyShareVideoTextTrackPrefs ()
289 292 {
290 try
291 {
292 // Only override the two requested defaults and leave other settings at Video.js defaults.
293 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
294 } catch
295 {
296 // Ignore localStorage failures.
297 }
298 }
299
300 function normaliseTrackName (name)
301 {
302 return String(name || '').trim().toLowerCase();
303 }
304
305 function getTrackName (track)
306 {
307 if (!track || typeof track !== 'object') return '';
308 const label = String(track.label || '').trim();
309 if (label) return label;
310 const name = String(track.name || '').trim();
311 if (name) return name;
312 const language = String(track.language || '').trim();
313 if (language) return language;
314 const id = String(track.id || '').trim();
315 if (id) return id;
316 return '';
293 const shared = sharedVideoPlayer();
294 if (!shared || typeof shared.applyDefaultTextTrackPrefs !== 'function') return;
295 shared.applyDefaultTextTrackPrefs();
317 296 }
318 297
319 function trackListToArray (trackList)
320 {
321 if (!trackList || typeof trackList.length !== 'number') return [];
322 const out = [];
323 for (let i = 0; i < trackList.length; i++)
324 {
325 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
326 if (track) out.push(track);
327 }
328 return out;
329 }
330
331 function subtitleTracksFromPlayer (player)
332 {
333 if (!player || typeof player.textTracks !== 'function') return [];
334 return trackListToArray(player.textTracks()).filter((track) =>
335 {
336 const kind = String(track.kind || '').toLowerCase();
337 return kind === 'subtitles' || kind === 'captions';
338 });
339 }
340
341 function audioTracksFromPlayer (player)
342 {
343 if (!player || typeof player.audioTracks !== 'function') return [];
344 return trackListToArray(player.audioTracks());
345 }
346
347 function applySavedSubtitleTrack (player, savedName)
348 {
349 if (typeof savedName !== 'string') return;
350 const tracks = subtitleTracksFromPlayer(player);
351 if (!tracks.length) return;
352
353 const wanted = normaliseTrackName(savedName);
354 if (!wanted)
355 {
356 for (const track of tracks) track.mode = 'disabled';
357 return;
358 }
359
360 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
361 if (!match) return;
362
363 for (const track of tracks)
364 {
365 track.mode = track === match ? 'showing' : 'disabled';
366 }
367 }
368
369 function applySavedAudioTrack (player, savedName)
298 function bindShareVideoTrackPrefs (player, prefs)
370 299 {
371 if (typeof savedName !== 'string') return;
372 const tracks = audioTracksFromPlayer(player);
373 if (!tracks.length) return;
374
375 const wanted = normaliseTrackName(savedName);
376 if (!wanted) return;
377
378 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
379 if (!match) return;
380
381 for (const track of tracks)
300 const shared = sharedVideoPlayer();
301 if (!shared || typeof shared.bindTrackPrefs !== 'function')
382 302 {
383 track.enabled = track === match;
303 return {
304 applySavedTracks: () => {},
305 captureSelectedTracks: () => {},
306 detach: () => {},
307 };
384 308 }
309 return shared.bindTrackPrefs(player, prefs, saveShareVideoPrefs);
385 310 }
386 311
387 function getSelectedSubtitleTrackName (player)
312 function releaseShareVideoSession (sessionId, opts = {})
388 313 {
389 const tracks = subtitleTracksFromPlayer(player);
390 if (!tracks.length) return null;
391 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
392 return active ? getTrackName(active) : '';
393 }
394
395 function getSelectedAudioTrackName (player)
396 {
397 const tracks = audioTracksFromPlayer(player);
398 if (!tracks.length) return null;
399 const active = tracks.find((track) => !!track.enabled);
400 return active ? getTrackName(active) : '';
401 }
402
403 function bindShareVideoTrackPrefs (player, prefs)
404 {
405 const applySavedTracks = () =>
406 {
407 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
408 applySavedAudioTrack(player, prefs.audioTrackName);
409 };
410
411 const captureSelectedTracks = () =>
412 {
413 const subtitleTrackName = getSelectedSubtitleTrackName(player);
414 const audioTrackName = getSelectedAudioTrackName(player);
415 const patch = {};
416
417 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
418 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
419
420 if (Object.keys(patch).length) saveShareVideoPrefs(patch);
421 };
422
423 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
424 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
425 const onTrackListChange = () => captureSelectedTracks();
426
427 if (textTrackList && typeof textTrackList.addEventListener === 'function')
428 {
429 textTrackList.addEventListener('change', onTrackListChange);
430 }
431
432 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
433 {
434 audioTrackList.addEventListener('change', onTrackListChange);
435 }
436
437 return {
438 applySavedTracks,
439 captureSelectedTracks,
440 detach: () =>
441 {
442 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
443 {
444 textTrackList.removeEventListener('change', onTrackListChange);
445 }
446 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
447 {
448 audioTrackList.removeEventListener('change', onTrackListChange);
449 }
450 },
451 };
314 const id = String(sessionId || '').trim();
315 if (!id) return Promise.resolve();
316
317 return fetch(`/api/share/video-stream/session/${encodeURIComponent(id)}`, {
318 method: 'DELETE',
319 credentials: 'same-origin',
320 keepalive: !!opts.keepalive,
321 }).catch(() => null);
452 322 }
453 323
454 324 function cleanupShareVideoPlayer ()
455 325 {
456 if (!shareVideoPlayer) return;
326 const sessionId = shareVideoSessionId;
327 shareVideoSessionId = null;
457 328
329 try { shareImageSubtitleController && shareImageSubtitleController.captureSelectedTracks(); } catch { /* ignore */ }
330 try { shareImageSubtitleController && shareImageSubtitleController.detach(); } catch { /* ignore */ }
458 331 try { shareTrackPrefs && shareTrackPrefs.captureSelectedTracks(); } catch { /* ignore */ }
459 332 try { shareTrackPrefs && shareTrackPrefs.detach(); } catch { /* ignore */ }
460 try { shareVideoPlayer.dispose(); } catch { /* ignore */ }
333 try { shareVideoPlayer && shareVideoPlayer.dispose(); } catch { /* ignore */ }
334
335 if (sessionId) void releaseShareVideoSession(sessionId, { keepalive: true });
461 336
462 337 shareVideoPlayer = null;
463 338 shareTrackPrefs = null;
339 shareImageSubtitleController = null;
464 340 }
465 341
466 342 function configureVideoJsBuffering ()
467 343 {
468 if (!window.videojs || !window.videojs.Vhs || window.videojs.__filemanagerBufferingConfigured) return;
469 window.videojs.__filemanagerBufferingConfigured = true;
470
471 try
472 {
473 window.videojs.Vhs.GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
474 window.videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
475 } catch
476 {
477 // Ignore builds that do not expose VHS buffer configuration.
478 }
344 const shared = sharedVideoPlayer();
345 if (!shared || typeof shared.configureVideoJsBuffering !== 'function') return;
346 shared.configureVideoJsBuffering(window.videojs, { seconds: VIDEO_FORWARD_BUFFER_SECONDS });
479 347 }
480 348
481 349 // ── Timer ───────────────────────────────────────────────────────────────
@@ -512,114 +380,16 @@
512 380 // ── Preview ──────────────────────────────────────────────────────────────
513 381 function normaliseVideoDuration (player, durationSeconds)
514 382 {
515 const duration = Number(durationSeconds);
516 if (!player || !Number.isFinite(duration) || duration <= 0) return;
517
518 let originalDuration = null;
519 let durationWasChanged = false;
520 try
521 {
522 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
523 installDurationFallback(player, originalDuration, duration);
524 if (player.__filemanagerDurationApplied) return;
525
526 const current = originalDuration ? Number(originalDuration()) : NaN;
527 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
528 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
529 if (withinTolerance)
530 {
531 player.__filemanagerDurationApplied = true;
532 return;
533 }
534
535 if (originalDuration)
536 {
537 durationWasChanged = true;
538 originalDuration(duration);
539 }
540 } catch
541 {
542 // Ignore players that do not support setting duration.
543 }
544
545 try
546 {
547 const updated = originalDuration ? Number(originalDuration()) : NaN;
548 if (Number.isFinite(updated) && updated >= duration * 0.95)
549 {
550 player.__filemanagerDurationApplied = true;
551 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
552 return;
553 }
554
555 player.__filemanagerDurationApplied = true;
556 if (typeof player.trigger === 'function') player.trigger('durationchange');
557 } catch
558 {
559 // Ignore duration fallback failures.
560 }
561 }
562
563 function installDurationFallback (player, originalDuration, duration)
564 {
565 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
566
567 player.__filemanagerDurationFallback = true;
568 player.duration = function durationWithFallback (...args)
569 {
570 if (args.length) return originalDuration(...args);
571 const current = Number(originalDuration());
572 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
573 };
574 }
575
576 function formatDurationForDebug (seconds)
577 {
578 const value = Number(seconds);
579 if (!Number.isFinite(value) || value < 0) return 'unknown';
580
581 const totalSeconds = Math.floor(value);
582 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
583 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
584 const ss = String(totalSeconds % 60).padStart(2, '0');
585 return `${hh}:${mm}:${ss}`;
383 const shared = sharedVideoPlayer();
384 if (!shared || typeof shared.normaliseVideoDuration !== 'function') return;
385 shared.normaliseVideoDuration(player, durationSeconds);
586 386 }
587 387
588 388 function ensureVideoPlaybackUi (player, durationSeconds)
589 389 {
590 if (!player || typeof player.on !== 'function') return;
591
592 const forceVodUi = () =>
593 {
594 normaliseVideoDuration(player, durationSeconds);
595
596 try
597 {
598 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
599 {
600 player.liveTracker.stopTracking();
601 }
602 } catch
603 {
604 // Ignore live tracker availability issues.
605 }
606
607 try
608 {
609 if (typeof player.removeClass === 'function')
610 {
611 player.removeClass('vjs-live');
612 }
613 } catch
614 {
615 // Ignore class update failures.
616 }
617 };
618
619 player.ready(forceVodUi);
620 player.on('loadedmetadata', forceVodUi);
621 player.on('durationchange', forceVodUi);
622 player.on('loadedplaylist', forceVodUi);
390 const shared = sharedVideoPlayer();
391 if (!shared || typeof shared.ensureVideoPlaybackUi !== 'function') return;
392 shared.ensureVideoPlaybackUi(player, durationSeconds);
623 393 }
624 394
625 395 function tryPreview (name, isDir)
@@ -663,6 +433,7 @@
663 433 wrap.appendChild(video);
664 434
665 435 cleanupShareVideoPlayer();
436 shareVideoSessionId = String(data.sessionId || '').trim() || null;
666 437
667 438 shareVideoPlayer = window.videojs(video, {
668 439 controls: true,
@@ -686,6 +457,16 @@
686 457 });
687 458
688 459 shareTrackPrefs = bindShareVideoTrackPrefs(shareVideoPlayer, prefs);
460 const shared = sharedVideoPlayer();
461 shareImageSubtitleController = shared && typeof shared.bindImageSubtitleOverlay === 'function'
462 ? shared.bindImageSubtitleOverlay(shareVideoPlayer, window.videojs, prefs, data, {
463 savePrefs: saveShareVideoPrefs,
464 buildFrameRequest: ({ currentTime, streamIndex, session }) => ({
465 url: `/api/share/video-stream-subtitle-frame/${encodeURIComponent(token)}?streamIndex=${streamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(session.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(session.videoHeight || ''))}`,
466 credentials: 'same-origin',
467 }),
468 })
469 : null;
689 470 ensureVideoPlaybackUi(shareVideoPlayer, data.durationSeconds);
690 471
691 472 shareVideoPlayer.ready(() =>
@@ -696,6 +477,10 @@
696 477 shareVideoPlayer.volume(Math.max(0, Math.min(1, volume)));
697 478 }
698 479 shareTrackPrefs.applySavedTracks();
480 if (shareImageSubtitleController && typeof shareImageSubtitleController.applySavedTracks === 'function')
481 {
482 shareImageSubtitleController.applySavedTracks();
483 }
699 484 });
700 485
701 486 shareVideoPlayer.on('loadedmetadata', shareTrackPrefs.applySavedTracks);
@@ -241,6 +241,7 @@
241 </div>
241 </div>
242 </div>
242 </div>
243
243
244 <script src="/shared-video-player.js"></script>
244 <script>
245 <script>
245 (function ()
246 (function ()
246 {
247 {
@@ -249,15 +250,17 @@
249 const token = location.pathname.split('/').pop();
250 const token = location.pathname.split('/').pop();
250 const VIDEO_FORWARD_BUFFER_SECONDS = 60 * 60;
251 const VIDEO_FORWARD_BUFFER_SECONDS = 60 * 60;
251 const SHARE_VIDEO_PREFS_KEY = 'filemanager.share-video-prefs.v1';
252 const SHARE_VIDEO_PREFS_KEY = 'filemanager.share-video-prefs.v1';
252 const VIDEO_TEXT_TRACK_SETTINGS_KEY = 'vjs-text-track-settings';
253 const VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW = JSON.stringify({
254 backgroundOpacity: '0',
255 edgeStyle: 'uniform',
256 });
257 let expiresAt = null;
253 let expiresAt = null;
258 let timerInterval = null;
254 let timerInterval = null;
259 let shareVideoPlayer = null;
255 let shareVideoPlayer = null;
260 let shareTrackPrefs = null;
256 let shareTrackPrefs = null;
257 let shareImageSubtitleController = null;
258 let shareVideoSessionId = null;
259
260 function sharedVideoPlayer ()
261 {
262 return window.FilemanagerSharedVideoPlayer || null;
263 }
261
264
262 function loadShareVideoPrefs ()
265 function loadShareVideoPrefs ()
263 {
266 {
@@ -287,195 +290,60 @@
287
290
288 function applyShareVideoTextTrackPrefs ()
291 function applyShareVideoTextTrackPrefs ()
289 {
292 {
290 try
293 const shared = sharedVideoPlayer();
291 {
294 if (!shared || typeof shared.applyDefaultTextTrackPrefs !== 'function') return;
292 // Only override the two requested defaults and leave other settings at Video.js defaults.
295 shared.applyDefaultTextTrackPrefs();
293 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
294 } catch
295 {
296 // Ignore localStorage failures.
297 }
298 }
299
300 function normaliseTrackName (name)
301 {
302 return String(name || '').trim().toLowerCase();
303 }
304
305 function getTrackName (track)
306 {
307 if (!track || typeof track !== 'object') return '';
308 const label = String(track.label || '').trim();
309 if (label) return label;
310 const name = String(track.name || '').trim();
311 if (name) return name;
312 const language = String(track.language || '').trim();
313 if (language) return language;
314 const id = String(track.id || '').trim();
315 if (id) return id;
316 return '';
317 }
296 }
318
297
319 function trackListToArray (trackList)
298 function bindShareVideoTrackPrefs (player, prefs)
320 {
321 if (!trackList || typeof trackList.length !== 'number') return [];
322 const out = [];
323 for (let i = 0; i < trackList.length; i++)
324 {
325 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
326 if (track) out.push(track);
327 }
328 return out;
329 }
330
331 function subtitleTracksFromPlayer (player)
332 {
333 if (!player || typeof player.textTracks !== 'function') return [];
334 return trackListToArray(player.textTracks()).filter((track) =>
335 {
336 const kind = String(track.kind || '').toLowerCase();
337 return kind === 'subtitles' || kind === 'captions';
338 });
339 }
340
341 function audioTracksFromPlayer (player)
342 {
343 if (!player || typeof player.audioTracks !== 'function') return [];
344 return trackListToArray(player.audioTracks());
345 }
346
347 function applySavedSubtitleTrack (player, savedName)
348 {
349 if (typeof savedName !== 'string') return;
350 const tracks = subtitleTracksFromPlayer(player);
351 if (!tracks.length) return;
352
353 const wanted = normaliseTrackName(savedName);
354 if (!wanted)
355 {
356 for (const track of tracks) track.mode = 'disabled';
357 return;
358 }
359
360 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
361 if (!match) return;
362
363 for (const track of tracks)
364 {
365 track.mode = track === match ? 'showing' : 'disabled';
366 }
367 }
368
369 function applySavedAudioTrack (player, savedName)
370 {
299 {
371 if (typeof savedName !== 'string') return;
300 const shared = sharedVideoPlayer();
372 const tracks = audioTracksFromPlayer(player);
301 if (!shared || typeof shared.bindTrackPrefs !== 'function')
373 if (!tracks.length) return;
374
375 const wanted = normaliseTrackName(savedName);
376 if (!wanted) return;
377
378 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
379 if (!match) return;
380
381 for (const track of tracks)
382 {
302 {
383 track.enabled = track === match;
303 return {
304 applySavedTracks: () => {},
305 captureSelectedTracks: () => {},
306 detach: () => {},
307 };
384 }
308 }
309 return shared.bindTrackPrefs(player, prefs, saveShareVideoPrefs);
385 }
310 }
386
311
387 function getSelectedSubtitleTrackName (player)
312 function releaseShareVideoSession (sessionId, opts = {})
388 {
313 {
389 const tracks = subtitleTracksFromPlayer(player);
314 const id = String(sessionId || '').trim();
390 if (!tracks.length) return null;
315 if (!id) return Promise.resolve();
391 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
316
392 return active ? getTrackName(active) : '';
317 return fetch(`/api/share/video-stream/session/${encodeURIComponent(id)}`, {
393 }
318 method: 'DELETE',
394
319 credentials: 'same-origin',
395 function getSelectedAudioTrackName (player)
320 keepalive: !!opts.keepalive,
396 {
321 }).catch(() => null);
397 const tracks = audioTracksFromPlayer(player);
398 if (!tracks.length) return null;
399 const active = tracks.find((track) => !!track.enabled);
400 return active ? getTrackName(active) : '';
401 }
402
403 function bindShareVideoTrackPrefs (player, prefs)
404 {
405 const applySavedTracks = () =>
406 {
407 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
408 applySavedAudioTrack(player, prefs.audioTrackName);
409 };
410
411 const captureSelectedTracks = () =>
412 {
413 const subtitleTrackName = getSelectedSubtitleTrackName(player);
414 const audioTrackName = getSelectedAudioTrackName(player);
415 const patch = {};
416
417 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
418 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
419
420 if (Object.keys(patch).length) saveShareVideoPrefs(patch);
421 };
422
423 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
424 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
425 const onTrackListChange = () => captureSelectedTracks();
426
427 if (textTrackList && typeof textTrackList.addEventListener === 'function')
428 {
429 textTrackList.addEventListener('change', onTrackListChange);
430 }
431
432 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
433 {
434 audioTrackList.addEventListener('change', onTrackListChange);
435 }
436
437 return {
438 applySavedTracks,
439 captureSelectedTracks,
440 detach: () =>
441 {
442 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
443 {
444 textTrackList.removeEventListener('change', onTrackListChange);
445 }
446 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
447 {
448 audioTrackList.removeEventListener('change', onTrackListChange);
449 }
450 },
451 };
452 }
322 }
453
323
454 function cleanupShareVideoPlayer ()
324 function cleanupShareVideoPlayer ()
455 {
325 {
456 if (!shareVideoPlayer) return;
326 const sessionId = shareVideoSessionId;
327 shareVideoSessionId = null;
457
328
329 try { shareImageSubtitleController && shareImageSubtitleController.captureSelectedTracks(); } catch { /* ignore */ }
330 try { shareImageSubtitleController && shareImageSubtitleController.detach(); } catch { /* ignore */ }
458 try { shareTrackPrefs && shareTrackPrefs.captureSelectedTracks(); } catch { /* ignore */ }
331 try { shareTrackPrefs && shareTrackPrefs.captureSelectedTracks(); } catch { /* ignore */ }
459 try { shareTrackPrefs && shareTrackPrefs.detach(); } catch { /* ignore */ }
332 try { shareTrackPrefs && shareTrackPrefs.detach(); } catch { /* ignore */ }
460 try { shareVideoPlayer.dispose(); } catch { /* ignore */ }
333 try { shareVideoPlayer && shareVideoPlayer.dispose(); } catch { /* ignore */ }
334
335 if (sessionId) void releaseShareVideoSession(sessionId, { keepalive: true });
461
336
462 shareVideoPlayer = null;
337 shareVideoPlayer = null;
463 shareTrackPrefs = null;
338 shareTrackPrefs = null;
339 shareImageSubtitleController = null;
464 }
340 }
465
341
466 function configureVideoJsBuffering ()
342 function configureVideoJsBuffering ()
467 {
343 {
468 if (!window.videojs || !window.videojs.Vhs || window.videojs.__filemanagerBufferingConfigured) return;
344 const shared = sharedVideoPlayer();
469 window.videojs.__filemanagerBufferingConfigured = true;
345 if (!shared || typeof shared.configureVideoJsBuffering !== 'function') return;
470
346 shared.configureVideoJsBuffering(window.videojs, { seconds: VIDEO_FORWARD_BUFFER_SECONDS });
471 try
472 {
473 window.videojs.Vhs.GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
474 window.videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = VIDEO_FORWARD_BUFFER_SECONDS;
475 } catch
476 {
477 // Ignore builds that do not expose VHS buffer configuration.
478 }
479 }
347 }
480
348
481 // ── Timer ───────────────────────────────────────────────────────────────
349 // ── Timer ───────────────────────────────────────────────────────────────
@@ -512,114 +380,16 @@
512 // ── Preview ──────────────────────────────────────────────────────────────
380 // ── Preview ──────────────────────────────────────────────────────────────
513 function normaliseVideoDuration (player, durationSeconds)
381 function normaliseVideoDuration (player, durationSeconds)
514 {
382 {
515 const duration = Number(durationSeconds);
383 const shared = sharedVideoPlayer();
516 if (!player || !Number.isFinite(duration) || duration <= 0) return;
384 if (!shared || typeof shared.normaliseVideoDuration !== 'function') return;
517
385 shared.normaliseVideoDuration(player, durationSeconds);
518 let originalDuration = null;
519 let durationWasChanged = false;
520 try
521 {
522 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
523 installDurationFallback(player, originalDuration, duration);
524 if (player.__filemanagerDurationApplied) return;
525
526 const current = originalDuration ? Number(originalDuration()) : NaN;
527 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
528 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
529 if (withinTolerance)
530 {
531 player.__filemanagerDurationApplied = true;
532 return;
533 }
534
535 if (originalDuration)
536 {
537 durationWasChanged = true;
538 originalDuration(duration);
539 }
540 } catch
541 {
542 // Ignore players that do not support setting duration.
543 }
544
545 try
546 {
547 const updated = originalDuration ? Number(originalDuration()) : NaN;
548 if (Number.isFinite(updated) && updated >= duration * 0.95)
549 {
550 player.__filemanagerDurationApplied = true;
551 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
552 return;
553 }
554
555 player.__filemanagerDurationApplied = true;
556 if (typeof player.trigger === 'function') player.trigger('durationchange');
557 } catch
558 {
559 // Ignore duration fallback failures.
560 }
561 }
562
563 function installDurationFallback (player, originalDuration, duration)
564 {
565 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
566
567 player.__filemanagerDurationFallback = true;
568 player.duration = function durationWithFallback (...args)
569 {
570 if (args.length) return originalDuration(...args);
571 const current = Number(originalDuration());
572 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
573 };
574 }
575
576 function formatDurationForDebug (seconds)
577 {
578 const value = Number(seconds);
579 if (!Number.isFinite(value) || value < 0) return 'unknown';
580
581 const totalSeconds = Math.floor(value);
582 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
583 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
584 const ss = String(totalSeconds % 60).padStart(2, '0');
585 return `${hh}:${mm}:${ss}`;
586 }
386 }
587
387
588 function ensureVideoPlaybackUi (player, durationSeconds)
388 function ensureVideoPlaybackUi (player, durationSeconds)
589 {
389 {
590 if (!player || typeof player.on !== 'function') return;
390 const shared = sharedVideoPlayer();
591
391 if (!shared || typeof shared.ensureVideoPlaybackUi !== 'function') return;
592 const forceVodUi = () =>
392 shared.ensureVideoPlaybackUi(player, durationSeconds);
593 {
594 normaliseVideoDuration(player, durationSeconds);
595
596 try
597 {
598 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
599 {
600 player.liveTracker.stopTracking();
601 }
602 } catch
603 {
604 // Ignore live tracker availability issues.
605 }
606
607 try
608 {
609 if (typeof player.removeClass === 'function')
610 {
611 player.removeClass('vjs-live');
612 }
613 } catch
614 {
615 // Ignore class update failures.
616 }
617 };
618
619 player.ready(forceVodUi);
620 player.on('loadedmetadata', forceVodUi);
621 player.on('durationchange', forceVodUi);
622 player.on('loadedplaylist', forceVodUi);
623 }
393 }
624
394
625 function tryPreview (name, isDir)
395 function tryPreview (name, isDir)
@@ -663,6 +433,7 @@
663 wrap.appendChild(video);
433 wrap.appendChild(video);
664
434
665 cleanupShareVideoPlayer();
435 cleanupShareVideoPlayer();
436 shareVideoSessionId = String(data.sessionId || '').trim() || null;
666
437
667 shareVideoPlayer = window.videojs(video, {
438 shareVideoPlayer = window.videojs(video, {
668 controls: true,
439 controls: true,
@@ -686,6 +457,16 @@
686 });
457 });
687
458
688 shareTrackPrefs = bindShareVideoTrackPrefs(shareVideoPlayer, prefs);
459 shareTrackPrefs = bindShareVideoTrackPrefs(shareVideoPlayer, prefs);
460 const shared = sharedVideoPlayer();
461 shareImageSubtitleController = shared && typeof shared.bindImageSubtitleOverlay === 'function'
462 ? shared.bindImageSubtitleOverlay(shareVideoPlayer, window.videojs, prefs, data, {
463 savePrefs: saveShareVideoPrefs,
464 buildFrameRequest: ({ currentTime, streamIndex, session }) => ({
465 url: `/api/share/video-stream-subtitle-frame/${encodeURIComponent(token)}?streamIndex=${streamIndex}&timeSeconds=${encodeURIComponent(String(currentTime))}&videoWidth=${encodeURIComponent(String(session.videoWidth || ''))}&videoHeight=${encodeURIComponent(String(session.videoHeight || ''))}`,
466 credentials: 'same-origin',
467 }),
468 })
469 : null;
689 ensureVideoPlaybackUi(shareVideoPlayer, data.durationSeconds);
470 ensureVideoPlaybackUi(shareVideoPlayer, data.durationSeconds);
690
471
691 shareVideoPlayer.ready(() =>
472 shareVideoPlayer.ready(() =>
@@ -696,6 +477,10 @@
696 shareVideoPlayer.volume(Math.max(0, Math.min(1, volume)));
477 shareVideoPlayer.volume(Math.max(0, Math.min(1, volume)));
697 }
478 }
698 shareTrackPrefs.applySavedTracks();
479 shareTrackPrefs.applySavedTracks();
480 if (shareImageSubtitleController && typeof shareImageSubtitleController.applySavedTracks === 'function')
481 {
482 shareImageSubtitleController.applySavedTracks();
483 }
699 });
484 });
700
485
701 shareVideoPlayer.on('loadedmetadata', shareTrackPrefs.applySavedTracks);
486 shareVideoPlayer.on('loadedmetadata', shareTrackPrefs.applySavedTracks);
public/shared-video-player.js added +741 −0
@@ -0,0 +1,741 @@
1 'use strict';
2
3 (function ()
4 {
5 const VIDEO_TEXT_TRACK_SETTINGS_KEY = 'vjs-text-track-settings';
6 const VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW = JSON.stringify({
7 backgroundOpacity: '0',
8 edgeStyle: 'uniform',
9 });
10
11 function normaliseTrackName (name)
12 {
13 return String(name || '').trim().toLowerCase();
14 }
15
16 function getTrackName (track)
17 {
18 if (!track || typeof track !== 'object') return '';
19 const label = String(track.label || '').trim();
20 if (label) return label;
21 const name = String(track.name || '').trim();
22 if (name) return name;
23 const language = String(track.language || '').trim();
24 if (language) return language;
25 const id = String(track.id || '').trim();
26 if (id) return id;
27 return '';
28 }
29
30 function trackListToArray (trackList)
31 {
32 if (!trackList || typeof trackList.length !== 'number') return [];
33 const out = [];
34 for (let i = 0; i < trackList.length; i++)
35 {
36 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
37 if (track) out.push(track);
38 }
39 return out;
40 }
41
42 function subtitleTracksFromPlayer (player)
43 {
44 if (!player || typeof player.textTracks !== 'function') return [];
45 return trackListToArray(player.textTracks()).filter((track) =>
46 {
47 const kind = String(track.kind || '').toLowerCase();
48 return kind === 'subtitles' || kind === 'captions';
49 });
50 }
51
52 function audioTracksFromPlayer (player)
53 {
54 if (!player || typeof player.audioTracks !== 'function') return [];
55 return trackListToArray(player.audioTracks());
56 }
57
58 function applySavedSubtitleTrack (player, savedName)
59 {
60 if (typeof savedName !== 'string') return;
61 const tracks = subtitleTracksFromPlayer(player);
62 if (!tracks.length) return;
63
64 const wanted = normaliseTrackName(savedName);
65 if (!wanted)
66 {
67 for (const track of tracks) track.mode = 'disabled';
68 return;
69 }
70
71 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
72 if (!match) return;
73
74 for (const track of tracks)
75 {
76 track.mode = track === match ? 'showing' : 'disabled';
77 }
78 }
79
80 function applySavedAudioTrack (player, savedName)
81 {
82 if (typeof savedName !== 'string') return;
83 const tracks = audioTracksFromPlayer(player);
84 if (!tracks.length) return;
85
86 const wanted = normaliseTrackName(savedName);
87 if (!wanted) return;
88
89 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
90 if (!match) return;
91
92 for (const track of tracks)
93 {
94 track.enabled = track === match;
95 }
96 }
97
98 function getSelectedSubtitleTrackName (player)
99 {
100 const tracks = subtitleTracksFromPlayer(player);
101 if (!tracks.length) return null;
102 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
103 return active ? getTrackName(active) : '';
104 }
105
106 function getSelectedAudioTrackName (player)
107 {
108 const tracks = audioTracksFromPlayer(player);
109 if (!tracks.length) return null;
110 const active = tracks.find((track) => !!track.enabled);
111 return active ? getTrackName(active) : '';
112 }
113
114 function bindTrackPrefs (player, prefs, savePrefs)
115 {
116 const save = typeof savePrefs === 'function' ? savePrefs : (() => {});
117 const applySavedTracks = () =>
118 {
119 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
120 applySavedAudioTrack(player, prefs.audioTrackName);
121 };
122
123 const captureSelectedTracks = () =>
124 {
125 const subtitleTrackName = getSelectedSubtitleTrackName(player);
126 const audioTrackName = getSelectedAudioTrackName(player);
127 const patch = {};
128
129 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
130 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
131
132 if (Object.keys(patch).length) save(patch);
133 };
134
135 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
136 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
137 const onTrackListChange = () => captureSelectedTracks();
138
139 if (textTrackList && typeof textTrackList.addEventListener === 'function')
140 {
141 textTrackList.addEventListener('change', onTrackListChange);
142 }
143
144 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
145 {
146 audioTrackList.addEventListener('change', onTrackListChange);
147 }
148
149 return {
150 applySavedTracks,
151 captureSelectedTracks,
152 detach: () =>
153 {
154 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
155 {
156 textTrackList.removeEventListener('change', onTrackListChange);
157 }
158 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
159 {
160 audioTrackList.removeEventListener('change', onTrackListChange);
161 }
162 },
163 };
164 }
165
166 function bindImageSubtitleOverlay (player, videojs, prefs, session, opts = {})
167 {
168 const imageTracks = Array.isArray(session.imageSubtitleTracks)
169 ? session.imageSubtitleTracks.map((track) => ({
170 label: String(track.label || '').trim() || `Subtitle ${Number(track.streamIndex || 0) + 1}`,
171 language: String(track.language || '').trim(),
172 isDefault: !!track.default,
173 streamIndex: Number(track.streamIndex),
174 })).filter((track) => Number.isInteger(track.streamIndex) && track.streamIndex >= 0)
175 : [];
176
177 if (!imageTracks.length) return null;
178
179 const savePrefs = typeof opts.savePrefs === 'function' ? opts.savePrefs : (() => {});
180 const buildFrameRequest = typeof opts.buildFrameRequest === 'function' ? opts.buildFrameRequest : null;
181 const notifyError = typeof opts.onError === 'function' ? opts.onError : (() => {});
182 if (!buildFrameRequest) return null;
183
184 const trackByStreamIndex = new Map(imageTracks.map((track) => [track.streamIndex, track]));
185 let selectedStreamIndex = null;
186 let menuOpen = false;
187 let requestToken = 0;
188 let activeBucket = -1;
189 let activeObjectUrl = null;
190 let overlayEl = null;
191 let overlayImgEl = null;
192 let menuEl = null;
193 let buttonEl = null;
194 let trackDisabled = false;
195 let failureNotified = false;
196
197 const closeObjectUrl = () =>
198 {
199 if (activeObjectUrl)
200 {
201 URL.revokeObjectURL(activeObjectUrl);
202 activeObjectUrl = null;
203 }
204 };
205
206 const hideOverlay = () =>
207 {
208 if (overlayEl) overlayEl.style.display = 'none';
209 if (overlayImgEl) overlayImgEl.removeAttribute('src');
210 closeObjectUrl();
211 };
212
213 const updateButtonState = () =>
214 {
215 if (!buttonEl) return;
216 const track = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
217 buttonEl.setAttribute('title', track ? `Image subtitles: ${track.label}` : 'Image subtitles');
218 buttonEl.setAttribute('aria-pressed', selectedStreamIndex === null ? 'false' : 'true');
219 };
220
221 const updateMenuState = () =>
222 {
223 if (!menuEl) return;
224 const items = menuEl.querySelectorAll('[data-image-subtitle-stream-index]');
225 for (const itemEl of items)
226 {
227 const value = itemEl.getAttribute('data-image-subtitle-stream-index');
228 const isSelected = value === (selectedStreamIndex === null ? 'off' : String(selectedStreamIndex));
229 itemEl.classList.toggle('is-selected', isSelected);
230 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
231 itemEl.style.background = isSelected ? 'rgba(90, 196, 255, 0.28)' : 'transparent';
232 itemEl.style.fontWeight = isSelected ? '600' : '400';
233 itemEl.style.boxShadow = isSelected ? 'inset 0 0 0 1px rgba(90, 196, 255, 0.55)' : 'none';
234 }
235 };
236
237 const closeMenu = () =>
238 {
239 menuOpen = false;
240 if (menuEl) menuEl.style.display = 'none';
241 };
242
243 const openMenu = () =>
244 {
245 menuOpen = true;
246 if (menuEl)
247 {
248 updateMenuState();
249 menuEl.style.display = 'block';
250 }
251 };
252
253 const toggleMenu = () =>
254 {
255 if (menuOpen) closeMenu();
256 else openMenu();
257 };
258
259 const saveSelection = () =>
260 {
261 const selectedTrack = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
262 savePrefs({
263 imageSubtitleTrackStreamIndex: selectedStreamIndex,
264 imageSubtitleTrackName: selectedTrack ? selectedTrack.label : null,
265 });
266 };
267
268 const disableTrack = () =>
269 {
270 trackDisabled = true;
271 selectedStreamIndex = null;
272 activeBucket = -1;
273 hideOverlay();
274 updateButtonState();
275 updateMenuState();
276 saveSelection();
277
278 if (!failureNotified)
279 {
280 failureNotified = true;
281 notifyError();
282 }
283 };
284
285 const setSelectedStreamIndex = (streamIndex, { persist = true } = {}) =>
286 {
287 const nextStreamIndex = Number.isInteger(streamIndex) ? streamIndex : null;
288 if (nextStreamIndex !== null && !trackByStreamIndex.has(nextStreamIndex)) return;
289
290 trackDisabled = false;
291 failureNotified = false;
292 selectedStreamIndex = nextStreamIndex;
293 activeBucket = -1;
294 hideOverlay();
295 updateButtonState();
296 updateMenuState();
297 if (persist) saveSelection();
298
299 if (selectedStreamIndex !== null)
300 {
301 void refreshFrame(true);
302 }
303 };
304
305 const refreshFrame = async (force = false) =>
306 {
307 if (selectedStreamIndex === null) return;
308 if (!overlayEl || !overlayImgEl) return;
309 if (trackDisabled) return;
310
311 const currentTime = Number(player.currentTime());
312 if (!Number.isFinite(currentTime) || currentTime < 0) return;
313
314 const bucket = Math.floor(currentTime * 4);
315 if (!force && bucket === activeBucket) return;
316 activeBucket = bucket;
317
318 const token = ++requestToken;
319 const request = buildFrameRequest({
320 streamIndex: selectedStreamIndex,
321 currentTime,
322 session,
323 });
324
325 if (!request || !request.url)
326 {
327 disableTrack();
328 return;
329 }
330
331 try
332 {
333 const res = await fetch(request.url, {
334 method: request.method || 'GET',
335 headers: request.headers,
336 credentials: request.credentials,
337 });
338
339 if (token !== requestToken) return;
340
341 if (res.status === 204)
342 {
343 const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase();
344 hideOverlay();
345 if (frameStatus === 'error') disableTrack();
346 return;
347 }
348
349 if (!res.ok)
350 {
351 disableTrack();
352 return;
353 }
354
355 const blob = await res.blob();
356 if (token !== requestToken) return;
357
358 if (!blob || blob.size === 0)
359 {
360 disableTrack();
361 return;
362 }
363
364 closeObjectUrl();
365 activeObjectUrl = URL.createObjectURL(blob);
366 overlayImgEl.src = activeObjectUrl;
367
368 const frameWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Width') || ''), 10);
369 const frameHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Height') || ''), 10);
370 const canvasWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Width') || ''), 10);
371 const canvasHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Height') || ''), 10);
372
373 if (frameWidth > 0 && frameHeight > 0 && canvasWidth > 0 && canvasHeight > 0)
374 {
375 const widthPercent = (frameWidth / canvasWidth) * 100;
376 const heightPercent = (frameHeight / canvasHeight) * 100;
377 overlayImgEl.style.width = `${widthPercent}%`;
378 overlayImgEl.style.height = `${heightPercent}%`;
379 overlayImgEl.style.maxWidth = 'none';
380 overlayImgEl.style.maxHeight = 'none';
381 } else
382 {
383 overlayImgEl.style.width = 'auto';
384 overlayImgEl.style.height = 'auto';
385 overlayImgEl.style.maxWidth = '100%';
386 overlayImgEl.style.maxHeight = '100%';
387 }
388
389 overlayEl.style.display = 'block';
390 overlayImgEl.style.display = 'block';
391 } catch
392 {
393 if (token === requestToken) disableTrack();
394 }
395 };
396
397 const dispose = () =>
398 {
399 requestToken++;
400 closeMenu();
401 hideOverlay();
402 if (overlayEl) overlayEl.remove();
403 if (menuEl) menuEl.remove();
404 player.imageSubtitleOverlayController = null;
405 buttonEl = null;
406 };
407
408 overlayEl = document.createElement('div');
409 overlayEl.className = 'video-subtitle-overlay';
410 overlayEl.style.position = 'absolute';
411 overlayEl.style.left = '0';
412 overlayEl.style.right = '0';
413 overlayEl.style.bottom = '3rem';
414 overlayEl.style.display = 'none';
415 overlayEl.style.zIndex = '3';
416 overlayEl.style.pointerEvents = 'none';
417 overlayEl.style.textAlign = 'center';
418 overlayEl.style.padding = '0 0.75rem';
419 overlayEl.style.maxHeight = '70%';
420 overlayEl.style.overflow = 'hidden';
421
422 overlayImgEl = document.createElement('img');
423 overlayImgEl.alt = 'Image subtitles';
424 overlayImgEl.style.display = 'none';
425 overlayImgEl.style.margin = '0 auto';
426 overlayImgEl.style.objectFit = 'contain';
427 overlayImgEl.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))';
428 overlayImgEl.style.maxWidth = '100%';
429 overlayImgEl.style.height = 'auto';
430 overlayEl.appendChild(overlayImgEl);
431
432 menuEl = document.createElement('div');
433 menuEl.className = 'video-subtitle-overlay-menu';
434 menuEl.style.position = 'absolute';
435 menuEl.style.right = '0.75rem';
436 menuEl.style.bottom = 'calc(3rem + 0.5rem)';
437 menuEl.style.minWidth = '14rem';
438 menuEl.style.maxWidth = '20rem';
439 menuEl.style.background = 'rgba(12, 12, 12, 0.96)';
440 menuEl.style.border = '1px solid rgba(255, 255, 255, 0.15)';
441 menuEl.style.borderRadius = '0.5rem';
442 menuEl.style.boxShadow = '0 12px 28px rgba(0, 0, 0, 0.35)';
443 menuEl.style.padding = '0.35rem';
444 menuEl.style.display = 'none';
445 menuEl.style.zIndex = '4';
446
447 const buildMenuItem = (label, streamIndex, isSelected) =>
448 {
449 const itemEl = document.createElement('button');
450 itemEl.type = 'button';
451 itemEl.className = 'video-subtitle-overlay-menu-item';
452 itemEl.setAttribute('data-image-subtitle-stream-index', streamIndex === null ? 'off' : String(streamIndex));
453 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
454 itemEl.style.display = 'block';
455 itemEl.style.width = '100%';
456 itemEl.style.margin = '0';
457 itemEl.style.padding = '0.5rem 0.75rem';
458 itemEl.style.border = '0';
459 itemEl.style.borderRadius = '0.35rem';
460 itemEl.style.background = isSelected ? 'rgba(255, 255, 255, 0.18)' : 'transparent';
461 itemEl.style.color = '#fff';
462 itemEl.style.textAlign = 'left';
463 itemEl.style.cursor = 'pointer';
464 itemEl.textContent = label;
465 itemEl.addEventListener('click', () =>
466 {
467 setSelectedStreamIndex(streamIndex);
468 closeMenu();
469 });
470 return itemEl;
471 };
472
473 menuEl.appendChild(buildMenuItem('Off', null, false));
474 for (const track of imageTracks)
475 {
476 menuEl.appendChild(buildMenuItem(track.label, track.streamIndex, false));
477 }
478
479 const registerButton = () =>
480 {
481 if (!videojs || typeof videojs.getComponent !== 'function' || typeof videojs.registerComponent !== 'function') return;
482 if (videojs.getComponent('ImageSubtitleButton')) return;
483
484 const Button = videojs.getComponent('Button');
485 class ImageSubtitleButton extends Button
486 {
487 buildCSSClass ()
488 {
489 return `${super.buildCSSClass()} vjs-image-subtitle-button`;
490 }
491
492 createEl ()
493 {
494 const el = super.createEl();
495 el.type = 'button';
496 el.setAttribute('title', 'Image subtitles');
497 el.setAttribute('aria-label', 'Image subtitles');
498 el.innerHTML = '<span aria-hidden="true">IM</span>';
499 return el;
500 }
501
502 handleClick ()
503 {
504 const controller = this.player().imageSubtitleOverlayController;
505 if (controller) controller.toggleMenu();
506 }
507 }
508
509 videojs.registerComponent('ImageSubtitleButton', ImageSubtitleButton);
510 };
511
512 const attachUi = () =>
513 {
514 if (!player.el()) return;
515 registerButton();
516 if (overlayEl.parentElement !== player.el()) player.el().appendChild(overlayEl);
517 if (menuEl.parentElement !== player.el()) player.el().appendChild(menuEl);
518 const controlBar = typeof player.getChild === 'function' ? player.getChild('controlBar') : null;
519 if (controlBar && typeof controlBar.addChild === 'function' && !buttonEl)
520 {
521 const button = controlBar.addChild('ImageSubtitleButton', {});
522 buttonEl = button && typeof button.el === 'function' ? button.el() : null;
523 updateButtonState();
524 }
525 };
526
527 const applySavedTracks = () =>
528 {
529 const savedName = normaliseTrackName(prefs.imageSubtitleTrackName);
530 if (savedName)
531 {
532 const savedByName = imageTracks.find((track) => normaliseTrackName(track.label) === savedName) || null;
533 if (savedByName)
534 {
535 setSelectedStreamIndex(savedByName.streamIndex, { persist: false });
536 return;
537 }
538 }
539
540 const savedIndex = Number(prefs.imageSubtitleTrackStreamIndex);
541 if (Number.isInteger(savedIndex) && trackByStreamIndex.has(savedIndex))
542 {
543 setSelectedStreamIndex(savedIndex, { persist: false });
544 return;
545 }
546
547 const defaultTrack = imageTracks.find((track) => track.isDefault) || null;
548 if (defaultTrack)
549 {
550 setSelectedStreamIndex(defaultTrack.streamIndex, { persist: false });
551 return;
552 }
553
554 setSelectedStreamIndex(null, { persist: false });
555 };
556
557 player.imageSubtitleOverlayController = {
558 toggleMenu,
559 closeMenu,
560 applySavedTracks,
561 captureSelectedTracks: saveSelection,
562 detach: dispose,
563 };
564
565 player.on('timeupdate', () => { void refreshFrame(); });
566 player.on('seeking', () => { void refreshFrame(true); });
567 player.on('play', () => { void refreshFrame(true); });
568 player.on('fullscreenchange', () => { closeMenu(); void refreshFrame(true); });
569 player.on('dispose', dispose);
570 player.ready(() =>
571 {
572 attachUi();
573 updateMenuState();
574 updateButtonState();
575 applySavedTracks();
576 if (menuOpen) openMenu();
577 });
578
579 return player.imageSubtitleOverlayController;
580 }
581
582 function formatDurationForDebug (seconds)
583 {
584 const value = Number(seconds);
585 if (!Number.isFinite(value) || value < 0) return 'unknown';
586
587 const totalSeconds = Math.floor(value);
588 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
589 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
590 const ss = String(totalSeconds % 60).padStart(2, '0');
591 return `${hh}:${mm}:${ss}`;
592 }
593
594 function installDurationFallback (player, originalDuration, duration)
595 {
596 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
597
598 player.__filemanagerDurationFallback = true;
599 player.duration = function durationWithFallback (...args)
600 {
601 if (args.length) return originalDuration(...args);
602 const current = Number(originalDuration());
603 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
604 };
605 }
606
607 function normaliseVideoDuration (player, durationSeconds)
608 {
609 const duration = Number(durationSeconds);
610 if (!player || !Number.isFinite(duration) || duration <= 0) return;
611
612 let originalDuration = null;
613 let durationWasChanged = false;
614 try
615 {
616 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
617 installDurationFallback(player, originalDuration, duration);
618 if (player.__filemanagerDurationApplied) return;
619
620 const current = originalDuration ? Number(originalDuration()) : NaN;
621 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
622 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
623 if (withinTolerance)
624 {
625 player.__filemanagerDurationApplied = true;
626 return;
627 }
628
629 if (originalDuration)
630 {
631 durationWasChanged = true;
632 originalDuration(duration);
633 }
634 } catch
635 {
636 // Ignore players that do not support setting duration.
637 }
638
639 try
640 {
641 const updated = originalDuration ? Number(originalDuration()) : NaN;
642 if (Number.isFinite(updated) && updated >= duration * 0.95)
643 {
644 player.__filemanagerDurationApplied = true;
645 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
646 return;
647 }
648
649 player.__filemanagerDurationApplied = true;
650 if (typeof player.trigger === 'function') player.trigger('durationchange');
651 } catch
652 {
653 // Ignore duration fallback failures.
654 }
655 }
656
657 function ensureVideoPlaybackUi (player, durationSeconds)
658 {
659 if (!player || typeof player.on !== 'function') return;
660
661 const forceVodUi = () =>
662 {
663 normaliseVideoDuration(player, durationSeconds);
664
665 try
666 {
667 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
668 {
669 player.liveTracker.stopTracking();
670 }
671 } catch
672 {
673 // Ignore live tracker availability issues.
674 }
675
676 try
677 {
678 if (typeof player.removeClass === 'function')
679 {
680 player.removeClass('vjs-live');
681 }
682 } catch
683 {
684 // Ignore class update failures.
685 }
686
687 try
688 {
689 const display = player.el && player.el() && player.el().querySelector('.vjs-live-display');
690 if (display) display.style.display = 'none';
691 } catch
692 {
693 // Ignore missing DOM.
694 }
695 };
696
697 player.ready(forceVodUi);
698 player.on('loadedmetadata', forceVodUi);
699 player.on('durationchange', forceVodUi);
700 player.on('loadedplaylist', forceVodUi);
701 }
702
703 function configureVideoJsBuffering (videojs, opts = {})
704 {
705 if (opts.enabled === false) return;
706 if (!videojs || !videojs.Vhs || videojs.__filemanagerBufferingConfigured) return;
707 videojs.__filemanagerBufferingConfigured = true;
708
709 const seconds = Number(opts.seconds);
710 const bufferSeconds = Number.isFinite(seconds) && seconds > 0 ? seconds : 60 * 60;
711
712 try
713 {
714 videojs.Vhs.GOAL_BUFFER_LENGTH = bufferSeconds;
715 videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = bufferSeconds;
716 } catch
717 {
718 // Ignore builds that do not expose VHS buffer configuration.
719 }
720 }
721
722 function applyDefaultTextTrackPrefs ()
723 {
724 try
725 {
726 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
727 } catch
728 {
729 // Ignore localStorage failures.
730 }
731 }
732
733 window.FilemanagerSharedVideoPlayer = {
734 applyDefaultTextTrackPrefs,
735 bindImageSubtitleOverlay,
736 bindTrackPrefs,
737 configureVideoJsBuffering,
738 ensureVideoPlaybackUi,
739 normaliseVideoDuration,
740 };
741 }());
@@ -0,0 +1,741 @@
1'use strict';
2
3(function ()
4{
5 const VIDEO_TEXT_TRACK_SETTINGS_KEY = 'vjs-text-track-settings';
6 const VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW = JSON.stringify({
7 backgroundOpacity: '0',
8 edgeStyle: 'uniform',
9 });
10
11 function normaliseTrackName (name)
12 {
13 return String(name || '').trim().toLowerCase();
14 }
15
16 function getTrackName (track)
17 {
18 if (!track || typeof track !== 'object') return '';
19 const label = String(track.label || '').trim();
20 if (label) return label;
21 const name = String(track.name || '').trim();
22 if (name) return name;
23 const language = String(track.language || '').trim();
24 if (language) return language;
25 const id = String(track.id || '').trim();
26 if (id) return id;
27 return '';
28 }
29
30 function trackListToArray (trackList)
31 {
32 if (!trackList || typeof trackList.length !== 'number') return [];
33 const out = [];
34 for (let i = 0; i < trackList.length; i++)
35 {
36 const track = trackList[i] || (typeof trackList.item === 'function' ? trackList.item(i) : null);
37 if (track) out.push(track);
38 }
39 return out;
40 }
41
42 function subtitleTracksFromPlayer (player)
43 {
44 if (!player || typeof player.textTracks !== 'function') return [];
45 return trackListToArray(player.textTracks()).filter((track) =>
46 {
47 const kind = String(track.kind || '').toLowerCase();
48 return kind === 'subtitles' || kind === 'captions';
49 });
50 }
51
52 function audioTracksFromPlayer (player)
53 {
54 if (!player || typeof player.audioTracks !== 'function') return [];
55 return trackListToArray(player.audioTracks());
56 }
57
58 function applySavedSubtitleTrack (player, savedName)
59 {
60 if (typeof savedName !== 'string') return;
61 const tracks = subtitleTracksFromPlayer(player);
62 if (!tracks.length) return;
63
64 const wanted = normaliseTrackName(savedName);
65 if (!wanted)
66 {
67 for (const track of tracks) track.mode = 'disabled';
68 return;
69 }
70
71 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
72 if (!match) return;
73
74 for (const track of tracks)
75 {
76 track.mode = track === match ? 'showing' : 'disabled';
77 }
78 }
79
80 function applySavedAudioTrack (player, savedName)
81 {
82 if (typeof savedName !== 'string') return;
83 const tracks = audioTracksFromPlayer(player);
84 if (!tracks.length) return;
85
86 const wanted = normaliseTrackName(savedName);
87 if (!wanted) return;
88
89 const match = tracks.find((track) => normaliseTrackName(getTrackName(track)) === wanted);
90 if (!match) return;
91
92 for (const track of tracks)
93 {
94 track.enabled = track === match;
95 }
96 }
97
98 function getSelectedSubtitleTrackName (player)
99 {
100 const tracks = subtitleTracksFromPlayer(player);
101 if (!tracks.length) return null;
102 const active = tracks.find((track) => String(track.mode || '').toLowerCase() === 'showing');
103 return active ? getTrackName(active) : '';
104 }
105
106 function getSelectedAudioTrackName (player)
107 {
108 const tracks = audioTracksFromPlayer(player);
109 if (!tracks.length) return null;
110 const active = tracks.find((track) => !!track.enabled);
111 return active ? getTrackName(active) : '';
112 }
113
114 function bindTrackPrefs (player, prefs, savePrefs)
115 {
116 const save = typeof savePrefs === 'function' ? savePrefs : (() => {});
117 const applySavedTracks = () =>
118 {
119 applySavedSubtitleTrack(player, prefs.subtitleTrackName);
120 applySavedAudioTrack(player, prefs.audioTrackName);
121 };
122
123 const captureSelectedTracks = () =>
124 {
125 const subtitleTrackName = getSelectedSubtitleTrackName(player);
126 const audioTrackName = getSelectedAudioTrackName(player);
127 const patch = {};
128
129 if (subtitleTrackName !== null) patch.subtitleTrackName = subtitleTrackName;
130 if (audioTrackName !== null) patch.audioTrackName = audioTrackName;
131
132 if (Object.keys(patch).length) save(patch);
133 };
134
135 const textTrackList = typeof player.textTracks === 'function' ? player.textTracks() : null;
136 const audioTrackList = typeof player.audioTracks === 'function' ? player.audioTracks() : null;
137 const onTrackListChange = () => captureSelectedTracks();
138
139 if (textTrackList && typeof textTrackList.addEventListener === 'function')
140 {
141 textTrackList.addEventListener('change', onTrackListChange);
142 }
143
144 if (audioTrackList && typeof audioTrackList.addEventListener === 'function')
145 {
146 audioTrackList.addEventListener('change', onTrackListChange);
147 }
148
149 return {
150 applySavedTracks,
151 captureSelectedTracks,
152 detach: () =>
153 {
154 if (textTrackList && typeof textTrackList.removeEventListener === 'function')
155 {
156 textTrackList.removeEventListener('change', onTrackListChange);
157 }
158 if (audioTrackList && typeof audioTrackList.removeEventListener === 'function')
159 {
160 audioTrackList.removeEventListener('change', onTrackListChange);
161 }
162 },
163 };
164 }
165
166 function bindImageSubtitleOverlay (player, videojs, prefs, session, opts = {})
167 {
168 const imageTracks = Array.isArray(session.imageSubtitleTracks)
169 ? session.imageSubtitleTracks.map((track) => ({
170 label: String(track.label || '').trim() || `Subtitle ${Number(track.streamIndex || 0) + 1}`,
171 language: String(track.language || '').trim(),
172 isDefault: !!track.default,
173 streamIndex: Number(track.streamIndex),
174 })).filter((track) => Number.isInteger(track.streamIndex) && track.streamIndex >= 0)
175 : [];
176
177 if (!imageTracks.length) return null;
178
179 const savePrefs = typeof opts.savePrefs === 'function' ? opts.savePrefs : (() => {});
180 const buildFrameRequest = typeof opts.buildFrameRequest === 'function' ? opts.buildFrameRequest : null;
181 const notifyError = typeof opts.onError === 'function' ? opts.onError : (() => {});
182 if (!buildFrameRequest) return null;
183
184 const trackByStreamIndex = new Map(imageTracks.map((track) => [track.streamIndex, track]));
185 let selectedStreamIndex = null;
186 let menuOpen = false;
187 let requestToken = 0;
188 let activeBucket = -1;
189 let activeObjectUrl = null;
190 let overlayEl = null;
191 let overlayImgEl = null;
192 let menuEl = null;
193 let buttonEl = null;
194 let trackDisabled = false;
195 let failureNotified = false;
196
197 const closeObjectUrl = () =>
198 {
199 if (activeObjectUrl)
200 {
201 URL.revokeObjectURL(activeObjectUrl);
202 activeObjectUrl = null;
203 }
204 };
205
206 const hideOverlay = () =>
207 {
208 if (overlayEl) overlayEl.style.display = 'none';
209 if (overlayImgEl) overlayImgEl.removeAttribute('src');
210 closeObjectUrl();
211 };
212
213 const updateButtonState = () =>
214 {
215 if (!buttonEl) return;
216 const track = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
217 buttonEl.setAttribute('title', track ? `Image subtitles: ${track.label}` : 'Image subtitles');
218 buttonEl.setAttribute('aria-pressed', selectedStreamIndex === null ? 'false' : 'true');
219 };
220
221 const updateMenuState = () =>
222 {
223 if (!menuEl) return;
224 const items = menuEl.querySelectorAll('[data-image-subtitle-stream-index]');
225 for (const itemEl of items)
226 {
227 const value = itemEl.getAttribute('data-image-subtitle-stream-index');
228 const isSelected = value === (selectedStreamIndex === null ? 'off' : String(selectedStreamIndex));
229 itemEl.classList.toggle('is-selected', isSelected);
230 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
231 itemEl.style.background = isSelected ? 'rgba(90, 196, 255, 0.28)' : 'transparent';
232 itemEl.style.fontWeight = isSelected ? '600' : '400';
233 itemEl.style.boxShadow = isSelected ? 'inset 0 0 0 1px rgba(90, 196, 255, 0.55)' : 'none';
234 }
235 };
236
237 const closeMenu = () =>
238 {
239 menuOpen = false;
240 if (menuEl) menuEl.style.display = 'none';
241 };
242
243 const openMenu = () =>
244 {
245 menuOpen = true;
246 if (menuEl)
247 {
248 updateMenuState();
249 menuEl.style.display = 'block';
250 }
251 };
252
253 const toggleMenu = () =>
254 {
255 if (menuOpen) closeMenu();
256 else openMenu();
257 };
258
259 const saveSelection = () =>
260 {
261 const selectedTrack = selectedStreamIndex === null ? null : trackByStreamIndex.get(selectedStreamIndex) || null;
262 savePrefs({
263 imageSubtitleTrackStreamIndex: selectedStreamIndex,
264 imageSubtitleTrackName: selectedTrack ? selectedTrack.label : null,
265 });
266 };
267
268 const disableTrack = () =>
269 {
270 trackDisabled = true;
271 selectedStreamIndex = null;
272 activeBucket = -1;
273 hideOverlay();
274 updateButtonState();
275 updateMenuState();
276 saveSelection();
277
278 if (!failureNotified)
279 {
280 failureNotified = true;
281 notifyError();
282 }
283 };
284
285 const setSelectedStreamIndex = (streamIndex, { persist = true } = {}) =>
286 {
287 const nextStreamIndex = Number.isInteger(streamIndex) ? streamIndex : null;
288 if (nextStreamIndex !== null && !trackByStreamIndex.has(nextStreamIndex)) return;
289
290 trackDisabled = false;
291 failureNotified = false;
292 selectedStreamIndex = nextStreamIndex;
293 activeBucket = -1;
294 hideOverlay();
295 updateButtonState();
296 updateMenuState();
297 if (persist) saveSelection();
298
299 if (selectedStreamIndex !== null)
300 {
301 void refreshFrame(true);
302 }
303 };
304
305 const refreshFrame = async (force = false) =>
306 {
307 if (selectedStreamIndex === null) return;
308 if (!overlayEl || !overlayImgEl) return;
309 if (trackDisabled) return;
310
311 const currentTime = Number(player.currentTime());
312 if (!Number.isFinite(currentTime) || currentTime < 0) return;
313
314 const bucket = Math.floor(currentTime * 4);
315 if (!force && bucket === activeBucket) return;
316 activeBucket = bucket;
317
318 const token = ++requestToken;
319 const request = buildFrameRequest({
320 streamIndex: selectedStreamIndex,
321 currentTime,
322 session,
323 });
324
325 if (!request || !request.url)
326 {
327 disableTrack();
328 return;
329 }
330
331 try
332 {
333 const res = await fetch(request.url, {
334 method: request.method || 'GET',
335 headers: request.headers,
336 credentials: request.credentials,
337 });
338
339 if (token !== requestToken) return;
340
341 if (res.status === 204)
342 {
343 const frameStatus = String(res.headers.get('X-Subtitle-Frame-Status') || '').toLowerCase();
344 hideOverlay();
345 if (frameStatus === 'error') disableTrack();
346 return;
347 }
348
349 if (!res.ok)
350 {
351 disableTrack();
352 return;
353 }
354
355 const blob = await res.blob();
356 if (token !== requestToken) return;
357
358 if (!blob || blob.size === 0)
359 {
360 disableTrack();
361 return;
362 }
363
364 closeObjectUrl();
365 activeObjectUrl = URL.createObjectURL(blob);
366 overlayImgEl.src = activeObjectUrl;
367
368 const frameWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Width') || ''), 10);
369 const frameHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Height') || ''), 10);
370 const canvasWidth = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Width') || ''), 10);
371 const canvasHeight = Number.parseInt(String(res.headers.get('X-Subtitle-Frame-Canvas-Height') || ''), 10);
372
373 if (frameWidth > 0 && frameHeight > 0 && canvasWidth > 0 && canvasHeight > 0)
374 {
375 const widthPercent = (frameWidth / canvasWidth) * 100;
376 const heightPercent = (frameHeight / canvasHeight) * 100;
377 overlayImgEl.style.width = `${widthPercent}%`;
378 overlayImgEl.style.height = `${heightPercent}%`;
379 overlayImgEl.style.maxWidth = 'none';
380 overlayImgEl.style.maxHeight = 'none';
381 } else
382 {
383 overlayImgEl.style.width = 'auto';
384 overlayImgEl.style.height = 'auto';
385 overlayImgEl.style.maxWidth = '100%';
386 overlayImgEl.style.maxHeight = '100%';
387 }
388
389 overlayEl.style.display = 'block';
390 overlayImgEl.style.display = 'block';
391 } catch
392 {
393 if (token === requestToken) disableTrack();
394 }
395 };
396
397 const dispose = () =>
398 {
399 requestToken++;
400 closeMenu();
401 hideOverlay();
402 if (overlayEl) overlayEl.remove();
403 if (menuEl) menuEl.remove();
404 player.imageSubtitleOverlayController = null;
405 buttonEl = null;
406 };
407
408 overlayEl = document.createElement('div');
409 overlayEl.className = 'video-subtitle-overlay';
410 overlayEl.style.position = 'absolute';
411 overlayEl.style.left = '0';
412 overlayEl.style.right = '0';
413 overlayEl.style.bottom = '3rem';
414 overlayEl.style.display = 'none';
415 overlayEl.style.zIndex = '3';
416 overlayEl.style.pointerEvents = 'none';
417 overlayEl.style.textAlign = 'center';
418 overlayEl.style.padding = '0 0.75rem';
419 overlayEl.style.maxHeight = '70%';
420 overlayEl.style.overflow = 'hidden';
421
422 overlayImgEl = document.createElement('img');
423 overlayImgEl.alt = 'Image subtitles';
424 overlayImgEl.style.display = 'none';
425 overlayImgEl.style.margin = '0 auto';
426 overlayImgEl.style.objectFit = 'contain';
427 overlayImgEl.style.filter = 'drop-shadow(0 2px 2px rgba(0, 0, 0, 0.7))';
428 overlayImgEl.style.maxWidth = '100%';
429 overlayImgEl.style.height = 'auto';
430 overlayEl.appendChild(overlayImgEl);
431
432 menuEl = document.createElement('div');
433 menuEl.className = 'video-subtitle-overlay-menu';
434 menuEl.style.position = 'absolute';
435 menuEl.style.right = '0.75rem';
436 menuEl.style.bottom = 'calc(3rem + 0.5rem)';
437 menuEl.style.minWidth = '14rem';
438 menuEl.style.maxWidth = '20rem';
439 menuEl.style.background = 'rgba(12, 12, 12, 0.96)';
440 menuEl.style.border = '1px solid rgba(255, 255, 255, 0.15)';
441 menuEl.style.borderRadius = '0.5rem';
442 menuEl.style.boxShadow = '0 12px 28px rgba(0, 0, 0, 0.35)';
443 menuEl.style.padding = '0.35rem';
444 menuEl.style.display = 'none';
445 menuEl.style.zIndex = '4';
446
447 const buildMenuItem = (label, streamIndex, isSelected) =>
448 {
449 const itemEl = document.createElement('button');
450 itemEl.type = 'button';
451 itemEl.className = 'video-subtitle-overlay-menu-item';
452 itemEl.setAttribute('data-image-subtitle-stream-index', streamIndex === null ? 'off' : String(streamIndex));
453 itemEl.setAttribute('aria-checked', isSelected ? 'true' : 'false');
454 itemEl.style.display = 'block';
455 itemEl.style.width = '100%';
456 itemEl.style.margin = '0';
457 itemEl.style.padding = '0.5rem 0.75rem';
458 itemEl.style.border = '0';
459 itemEl.style.borderRadius = '0.35rem';
460 itemEl.style.background = isSelected ? 'rgba(255, 255, 255, 0.18)' : 'transparent';
461 itemEl.style.color = '#fff';
462 itemEl.style.textAlign = 'left';
463 itemEl.style.cursor = 'pointer';
464 itemEl.textContent = label;
465 itemEl.addEventListener('click', () =>
466 {
467 setSelectedStreamIndex(streamIndex);
468 closeMenu();
469 });
470 return itemEl;
471 };
472
473 menuEl.appendChild(buildMenuItem('Off', null, false));
474 for (const track of imageTracks)
475 {
476 menuEl.appendChild(buildMenuItem(track.label, track.streamIndex, false));
477 }
478
479 const registerButton = () =>
480 {
481 if (!videojs || typeof videojs.getComponent !== 'function' || typeof videojs.registerComponent !== 'function') return;
482 if (videojs.getComponent('ImageSubtitleButton')) return;
483
484 const Button = videojs.getComponent('Button');
485 class ImageSubtitleButton extends Button
486 {
487 buildCSSClass ()
488 {
489 return `${super.buildCSSClass()} vjs-image-subtitle-button`;
490 }
491
492 createEl ()
493 {
494 const el = super.createEl();
495 el.type = 'button';
496 el.setAttribute('title', 'Image subtitles');
497 el.setAttribute('aria-label', 'Image subtitles');
498 el.innerHTML = '<span aria-hidden="true">IM</span>';
499 return el;
500 }
501
502 handleClick ()
503 {
504 const controller = this.player().imageSubtitleOverlayController;
505 if (controller) controller.toggleMenu();
506 }
507 }
508
509 videojs.registerComponent('ImageSubtitleButton', ImageSubtitleButton);
510 };
511
512 const attachUi = () =>
513 {
514 if (!player.el()) return;
515 registerButton();
516 if (overlayEl.parentElement !== player.el()) player.el().appendChild(overlayEl);
517 if (menuEl.parentElement !== player.el()) player.el().appendChild(menuEl);
518 const controlBar = typeof player.getChild === 'function' ? player.getChild('controlBar') : null;
519 if (controlBar && typeof controlBar.addChild === 'function' && !buttonEl)
520 {
521 const button = controlBar.addChild('ImageSubtitleButton', {});
522 buttonEl = button && typeof button.el === 'function' ? button.el() : null;
523 updateButtonState();
524 }
525 };
526
527 const applySavedTracks = () =>
528 {
529 const savedName = normaliseTrackName(prefs.imageSubtitleTrackName);
530 if (savedName)
531 {
532 const savedByName = imageTracks.find((track) => normaliseTrackName(track.label) === savedName) || null;
533 if (savedByName)
534 {
535 setSelectedStreamIndex(savedByName.streamIndex, { persist: false });
536 return;
537 }
538 }
539
540 const savedIndex = Number(prefs.imageSubtitleTrackStreamIndex);
541 if (Number.isInteger(savedIndex) && trackByStreamIndex.has(savedIndex))
542 {
543 setSelectedStreamIndex(savedIndex, { persist: false });
544 return;
545 }
546
547 const defaultTrack = imageTracks.find((track) => track.isDefault) || null;
548 if (defaultTrack)
549 {
550 setSelectedStreamIndex(defaultTrack.streamIndex, { persist: false });
551 return;
552 }
553
554 setSelectedStreamIndex(null, { persist: false });
555 };
556
557 player.imageSubtitleOverlayController = {
558 toggleMenu,
559 closeMenu,
560 applySavedTracks,
561 captureSelectedTracks: saveSelection,
562 detach: dispose,
563 };
564
565 player.on('timeupdate', () => { void refreshFrame(); });
566 player.on('seeking', () => { void refreshFrame(true); });
567 player.on('play', () => { void refreshFrame(true); });
568 player.on('fullscreenchange', () => { closeMenu(); void refreshFrame(true); });
569 player.on('dispose', dispose);
570 player.ready(() =>
571 {
572 attachUi();
573 updateMenuState();
574 updateButtonState();
575 applySavedTracks();
576 if (menuOpen) openMenu();
577 });
578
579 return player.imageSubtitleOverlayController;
580 }
581
582 function formatDurationForDebug (seconds)
583 {
584 const value = Number(seconds);
585 if (!Number.isFinite(value) || value < 0) return 'unknown';
586
587 const totalSeconds = Math.floor(value);
588 const hh = String(Math.floor(totalSeconds / 3600)).padStart(2, '0');
589 const mm = String(Math.floor((totalSeconds % 3600) / 60)).padStart(2, '0');
590 const ss = String(totalSeconds % 60).padStart(2, '0');
591 return `${hh}:${mm}:${ss}`;
592 }
593
594 function installDurationFallback (player, originalDuration, duration)
595 {
596 if (!player || !originalDuration || player.__filemanagerDurationFallback) return;
597
598 player.__filemanagerDurationFallback = true;
599 player.duration = function durationWithFallback (...args)
600 {
601 if (args.length) return originalDuration(...args);
602 const current = Number(originalDuration());
603 return Number.isFinite(current) && current >= duration * 0.95 ? current : duration;
604 };
605 }
606
607 function normaliseVideoDuration (player, durationSeconds)
608 {
609 const duration = Number(durationSeconds);
610 if (!player || !Number.isFinite(duration) || duration <= 0) return;
611
612 let originalDuration = null;
613 let durationWasChanged = false;
614 try
615 {
616 originalDuration = typeof player.duration === 'function' ? player.duration.bind(player) : null;
617 installDurationFallback(player, originalDuration, duration);
618 if (player.__filemanagerDurationApplied) return;
619
620 const current = originalDuration ? Number(originalDuration()) : NaN;
621 const withinTolerance = Number.isFinite(current) && current >= duration * 0.95;
622 console.log(`Current duration: ${formatDurationForDebug(current)}, Target time: ${formatDurationForDebug(duration)}, within 95%? ${withinTolerance ? 'yes' : 'no'}`);
623 if (withinTolerance)
624 {
625 player.__filemanagerDurationApplied = true;
626 return;
627 }
628
629 if (originalDuration)
630 {
631 durationWasChanged = true;
632 originalDuration(duration);
633 }
634 } catch
635 {
636 // Ignore players that do not support setting duration.
637 }
638
639 try
640 {
641 const updated = originalDuration ? Number(originalDuration()) : NaN;
642 if (Number.isFinite(updated) && updated >= duration * 0.95)
643 {
644 player.__filemanagerDurationApplied = true;
645 if (durationWasChanged && typeof player.trigger === 'function') player.trigger('durationchange');
646 return;
647 }
648
649 player.__filemanagerDurationApplied = true;
650 if (typeof player.trigger === 'function') player.trigger('durationchange');
651 } catch
652 {
653 // Ignore duration fallback failures.
654 }
655 }
656
657 function ensureVideoPlaybackUi (player, durationSeconds)
658 {
659 if (!player || typeof player.on !== 'function') return;
660
661 const forceVodUi = () =>
662 {
663 normaliseVideoDuration(player, durationSeconds);
664
665 try
666 {
667 if (player.liveTracker && typeof player.liveTracker.stopTracking === 'function')
668 {
669 player.liveTracker.stopTracking();
670 }
671 } catch
672 {
673 // Ignore live tracker availability issues.
674 }
675
676 try
677 {
678 if (typeof player.removeClass === 'function')
679 {
680 player.removeClass('vjs-live');
681 }
682 } catch
683 {
684 // Ignore class update failures.
685 }
686
687 try
688 {
689 const display = player.el && player.el() && player.el().querySelector('.vjs-live-display');
690 if (display) display.style.display = 'none';
691 } catch
692 {
693 // Ignore missing DOM.
694 }
695 };
696
697 player.ready(forceVodUi);
698 player.on('loadedmetadata', forceVodUi);
699 player.on('durationchange', forceVodUi);
700 player.on('loadedplaylist', forceVodUi);
701 }
702
703 function configureVideoJsBuffering (videojs, opts = {})
704 {
705 if (opts.enabled === false) return;
706 if (!videojs || !videojs.Vhs || videojs.__filemanagerBufferingConfigured) return;
707 videojs.__filemanagerBufferingConfigured = true;
708
709 const seconds = Number(opts.seconds);
710 const bufferSeconds = Number.isFinite(seconds) && seconds > 0 ? seconds : 60 * 60;
711
712 try
713 {
714 videojs.Vhs.GOAL_BUFFER_LENGTH = bufferSeconds;
715 videojs.Vhs.MAX_GOAL_BUFFER_LENGTH = bufferSeconds;
716 } catch
717 {
718 // Ignore builds that do not expose VHS buffer configuration.
719 }
720 }
721
722 function applyDefaultTextTrackPrefs ()
723 {
724 try
725 {
726 localStorage.setItem(VIDEO_TEXT_TRACK_SETTINGS_KEY, VIDEO_TEXT_TRACK_OVERRIDE_SETTINGS_RAW);
727 } catch
728 {
729 // Ignore localStorage failures.
730 }
731 }
732
733 window.FilemanagerSharedVideoPlayer = {
734 applyDefaultTextTrackPrefs,
735 bindImageSubtitleOverlay,
736 bindTrackPrefs,
737 configureVideoJsBuffering,
738 ensureVideoPlaybackUi,
739 normaliseVideoDuration,
740 };
741}());
server/routes/share.js +88 −1
@@ -10,7 +10,9 @@ const router = express.Router();
10 10 const { getDb } = require('../db');
11 11 const { requireAuth } = require('../auth');
12 12 const { loadConfig, getEffectivePaths, getAllowedRoot } = require('../config');
13 const { createVideoStreamSession, sendVideoStreamAsset } = require('../video-stream');
13 const { createVideoStreamSession, sendVideoStreamAsset, releaseVideoStreamSession } = require('../video-stream');
14 const { renderImageSubtitleFrame } = require('../image-subtitles');
15 const { logError } = require('../logger');
14 16
15 17 const SHARE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
16 18 const ZIP_CACHE_DIR = path.join(__dirname, '../../zip-cache');
@@ -341,6 +343,91 @@ router.get('/video-stream/session/:sessionId/:assetPath(*)', async (req, res, ne
341 343 }
342 344 });
343 345
346 // ---------------------------------------------------------------------------
347 // DELETE /api/share/video-stream/session/:sessionId
348 // Public. Explicitly releases an active shared video-stream lease.
349 // ---------------------------------------------------------------------------
350 router.delete('/video-stream/session/:sessionId', async (req, res, next) =>
351 {
352 try
353 {
354 releaseVideoStreamSession(String(req.params.sessionId || ''));
355 res.json({ ok: true });
356 } catch (err)
357 {
358 next(err);
359 }
360 });
361
362 // ---------------------------------------------------------------------------
363 // GET /api/share/video-stream-subtitle-frame/:token
364 // Public. Returns a rendered PNG subtitle bitmap for shared video playback.
365 // Query params: streamIndex, timeSeconds, videoWidth, videoHeight
366 // ---------------------------------------------------------------------------
367 router.get('/video-stream-subtitle-frame/:token', async (req, res) =>
368 {
369 try
370 {
371 const token = String(req.params.token || '').trim();
372 const streamIndex = Number.parseInt(String(req.query.streamIndex || ''), 10);
373 const timeSeconds = Number.parseFloat(String(req.query.timeSeconds || ''), 10);
374 const videoWidth = Number.parseInt(String(req.query.videoWidth || ''), 10);
375 const videoHeight = Number.parseInt(String(req.query.videoHeight || ''), 10);
376
377 if (!token || !Number.isInteger(streamIndex) || streamIndex < 0 || !Number.isFinite(timeSeconds) || timeSeconds < 0)
378 {
379 return res.status(400).json({ error: 'token, streamIndex (non-negative int), and timeSeconds (non-negative number) are required.' });
380 }
381
382 const db = getDb();
383 const row = db.prepare('SELECT * FROM share_tokens WHERE token = ?').get([token]);
384 if (!row) return res.status(404).json({ error: 'Share link not found.' });
385 if (Date.now() > row.expires_at) return res.status(410).json({ error: 'Share link has expired.' });
386 if (row.is_dir) return res.status(400).json({ error: 'Cannot preview a directory.' });
387
388 if (!fs.existsSync(row.file_path) || fs.statSync(row.file_path).isDirectory())
389 {
390 return res.status(404).json({ error: 'File not found.' });
391 }
392
393 const canvasWidth = Number.isInteger(videoWidth) && videoWidth > 0 ? videoWidth : 1280;
394 const canvasHeight = Number.isInteger(videoHeight) && videoHeight > 0 ? videoHeight : 720;
395 const frameData = await renderImageSubtitleFrame({
396 filePath: row.file_path,
397 streamIndex,
398 timeSeconds,
399 canvasWidth,
400 canvasHeight,
401 });
402
403 if (!frameData || !frameData.frame)
404 {
405 res.set('X-Subtitle-Frame-Status', 'none');
406 return res.status(204).end();
407 }
408
409 res.set('X-Subtitle-Frame-Status', 'ok');
410 res.set('X-Subtitle-Frame-Left', String(frameData.left || 0));
411 res.set('X-Subtitle-Frame-Top', String(frameData.top || 0));
412 res.set('X-Subtitle-Frame-Width', String(frameData.width || 0));
413 res.set('X-Subtitle-Frame-Height', String(frameData.height || 0));
414 res.set('X-Subtitle-Frame-Canvas-Width', String(frameData.canvasWidth || 1280));
415 res.set('X-Subtitle-Frame-Canvas-Height', String(frameData.canvasHeight || 720));
416 res.set('Content-Type', 'image/png');
417 res.set('Cache-Control', 'private, max-age=3600');
418 res.send(frameData.frame);
419 } catch (err)
420 {
421 logError('Shared subtitle frame extraction failed', err, {
422 token: String(req.params.token || ''),
423 streamIndex: Number.parseInt(String(req.query.streamIndex || ''), 10),
424 timeSeconds: Number.parseFloat(String(req.query.timeSeconds || ''), 10),
425 });
426 res.set('X-Subtitle-Frame-Status', 'error');
427 return res.status(204).end();
428 }
429 });
430
344 431 // ---------------------------------------------------------------------------
345 432 // GET /api/share/download/:token
346 433 // Public (no auth). Streams the file or a zip of the directory.
@@ -10,7 +10,9 @@ const router = express.Router();
10const { getDb } = require('../db');
10const { getDb } = require('../db');
11const { requireAuth } = require('../auth');
11const { requireAuth } = require('../auth');
12const { loadConfig, getEffectivePaths, getAllowedRoot } = require('../config');
12const { loadConfig, getEffectivePaths, getAllowedRoot } = require('../config');
13const { createVideoStreamSession, sendVideoStreamAsset } = require('../video-stream');
13const { createVideoStreamSession, sendVideoStreamAsset, releaseVideoStreamSession } = require('../video-stream');
14const { renderImageSubtitleFrame } = require('../image-subtitles');
15const { logError } = require('../logger');
14
16
15const SHARE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
17const SHARE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
16const ZIP_CACHE_DIR = path.join(__dirname, '../../zip-cache');
18const ZIP_CACHE_DIR = path.join(__dirname, '../../zip-cache');
@@ -341,6 +343,91 @@ router.get('/video-stream/session/:sessionId/:assetPath(*)', async (req, res, ne
341 }
343 }
342});
344});
343
345
346// ---------------------------------------------------------------------------
347// DELETE /api/share/video-stream/session/:sessionId
348// Public. Explicitly releases an active shared video-stream lease.
349// ---------------------------------------------------------------------------
350router.delete('/video-stream/session/:sessionId', async (req, res, next) =>
351{
352 try
353 {
354 releaseVideoStreamSession(String(req.params.sessionId || ''));
355 res.json({ ok: true });
356 } catch (err)
357 {
358 next(err);
359 }
360});
361
362// ---------------------------------------------------------------------------
363// GET /api/share/video-stream-subtitle-frame/:token
364// Public. Returns a rendered PNG subtitle bitmap for shared video playback.
365// Query params: streamIndex, timeSeconds, videoWidth, videoHeight
366// ---------------------------------------------------------------------------
367router.get('/video-stream-subtitle-frame/:token', async (req, res) =>
368{
369 try
370 {
371 const token = String(req.params.token || '').trim();
372 const streamIndex = Number.parseInt(String(req.query.streamIndex || ''), 10);
373 const timeSeconds = Number.parseFloat(String(req.query.timeSeconds || ''), 10);
374 const videoWidth = Number.parseInt(String(req.query.videoWidth || ''), 10);
375 const videoHeight = Number.parseInt(String(req.query.videoHeight || ''), 10);
376
377 if (!token || !Number.isInteger(streamIndex) || streamIndex < 0 || !Number.isFinite(timeSeconds) || timeSeconds < 0)
378 {
379 return res.status(400).json({ error: 'token, streamIndex (non-negative int), and timeSeconds (non-negative number) are required.' });
380 }
381
382 const db = getDb();
383 const row = db.prepare('SELECT * FROM share_tokens WHERE token = ?').get([token]);
384 if (!row) return res.status(404).json({ error: 'Share link not found.' });
385 if (Date.now() > row.expires_at) return res.status(410).json({ error: 'Share link has expired.' });
386 if (row.is_dir) return res.status(400).json({ error: 'Cannot preview a directory.' });
387
388 if (!fs.existsSync(row.file_path) || fs.statSync(row.file_path).isDirectory())
389 {
390 return res.status(404).json({ error: 'File not found.' });
391 }
392
393 const canvasWidth = Number.isInteger(videoWidth) && videoWidth > 0 ? videoWidth : 1280;
394 const canvasHeight = Number.isInteger(videoHeight) && videoHeight > 0 ? videoHeight : 720;
395 const frameData = await renderImageSubtitleFrame({
396 filePath: row.file_path,
397 streamIndex,
398 timeSeconds,
399 canvasWidth,
400 canvasHeight,
401 });
402
403 if (!frameData || !frameData.frame)
404 {
405 res.set('X-Subtitle-Frame-Status', 'none');
406 return res.status(204).end();
407 }
408
409 res.set('X-Subtitle-Frame-Status', 'ok');
410 res.set('X-Subtitle-Frame-Left', String(frameData.left || 0));
411 res.set('X-Subtitle-Frame-Top', String(frameData.top || 0));
412 res.set('X-Subtitle-Frame-Width', String(frameData.width || 0));
413 res.set('X-Subtitle-Frame-Height', String(frameData.height || 0));
414 res.set('X-Subtitle-Frame-Canvas-Width', String(frameData.canvasWidth || 1280));
415 res.set('X-Subtitle-Frame-Canvas-Height', String(frameData.canvasHeight || 720));
416 res.set('Content-Type', 'image/png');
417 res.set('Cache-Control', 'private, max-age=3600');
418 res.send(frameData.frame);
419 } catch (err)
420 {
421 logError('Shared subtitle frame extraction failed', err, {
422 token: String(req.params.token || ''),
423 streamIndex: Number.parseInt(String(req.query.streamIndex || ''), 10),
424 timeSeconds: Number.parseFloat(String(req.query.timeSeconds || ''), 10),
425 });
426 res.set('X-Subtitle-Frame-Status', 'error');
427 return res.status(204).end();
428 }
429});
430
344// ---------------------------------------------------------------------------
431// ---------------------------------------------------------------------------
345// GET /api/share/download/:token
432// GET /api/share/download/:token
346// Public (no auth). Streams the file or a zip of the directory.
433// Public (no auth). Streams the file or a zip of the directory.
tests/share.page.load.test.js +85 −1
@@ -38,6 +38,9 @@ describe('share page video preview', () =>
38 38 { label: 'English', language: 'eng', default: true, src: '/api/share/video-stream/session/share-video-session/subtitle-0.vtt' },
39 39 { label: 'French', language: 'fra', default: false, src: '/api/share/video-stream/session/share-video-session/subtitle-1.vtt' },
40 40 ],
41 imageSubtitleTracks: [
42 { label: 'PGS English', language: 'eng', default: false, streamIndex: 0 },
43 ],
41 44 subtitleSummary: { total: 2, converted: 2, skipped: 0 },
42 45 };
43 46
@@ -76,6 +79,16 @@ describe('share page video preview', () =>
76 79 res.json(shareVideoStreamFixture);
77 80 });
78 81
82 app.get('/api/share/video-stream-subtitle-frame/:token', (req, res) =>
83 {
84 res.set('X-Subtitle-Frame-Status', 'none').status(204).end();
85 });
86
87 app.delete('/api/share/video-stream/session/:sessionId', (req, res) =>
88 {
89 res.json({ ok: true });
90 });
91
79 92 app.get('/share/:token', (req, res) =>
80 93 {
81 94 res.sendFile(path.join(publicDir, 'share.html'));
@@ -128,6 +141,7 @@ describe('share page video preview', () =>
128 141 { label: 'Stereo', enabled: true },
129 142 { label: 'Director commentary', enabled: false },
130 143 ];
144 const registeredComponents = new Map();
131 145
132 146 if (initialSharePrefs)
133 147 {
@@ -180,6 +194,40 @@ describe('share page video preview', () =>
180 194 return list;
181 195 }
182 196
197 class MockButton
198 {
199 constructor (player)
200 {
201 this._player = player;
202 this._el = null;
203 }
204
205 player ()
206 {
207 return this._player;
208 }
209
210 buildCSSClass ()
211 {
212 return 'vjs-control';
213 }
214
215 createEl ()
216 {
217 const el = window.document.createElement('button');
218 el.className = this.buildCSSClass();
219 return el;
220 }
221
222 el ()
223 {
224 if (!this._el) this._el = this.createEl();
225 return this._el;
226 }
227 }
228
229 registeredComponents.set('Button', MockButton);
230
183 231 window.videojs = (element, options) =>
184 232 {
185 233 window.__lastVideoJsOptions = options;
@@ -187,6 +235,7 @@ describe('share page video preview', () =>
187 235 let volumeValue = 1;
188 236 let durationValue = 20;
189 237 const playerEvents = new Map();
238 const playerElement = element;
190 239
191 240 const textTracks = makeTrackList((options?.tracks || []).map((track) => ({
192 241 kind: track.kind,
@@ -241,7 +290,34 @@ describe('share page video preview', () =>
241 290 {
242 291 return audioTracks;
243 292 },
244 dispose () { },
293 currentTime ()
294 {
295 return 0;
296 },
297 el ()
298 {
299 return playerElement;
300 },
301 getChild (name)
302 {
303 if (name !== 'controlBar') return null;
304 return {
305 addChild (componentName)
306 {
307 const Component = registeredComponents.get(componentName);
308 if (!Component) return null;
309 const instance = new Component(player);
310 playerElement.appendChild(instance.el());
311 return instance;
312 },
313 };
314 },
315 dispose ()
316 {
317 const listeners = playerEvents.get('dispose');
318 if (!listeners) return;
319 for (const fn of Array.from(listeners)) fn();
320 },
245 321 liveTracker: {
246 322 stopTracking () { },
247 323 },
@@ -252,6 +328,12 @@ describe('share page video preview', () =>
252 328 return player;
253 329 };
254 330
331 window.videojs.getComponent = (name) => registeredComponents.get(name);
332 window.videojs.registerComponent = (name, component) =>
333 {
334 registeredComponents.set(name, component);
335 };
336
255 337 window.videojs.Vhs = {
256 338 GOAL_BUFFER_LENGTH: 0,
257 339 MAX_GOAL_BUFFER_LENGTH: 0,
@@ -283,6 +365,8 @@ describe('share page video preview', () =>
283 365
284 366 expect(runtimeErrors).toEqual([]);
285 367 expect(dom.window.localStorage.getItem('vjs-text-track-settings')).toBe(DEFAULT_VIDEO_TEXT_TRACK_SETTINGS_RAW);
368 expect(dom.window.__lastVideoJsPlayer.imageSubtitleOverlayController).toEqual(expect.any(Object));
369 expect(dom.window.document.querySelector('#preview-wrap [title="Image subtitles"]')).toBeTruthy();
286 370
287 371 dom.window.close();
288 372 });
@@ -38,6 +38,9 @@ describe('share page video preview', () =>
38 { label: 'English', language: 'eng', default: true, src: '/api/share/video-stream/session/share-video-session/subtitle-0.vtt' },
38 { label: 'English', language: 'eng', default: true, src: '/api/share/video-stream/session/share-video-session/subtitle-0.vtt' },
39 { label: 'French', language: 'fra', default: false, src: '/api/share/video-stream/session/share-video-session/subtitle-1.vtt' },
39 { label: 'French', language: 'fra', default: false, src: '/api/share/video-stream/session/share-video-session/subtitle-1.vtt' },
40 ],
40 ],
41 imageSubtitleTracks: [
42 { label: 'PGS English', language: 'eng', default: false, streamIndex: 0 },
43 ],
41 subtitleSummary: { total: 2, converted: 2, skipped: 0 },
44 subtitleSummary: { total: 2, converted: 2, skipped: 0 },
42 };
45 };
43
46
@@ -76,6 +79,16 @@ describe('share page video preview', () =>
76 res.json(shareVideoStreamFixture);
79 res.json(shareVideoStreamFixture);
77 });
80 });
78
81
82 app.get('/api/share/video-stream-subtitle-frame/:token', (req, res) =>
83 {
84 res.set('X-Subtitle-Frame-Status', 'none').status(204).end();
85 });
86
87 app.delete('/api/share/video-stream/session/:sessionId', (req, res) =>
88 {
89 res.json({ ok: true });
90 });
91
79 app.get('/share/:token', (req, res) =>
92 app.get('/share/:token', (req, res) =>
80 {
93 {
81 res.sendFile(path.join(publicDir, 'share.html'));
94 res.sendFile(path.join(publicDir, 'share.html'));
@@ -128,6 +141,7 @@ describe('share page video preview', () =>
128 { label: 'Stereo', enabled: true },
141 { label: 'Stereo', enabled: true },
129 { label: 'Director commentary', enabled: false },
142 { label: 'Director commentary', enabled: false },
130 ];
143 ];
144 const registeredComponents = new Map();
131
145
132 if (initialSharePrefs)
146 if (initialSharePrefs)
133 {
147 {
@@ -180,6 +194,40 @@ describe('share page video preview', () =>
180 return list;
194 return list;
181 }
195 }
182
196
197 class MockButton
198 {
199 constructor (player)
200 {
201 this._player = player;
202 this._el = null;
203 }
204
205 player ()
206 {
207 return this._player;
208 }
209
210 buildCSSClass ()
211 {
212 return 'vjs-control';
213 }
214
215 createEl ()
216 {
217 const el = window.document.createElement('button');
218 el.className = this.buildCSSClass();
219 return el;
220 }
221
222 el ()
223 {
224 if (!this._el) this._el = this.createEl();
225 return this._el;
226 }
227 }
228
229 registeredComponents.set('Button', MockButton);
230
183 window.videojs = (element, options) =>
231 window.videojs = (element, options) =>
184 {
232 {
185 window.__lastVideoJsOptions = options;
233 window.__lastVideoJsOptions = options;
@@ -187,6 +235,7 @@ describe('share page video preview', () =>
187 let volumeValue = 1;
235 let volumeValue = 1;
188 let durationValue = 20;
236 let durationValue = 20;
189 const playerEvents = new Map();
237 const playerEvents = new Map();
238 const playerElement = element;
190
239
191 const textTracks = makeTrackList((options?.tracks || []).map((track) => ({
240 const textTracks = makeTrackList((options?.tracks || []).map((track) => ({
192 kind: track.kind,
241 kind: track.kind,
@@ -241,7 +290,34 @@ describe('share page video preview', () =>
241 {
290 {
242 return audioTracks;
291 return audioTracks;
243 },
292 },
244 dispose () { },
293 currentTime ()
294 {
295 return 0;
296 },
297 el ()
298 {
299 return playerElement;
300 },
301 getChild (name)
302 {
303 if (name !== 'controlBar') return null;
304 return {
305 addChild (componentName)
306 {
307 const Component = registeredComponents.get(componentName);
308 if (!Component) return null;
309 const instance = new Component(player);
310 playerElement.appendChild(instance.el());
311 return instance;
312 },
313 };
314 },
315 dispose ()
316 {
317 const listeners = playerEvents.get('dispose');
318 if (!listeners) return;
319 for (const fn of Array.from(listeners)) fn();
320 },
245 liveTracker: {
321 liveTracker: {
246 stopTracking () { },
322 stopTracking () { },
247 },
323 },
@@ -252,6 +328,12 @@ describe('share page video preview', () =>
252 return player;
328 return player;
253 };
329 };
254
330
331 window.videojs.getComponent = (name) => registeredComponents.get(name);
332 window.videojs.registerComponent = (name, component) =>
333 {
334 registeredComponents.set(name, component);
335 };
336
255 window.videojs.Vhs = {
337 window.videojs.Vhs = {
256 GOAL_BUFFER_LENGTH: 0,
338 GOAL_BUFFER_LENGTH: 0,
257 MAX_GOAL_BUFFER_LENGTH: 0,
339 MAX_GOAL_BUFFER_LENGTH: 0,
@@ -283,6 +365,8 @@ describe('share page video preview', () =>
283
365
284 expect(runtimeErrors).toEqual([]);
366 expect(runtimeErrors).toEqual([]);
285 expect(dom.window.localStorage.getItem('vjs-text-track-settings')).toBe(DEFAULT_VIDEO_TEXT_TRACK_SETTINGS_RAW);
367 expect(dom.window.localStorage.getItem('vjs-text-track-settings')).toBe(DEFAULT_VIDEO_TEXT_TRACK_SETTINGS_RAW);
368 expect(dom.window.__lastVideoJsPlayer.imageSubtitleOverlayController).toEqual(expect.any(Object));
369 expect(dom.window.document.querySelector('#preview-wrap [title="Image subtitles"]')).toBeTruthy();
286
370
287 dom.window.close();
371 dom.window.close();
288 });
372 });
tests/share.routes.test.js +62 −0
@@ -12,6 +12,9 @@ let mockUserPath = null;
12 12 let mockUser = { username: 'testuser', isAdmin: true, permissions: {} };
13 13 let mockVideoStreamSession = null;
14 14 let mockVideoStreamAsset = null;
15 let releasedVideoStreamSessionId = null;
16 let mockSubtitleFrameResult = null;
17 let mockSubtitleFrameError = null;
15 18
16 19 jest.mock('../server/db', () =>
17 20 {
@@ -73,6 +76,22 @@ jest.mock('../server/video-stream', () => ({
73 76 }
74 77 res.type('application/vnd.apple.mpegurl').send('#EXTM3U\n');
75 78 }),
79 releaseVideoStreamSession: jest.fn((sessionId) =>
80 {
81 releasedVideoStreamSessionId = sessionId;
82 }),
83 }));
84
85 jest.mock('../server/image-subtitles', () => ({
86 renderImageSubtitleFrame: jest.fn(async () =>
87 {
88 if (mockSubtitleFrameError) throw mockSubtitleFrameError;
89 return mockSubtitleFrameResult;
90 }),
91 }));
92
93 jest.mock('../server/logger', () => ({
94 logError: jest.fn(),
76 95 }));
77 96
78 97 const shareRoutes = require('../server/routes/share');
@@ -129,6 +148,9 @@ beforeEach(() =>
129 148 mockUserPath = null;
130 149 mockVideoStreamSession = null;
131 150 mockVideoStreamAsset = null;
151 releasedVideoStreamSessionId = null;
152 mockSubtitleFrameResult = null;
153 mockSubtitleFrameError = null;
132 154 // Reset DB between tests
133 155 const db = getDb();
134 156 db.exec('DELETE FROM share_tokens');
@@ -352,6 +374,46 @@ describe('GET /api/share/video-stream/:token', () =>
352 374 expect(res.status).toBe(200);
353 375 expect(await res.text()).toBe('#EXTM3U\n');
354 376 });
377
378 test('releases an existing share stream session', async () =>
379 {
380 const res = await fetch(baseUrl + '/api/share/video-stream/session/share-sess-1', {
381 method: 'DELETE',
382 });
383
384 expect(res.status).toBe(200);
385 expect(await res.json()).toEqual({ ok: true });
386 expect(releasedVideoStreamSessionId).toBe('share-sess-1');
387 });
388
389 test('renders image subtitle frames for a shared video', async () =>
390 {
391 const filePath = path.join(rootDir, 'movie-subs.mkv');
392 fs.writeFileSync(filePath, 'video');
393 insertToken({ token: 'stream-subs', filePath });
394 mockSubtitleFrameResult = {
395 frame: Buffer.from('png-data'),
396 left: 100,
397 top: 50,
398 width: 320,
399 height: 180,
400 canvasWidth: 640,
401 canvasHeight: 360,
402 };
403
404 const res = await get('/api/share/video-stream-subtitle-frame/stream-subs?streamIndex=0&timeSeconds=2.5&videoWidth=1920&videoHeight=1080');
405
406 expect(res.status).toBe(200);
407 expect(res.headers.get('content-type')).toMatch(/image\/png/);
408 expect(res.headers.get('x-subtitle-frame-status')).toBe('ok');
409 expect(res.headers.get('x-subtitle-frame-left')).toBe('100');
410 expect(res.headers.get('x-subtitle-frame-top')).toBe('50');
411 expect(res.headers.get('x-subtitle-frame-width')).toBe('320');
412 expect(res.headers.get('x-subtitle-frame-height')).toBe('180');
413 expect(res.headers.get('x-subtitle-frame-canvas-width')).toBe('640');
414 expect(res.headers.get('x-subtitle-frame-canvas-height')).toBe('360');
415 expect(Buffer.from(await res.arrayBuffer()).equals(Buffer.from('png-data'))).toBe(true);
416 });
355 417 });
356 418
357 419 // ---------------------------------------------------------------------------
@@ -12,6 +12,9 @@ let mockUserPath = null;
12let mockUser = { username: 'testuser', isAdmin: true, permissions: {} };
12let mockUser = { username: 'testuser', isAdmin: true, permissions: {} };
13let mockVideoStreamSession = null;
13let mockVideoStreamSession = null;
14let mockVideoStreamAsset = null;
14let mockVideoStreamAsset = null;
15let releasedVideoStreamSessionId = null;
16let mockSubtitleFrameResult = null;
17let mockSubtitleFrameError = null;
15
18
16jest.mock('../server/db', () =>
19jest.mock('../server/db', () =>
17{
20{
@@ -73,6 +76,22 @@ jest.mock('../server/video-stream', () => ({
73 }
76 }
74 res.type('application/vnd.apple.mpegurl').send('#EXTM3U\n');
77 res.type('application/vnd.apple.mpegurl').send('#EXTM3U\n');
75 }),
78 }),
79 releaseVideoStreamSession: jest.fn((sessionId) =>
80 {
81 releasedVideoStreamSessionId = sessionId;
82 }),
83}));
84
85jest.mock('../server/image-subtitles', () => ({
86 renderImageSubtitleFrame: jest.fn(async () =>
87 {
88 if (mockSubtitleFrameError) throw mockSubtitleFrameError;
89 return mockSubtitleFrameResult;
90 }),
91}));
92
93jest.mock('../server/logger', () => ({
94 logError: jest.fn(),
76}));
95}));
77
96
78const shareRoutes = require('../server/routes/share');
97const shareRoutes = require('../server/routes/share');
@@ -129,6 +148,9 @@ beforeEach(() =>
129 mockUserPath = null;
148 mockUserPath = null;
130 mockVideoStreamSession = null;
149 mockVideoStreamSession = null;
131 mockVideoStreamAsset = null;
150 mockVideoStreamAsset = null;
151 releasedVideoStreamSessionId = null;
152 mockSubtitleFrameResult = null;
153 mockSubtitleFrameError = null;
132 // Reset DB between tests
154 // Reset DB between tests
133 const db = getDb();
155 const db = getDb();
134 db.exec('DELETE FROM share_tokens');
156 db.exec('DELETE FROM share_tokens');
@@ -352,6 +374,46 @@ describe('GET /api/share/video-stream/:token', () =>
352 expect(res.status).toBe(200);
374 expect(res.status).toBe(200);
353 expect(await res.text()).toBe('#EXTM3U\n');
375 expect(await res.text()).toBe('#EXTM3U\n');
354 });
376 });
377
378 test('releases an existing share stream session', async () =>
379 {
380 const res = await fetch(baseUrl + '/api/share/video-stream/session/share-sess-1', {
381 method: 'DELETE',
382 });
383
384 expect(res.status).toBe(200);
385 expect(await res.json()).toEqual({ ok: true });
386 expect(releasedVideoStreamSessionId).toBe('share-sess-1');
387 });
388
389 test('renders image subtitle frames for a shared video', async () =>
390 {
391 const filePath = path.join(rootDir, 'movie-subs.mkv');
392 fs.writeFileSync(filePath, 'video');
393 insertToken({ token: 'stream-subs', filePath });
394 mockSubtitleFrameResult = {
395 frame: Buffer.from('png-data'),
396 left: 100,
397 top: 50,
398 width: 320,
399 height: 180,
400 canvasWidth: 640,
401 canvasHeight: 360,
402 };
403
404 const res = await get('/api/share/video-stream-subtitle-frame/stream-subs?streamIndex=0&timeSeconds=2.5&videoWidth=1920&videoHeight=1080');
405
406 expect(res.status).toBe(200);
407 expect(res.headers.get('content-type')).toMatch(/image\/png/);
408 expect(res.headers.get('x-subtitle-frame-status')).toBe('ok');
409 expect(res.headers.get('x-subtitle-frame-left')).toBe('100');
410 expect(res.headers.get('x-subtitle-frame-top')).toBe('50');
411 expect(res.headers.get('x-subtitle-frame-width')).toBe('320');
412 expect(res.headers.get('x-subtitle-frame-height')).toBe('180');
413 expect(res.headers.get('x-subtitle-frame-canvas-width')).toBe('640');
414 expect(res.headers.get('x-subtitle-frame-canvas-height')).toBe('360');
415 expect(Buffer.from(await res.arrayBuffer()).equals(Buffer.from('png-data'))).toBe(true);
416 });
355});
417});
356
418
357// ---------------------------------------------------------------------------
419// ---------------------------------------------------------------------------