From 96182bbaf1d29a94e5e61bd87dbe3f6b0d4f02f6 Mon Sep 17 00:00:00 2001 From: Aghyad Date: Sat, 19 Sep 2026 21:29:26 +0400 Subject: [PATCH 1/4] feat: add subtitle cinema player --- README.md | 1 + messages/en.json | 4 + src/__tests__/lib/srt.test.ts | 15 ++++ .../opengraph-image.tsx | 9 ++ src/app/tools/subtitle-cinema-player/page.tsx | 5 ++ .../subtitle-cinema-player/twitter-image.tsx | 9 ++ src/components/SubtitleCinemaPlayer.tsx | 82 +++++++++++++++++++ src/components/layout/tool-title.tsx | 1 + .../subtitle-cinema-player.module.css | 1 + src/lib/subtitles/srt.ts | 32 ++++++++ src/lib/tools-config.ts | 10 +++ 11 files changed, 169 insertions(+) create mode 100644 src/__tests__/lib/srt.test.ts create mode 100644 src/app/tools/subtitle-cinema-player/opengraph-image.tsx create mode 100644 src/app/tools/subtitle-cinema-player/page.tsx create mode 100644 src/app/tools/subtitle-cinema-player/twitter-image.tsx create mode 100644 src/components/SubtitleCinemaPlayer.tsx create mode 100644 src/components/subtitle-cinema-player.module.css create mode 100644 src/lib/subtitles/srt.ts diff --git a/README.md b/README.md index 2773b369..61c21cce 100644 --- a/README.md +++ b/README.md @@ -113,6 +113,7 @@ Two caveats worth stating plainly, since "everything is local" is the headline c - **Screen Recorder**: Record your screen, window, or tab directly in the browser using the Screen Capture API. - **GIF Maker**: Turn a series of images into an animated GIF. Reorder frames, set speed, loop, and resize. - **Subtitle Studio**: Transcribe a video into word-timed subtitles with an on-device Whisper model, style the captions, and burn them into your video. +- **Subtitle Cinema Player**: Watch local videos with precisely timed SRT subtitles, a searchable transcript, cinema mode, and playback controls. - **Video to Audio**: Extract audio from videos in your browser — MP3, M4A, OGG, or WAV out, with batch conversion, bitrate control, and optional trimming. - **Video Converter**: Convert videos between MP4, WebM, MKV, AVI, MOV, and GIF in your browser — choose resolution, quality, and audio, trim a range, and watch live progress with cancel. diff --git a/messages/en.json b/messages/en.json index 760bb715..7069ae6c 100644 --- a/messages/en.json +++ b/messages/en.json @@ -819,6 +819,10 @@ "word-to-pdf": { "name": "Word to PDF", "description": "Convert a Word (.docx) document into a PDF using your browser's print dialog — text stays selectable and searchable, entirely in your browser. Styling is normalized, not pixel-exact." + }, + "subtitle-cinema-player": { + "name": "Subtitle Cinema Player", + "description": "Watch local videos with perfectly timed SRT subtitles, a searchable transcript, cinema mode, and precise playback controls. Nothing is uploaded." } }, "categoriesShort": { diff --git a/src/__tests__/lib/srt.test.ts b/src/__tests__/lib/srt.test.ts new file mode 100644 index 00000000..9221443e --- /dev/null +++ b/src/__tests__/lib/srt.test.ts @@ -0,0 +1,15 @@ +import { describe, expect, it } from "vitest"; +import { activeCue, parseSrt, parseSrtTimestamp } from "@/lib/subtitles/srt"; + +describe("SRT timing", () => { + it("parses millisecond timestamps exactly", () => expect(parseSrtTimestamp("01:02:03,450")).toBe(3723.45)); + it("parses multiline cues and ignores malformed blocks", () => { + const cues = parseSrt("1\n00:00:01,000 --> 00:00:02,500\nHello\nworld\n\nbad\nno timing"); + expect(cues).toEqual([{ id: "1", start: 1, end: 2.5, text: "Hello\nworld" }]); + }); + it("applies offset while choosing the active cue", () => { + const cues = parseSrt("1\n00:00:01,000 --> 00:00:02,000\nHello"); + expect(activeCue(cues, 0.6, 0.5)?.text).toBe("Hello"); + expect(activeCue(cues, 2, 0.5)).toBeUndefined(); + }); +}); diff --git a/src/app/tools/subtitle-cinema-player/opengraph-image.tsx b/src/app/tools/subtitle-cinema-player/opengraph-image.tsx new file mode 100644 index 00000000..5f16e7a3 --- /dev/null +++ b/src/app/tools/subtitle-cinema-player/opengraph-image.tsx @@ -0,0 +1,9 @@ +import { generateToolOgImage, ogSize, ogContentType } from "@/lib/og-image"; + +export const alt = "subtitle-cinema-player | BrowseryTools"; +export const size = ogSize; +export const contentType = ogContentType; + +export default function Image() { + return generateToolOgImage("subtitle-cinema-player"); +} diff --git a/src/app/tools/subtitle-cinema-player/page.tsx b/src/app/tools/subtitle-cinema-player/page.tsx new file mode 100644 index 00000000..ac98f94c --- /dev/null +++ b/src/app/tools/subtitle-cinema-player/page.tsx @@ -0,0 +1,5 @@ +import SubtitleCinemaPlayer from "@/components/SubtitleCinemaPlayer"; +import { generateToolMetadata } from "@/lib/metadata"; + +export const metadata = generateToolMetadata("/tools/subtitle-cinema-player"); +export default function SubtitleCinemaPlayerPage() { return ; } diff --git a/src/app/tools/subtitle-cinema-player/twitter-image.tsx b/src/app/tools/subtitle-cinema-player/twitter-image.tsx new file mode 100644 index 00000000..5f16e7a3 --- /dev/null +++ b/src/app/tools/subtitle-cinema-player/twitter-image.tsx @@ -0,0 +1,9 @@ +import { generateToolOgImage, ogSize, ogContentType } from "@/lib/og-image"; + +export const alt = "subtitle-cinema-player | BrowseryTools"; +export const size = ogSize; +export const contentType = ogContentType; + +export default function Image() { + return generateToolOgImage("subtitle-cinema-player"); +} diff --git a/src/components/SubtitleCinemaPlayer.tsx b/src/components/SubtitleCinemaPlayer.tsx new file mode 100644 index 00000000..a64ff3e5 --- /dev/null +++ b/src/components/SubtitleCinemaPlayer.tsx @@ -0,0 +1,82 @@ +"use client"; + +import { useEffect, useMemo, useRef, useState } from "react"; +import { ToolShell } from "@/components/template/tool-shell"; +import { Button } from "@/components/ui/button"; +import { parseSrt, activeCue, type SubtitleCue } from "@/lib/subtitles/srt"; +import { Maximize, Minimize, Play, Pause, Upload, Search, Settings2 } from "lucide-react"; +import styles from "./subtitle-cinema-player.module.css"; + +const formatTime = (time: number) => `${Math.floor(time / 60)}:${String(Math.floor(time % 60)).padStart(2, "0")}`; + +export default function SubtitleCinemaPlayer() { + const videoRef = useRef(null); + const stageRef = useRef(null); + const [videoUrl, setVideoUrl] = useState(""); + const [cues, setCues] = useState([]); + const [currentTime, setCurrentTime] = useState(0); + const [playing, setPlaying] = useState(false); + const [offset, setOffset] = useState(0); + const [speed, setSpeed] = useState(1); + const [query, setQuery] = useState(""); + const [fontSize, setFontSize] = useState(1); + const [cinema, setCinema] = useState(false); + const [status, setStatus] = useState("Choose a video and an SRT file to begin."); + + useEffect(() => () => { if (videoUrl) URL.revokeObjectURL(videoUrl); }, [videoUrl]); + const current = activeCue(cues, currentTime, offset); + const filtered = useMemo(() => cues.filter((cue) => cue.text.toLowerCase().includes(query.toLowerCase())), [cues, query]); + + const loadVideo = (file?: File) => { + if (!file) return; + setVideoUrl((old) => { if (old) URL.revokeObjectURL(old); return URL.createObjectURL(file); }); + setStatus(`${file.name} loaded locally.`); + }; + const loadSrt = async (file?: File) => { + if (!file) return; + const parsed = parseSrt(await file.text()); + setCues(parsed); + setStatus(`${parsed.length} subtitle cues loaded locally.`); + }; + const togglePlay = () => { + const video = videoRef.current; + if (!video) return; + if (video.paused) void video.play(); else video.pause(); + }; + const seek = (time: number) => { if (videoRef.current) videoRef.current.currentTime = Math.max(0, time); setCurrentTime(Math.max(0, time)); }; + const toggleFullscreen = async () => { + if (!stageRef.current) return; + if (document.fullscreenElement) await document.exitFullscreen(); else await stageRef.current.requestFullscreen?.(); + }; + + return +
+
+ + + {status} +
+
+ {videoUrl ?
+
+ + + + +
+
+

Transcript

+ {filtered.map((cue) => )} + {!filtered.length &&

Load an SRT file to see clickable cues.

} +
+
+
; +} diff --git a/src/components/layout/tool-title.tsx b/src/components/layout/tool-title.tsx index 9bf96c79..69451237 100644 --- a/src/components/layout/tool-title.tsx +++ b/src/components/layout/tool-title.tsx @@ -247,6 +247,7 @@ const HAS_OWN_H1 = new Set([ "anagram-solver", // Wave 5 (W5) Task 7: Subtitle Studio ships directly on ToolShell. "subtitle-studio", + "subtitle-cinema-player", // Wave 7 (W7) Task 10: PDF to Word ships directly on ToolShell. "pdf-to-word", // Wave 7 (W7) Task 11: Word to PDF ships directly on ToolShell. diff --git a/src/components/subtitle-cinema-player.module.css b/src/components/subtitle-cinema-player.module.css new file mode 100644 index 00000000..c982b431 --- /dev/null +++ b/src/components/subtitle-cinema-player.module.css @@ -0,0 +1 @@ +.player{display:grid;gap:1rem}.imports,.toolbar,.transcriptHeader{display:flex;align-items:center;gap:.75rem;flex-wrap:wrap}.fileButton{display:inline-flex;align-items:center;gap:.4rem;border:1px solid var(--bt-border,#d9d9d9);border-radius:999px;padding:.55rem .8rem;cursor:pointer;font-size:.85rem;font-weight:600}.fileButton input{display:none}.status,.muted{color:var(--bt-muted,#737373);font-size:.85rem}.stage{position:relative;overflow:hidden;background:#111;border-radius:1rem;aspect-ratio:16/9;display:grid;place-items:center}.stage:fullscreen{border-radius:0;width:100vw;height:100vh}.video{width:100%;height:100%;object-fit:contain}.empty{color:#aaa}.subtitle{position:absolute;bottom:4.5rem;left:5%;right:5%;text-align:center;color:#fff;text-shadow:0 2px 4px #000;font-weight:700;line-height:1.25;pointer-events:none}.controls{position:absolute;bottom:0;left:0;right:0;display:flex;align-items:center;gap:.5rem;padding:.5rem;background:linear-gradient(transparent,rgba(0,0,0,.8));color:#fff}.controls input[type=range]{flex:1}.time{font:12px ui-monospace,monospace;white-space:nowrap}.toolbar{padding:.75rem;border:1px solid var(--bt-border,#e5e5e5);border-radius:.75rem}.toolbar label{display:flex;align-items:center;gap:.4rem;font-size:.85rem}.toolbar input[type=number],.toolbar select,.search input{border:1px solid var(--bt-border,#d9d9d9);border-radius:.4rem;padding:.35rem .5rem;background:transparent;max-width:6rem}.transcript{border:1px solid var(--bt-border,#e5e5e5);border-radius:.75rem;padding:1rem}.transcriptHeader{justify-content:space-between}.transcriptHeader h2{font-size:1rem;margin:0}.search{display:flex;align-items:center;gap:.4rem}.search input{max-width:none}.cue,.activeCue{display:flex;width:100%;gap:1rem;text-align:start;padding:.7rem .4rem;border:0;border-bottom:1px solid var(--bt-border,#eee);background:transparent;cursor:pointer;color:inherit}.cue:hover,.activeCue{background:color-mix(in srgb,var(--bt-accent,#7c3aed) 10%,transparent)}.cue time,.activeCue time{font:12px ui-monospace,monospace;color:var(--bt-muted,#737373);min-width:3rem}.activeCue span{font-weight:700}@media(max-width:600px){.toolbar{align-items:flex-start;flex-direction:column}.status{width:100%}.time{font-size:11px}.subtitle{bottom:3.5rem}} \ No newline at end of file diff --git a/src/lib/subtitles/srt.ts b/src/lib/subtitles/srt.ts new file mode 100644 index 00000000..41288573 --- /dev/null +++ b/src/lib/subtitles/srt.ts @@ -0,0 +1,32 @@ +export interface SubtitleCue { + id: string; + start: number; + end: number; + text: string; +} + +export function parseSrtTimestamp(value: string): number { + const match = value.trim().match(/^(\d{2}):(\d{2}):(\d{2})[,.](\d{3})$/); + if (!match) return Number.NaN; + const [, h, m, s, ms] = match; + return Number(h) * 3600 + Number(m) * 60 + Number(s) + Number(ms) / 1000; +} + +export function parseSrt(input: string): SubtitleCue[] { + return input.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n").split(/\n{2,}/).flatMap((block, index) => { + const lines = block.split("\n").map((line) => line.trimEnd()); + const timingIndex = lines.findIndex((line) => line.includes("-->")); + if (timingIndex < 0) return []; + const [startRaw, endRaw] = lines[timingIndex].split("-->").map((v) => v.trim().split(/\s+/)[0]); + const start = parseSrtTimestamp(startRaw); + const end = parseSrtTimestamp(endRaw); + const text = lines.slice(timingIndex + 1).join("\n").trim(); + if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start || !text) return []; + return [{ id: lines.slice(0, timingIndex).join("-") || String(index + 1), start, end, text }]; + }); +} + +export function activeCue(cues: SubtitleCue[], time: number, offset = 0): SubtitleCue | undefined { + const adjusted = time + offset; + return cues.find((cue) => adjusted >= cue.start && adjusted < cue.end); +} diff --git a/src/lib/tools-config.ts b/src/lib/tools-config.ts index b57f50b3..ec0118f9 100644 --- a/src/lib/tools-config.ts +++ b/src/lib/tools-config.ts @@ -766,6 +766,16 @@ export const tools: ToolCategory[] = [ description: "Transcribe a video into word-timed subtitles with an on-device Whisper model, style the captions, and burn them into your video. No uploads — runs entirely on-device.", }, + { + name: "Subtitle Cinema Player", + href: "/tools/subtitle-cinema-player", + icon: CaptionsIcon, + available: true, + order: 7.5, + creationDate: "2026-09-19", + description: + "Watch local videos with perfectly timed SRT subtitles, a searchable transcript, cinema mode, and precise playback controls. Nothing is uploaded.", + }, { name: "Video to Audio", href: "/tools/video-to-audio", From 9ebec5d8911823932f08221bdb8bb21d9641578d Mon Sep 17 00:00:00 2001 From: Aghyad Date: Sat, 19 Sep 2026 21:35:10 +0400 Subject: [PATCH 2/4] refactor: align subtitle player with shared tool primitives --- src/components/SubtitleCinemaPlayer.tsx | 241 +++++++++++++++--- .../subtitle-cinema-player.module.css | 1 - 2 files changed, 201 insertions(+), 41 deletions(-) delete mode 100644 src/components/subtitle-cinema-player.module.css diff --git a/src/components/SubtitleCinemaPlayer.tsx b/src/components/SubtitleCinemaPlayer.tsx index a64ff3e5..66baeecd 100644 --- a/src/components/SubtitleCinemaPlayer.tsx +++ b/src/components/SubtitleCinemaPlayer.tsx @@ -2,81 +2,242 @@ import { useEffect, useMemo, useRef, useState } from "react"; import { ToolShell } from "@/components/template/tool-shell"; +import { FileDropzone } from "@/components/shared/FileDropzone"; +import { OptionRow, SettingsCard } from "@/components/shared/SettingsCard"; +import { StatStrip } from "@/components/shared/StatStrip"; +import { TwoPane } from "@/components/shared/TwoPane"; import { Button } from "@/components/ui/button"; +import { Input } from "@/components/ui/input"; +import { + Select, + SelectContent, + SelectItem, + SelectTrigger, + SelectValue, +} from "@/components/ui/select"; +import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"; import { parseSrt, activeCue, type SubtitleCue } from "@/lib/subtitles/srt"; -import { Maximize, Minimize, Play, Pause, Upload, Search, Settings2 } from "lucide-react"; -import styles from "./subtitle-cinema-player.module.css"; +import { Maximize, Minimize, Pause, Play, Search, Upload } from "lucide-react"; -const formatTime = (time: number) => `${Math.floor(time / 60)}:${String(Math.floor(time % 60)).padStart(2, "0")}`; +const formatTime = (time: number) => + `${Math.floor(time / 60)}:${String(Math.floor(time % 60)).padStart(2, "0")}`; + +const ACCEPT_VIDEO = { "video/*": [] }; +const ACCEPT_SRT = { "text/plain": [".srt"], "application/x-subrip": [".srt"] }; export default function SubtitleCinemaPlayer() { const videoRef = useRef(null); const stageRef = useRef(null); const [videoUrl, setVideoUrl] = useState(""); + const [videoName, setVideoName] = useState(""); const [cues, setCues] = useState([]); const [currentTime, setCurrentTime] = useState(0); + const [duration, setDuration] = useState(0); const [playing, setPlaying] = useState(false); const [offset, setOffset] = useState(0); - const [speed, setSpeed] = useState(1); + const [speed, setSpeed] = useState("1"); const [query, setQuery] = useState(""); const [fontSize, setFontSize] = useState(1); const [cinema, setCinema] = useState(false); const [status, setStatus] = useState("Choose a video and an SRT file to begin."); - useEffect(() => () => { if (videoUrl) URL.revokeObjectURL(videoUrl); }, [videoUrl]); + useEffect(() => () => { + if (videoUrl) URL.revokeObjectURL(videoUrl); + }, [videoUrl]); + const current = activeCue(cues, currentTime, offset); - const filtered = useMemo(() => cues.filter((cue) => cue.text.toLowerCase().includes(query.toLowerCase())), [cues, query]); + const filtered = useMemo( + () => cues.filter((cue) => cue.text.toLowerCase().includes(query.toLowerCase())), + [cues, query], + ); - const loadVideo = (file?: File) => { + const loadVideo = (files: File[]) => { + const file = files[0]; if (!file) return; - setVideoUrl((old) => { if (old) URL.revokeObjectURL(old); return URL.createObjectURL(file); }); + setVideoUrl((old) => { + if (old) URL.revokeObjectURL(old); + return URL.createObjectURL(file); + }); + setVideoName(file.name); + setCurrentTime(0); + setDuration(0); setStatus(`${file.name} loaded locally.`); }; - const loadSrt = async (file?: File) => { + + const loadSrt = async (files: File[]) => { + const file = files[0]; if (!file) return; const parsed = parseSrt(await file.text()); setCues(parsed); setStatus(`${parsed.length} subtitle cues loaded locally.`); }; + const togglePlay = () => { const video = videoRef.current; if (!video) return; - if (video.paused) void video.play(); else video.pause(); + if (video.paused) void video.play(); + else video.pause(); + }; + + const seek = (time: number) => { + const next = Math.max(0, time); + if (videoRef.current) videoRef.current.currentTime = next; + setCurrentTime(next); }; - const seek = (time: number) => { if (videoRef.current) videoRef.current.currentTime = Math.max(0, time); setCurrentTime(Math.max(0, time)); }; + const toggleFullscreen = async () => { if (!stageRef.current) return; - if (document.fullscreenElement) await document.exitFullscreen(); else await stageRef.current.requestFullscreen?.(); + if (document.fullscreenElement) await document.exitFullscreen(); + else await stageRef.current.requestFullscreen?.(); }; - return -
-
- - - {status} -
-
- {videoUrl ?