karaoke-gen 0.75.16__py3-none-any.whl → 0.76.20__py3-none-any.whl

lyrics_transcriber/frontend/package.json

@@ -2,7 +2,7 @@
   "name": "lyrics-transcriber-frontend",
   "private": true,
   "homepage": "https://nomadkaraoke.github.io/lyrics-transcriber-frontend",
-  "version": "0.82.0",
+  "version": "0.83.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -19,6 +19,7 @@
     "@mui/icons-material": "^6.3.0",
     "@mui/material": "^6.3.0",
     "@mui/system": "^6.4.3",
+    "lucide-react": "^0.562.0",
     "nanoid": "^5.0.9",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
@@ -26,6 +27,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.17.0",
+    "@playwright/test": "^1.57.0",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
     "@vitejs/plugin-react": "^4.3.4",
@@ -34,6 +36,7 @@
     "eslint-plugin-react-refresh": "^0.4.16",
     "gh-pages": "^6.3.0",
     "globals": "^15.14.0",
+    "playwright": "^1.57.0",
     "typescript": "~5.6.2",
     "typescript-eslint": "^8.18.2",
     "vite": "^6.0.5"

lyrics_transcriber/frontend/playwright.config.ts

@@ -0,0 +1,69 @@
+import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Playwright configuration for lyrics-transcriber frontend E2E tests.
+ * Tests run against the local dev server (localhost:5173) served by vite.
+ */
+export default defineConfig({
+  testDir: './e2e',
+
+  // Run tests sequentially for now
+  fullyParallel: false,
+
+  // Fail the build on CI if you accidentally left test.only in the source code
+  forbidOnly: !!process.env.CI,
+
+  // Retry on CI only
+  retries: process.env.CI ? 2 : 0,
+
+  // Single worker
+  workers: 1,
+
+  // Reporter to use
+  reporter: [
+    ['html', { open: 'never' }],
+    ['list'],
+  ],
+
+  // Shared settings for all tests
+  use: {
+    // Base URL for the local dev server
+    baseURL: 'http://localhost:5173',
+
+    // Collect trace on failure for debugging
+    trace: 'on-first-retry',
+
+    // Screenshot on failure
+    screenshot: 'only-on-failure',
+
+    // Video on failure
+    video: 'on-first-retry',
+
+    // Increase timeout for complex interactions
+    actionTimeout: 30000,
+  },
+
+  // Longer timeout for tests
+  timeout: 120000, // 2 minutes per test
+
+  // Expect timeout for assertions
+  expect: {
+    timeout: 30000, // 30 seconds for expects
+  },
+
+  // Configure projects (browsers)
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+
+  // Run local dev server before starting tests
+  webServer: {
+    command: 'yarn dev',
+    url: 'http://localhost:5173',
+    reuseExistingServer: !process.env.CI,
+    timeout: 120000,
+  },
+});

lyrics_transcriber/frontend/public/nomad-karaoke-logo.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="45 60 255 135">
+<g data-v-70b83f88="" fill="#ff7acc" class="basesvg" transform="translate(48.368003845214844,62.62239074707031)"><g fill-rule="" class="tp-name" transform="translate(0,0)"><g transform="scale(1.4000000000000004)"><g stroke="#ff7acc" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" paint-order="stroke" data-gra-attr="stroke" fill-opacity="0"><path d="M1.4-33.44L1.4 0C31.48 0 3.96 0 34.04 0L34.04-32.64 17.81-32.64 17.81-20.61 1.4-33.44ZM52.21-33.76C42.6-33.76 34.81-25.97 34.81-16.37 34.81-6.76 42.6 1.03 52.21 1.03 61.81 1.03 69.6-6.76 69.6-16.37 69.6-25.97 61.81-33.76 52.21-33.76ZM70.7 0L103.34 0 103.25-33.9 86.93-21.54 70.61-33.9 70.7 0ZM102.34 0C138.2 0 107.52 0 143.56 0L122.95-34.93 102.34 0ZM158.84 0.05C167.84 0.05 175.16-7.27 175.16-16.27 175.16-25.27 167.84-32.64 158.84-32.64L142.52-32.64C142.52 0.75 142.52-33.34 142.52 0.05L158.84 0.05Z" transform="translate(-1.399999976158142, 34.93000030517578)"></path></g><g transform="translate(0,38.959999084472656)"><g stroke="#ff7acc" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" paint-order="stroke" data-gra-attr="stroke" fill="#ff7acc" fill-opacity="0" transform="scale(1.02719)"><path d="M24.43 0L17.67 0 7.98-11.87 7.98 0 2.63 0 2.63-26.64 7.98-26.64 7.98-14.69 17.67-26.64 24.12-26.64 13.13-13.44 24.43 0ZM45.03 0L43.27-5.08 32.66-5.08 30.91 0 25.3 0 34.88-26.68 41.1-26.68 50.68 0 45.03 0ZM34.11-9.35L41.82-9.35 37.97-20.5 34.11-9.35ZM73.19 0L67.01 0 61.13-10.38 58.61-10.38 58.61 0 53.27 0 53.27-26.64 63.27-26.64Q66.36-26.64 68.53-25.55 70.71-24.47 71.8-22.61 72.89-20.76 72.89-18.47L72.89-18.47Q72.89-15.84 71.36-13.72 69.83-11.6 66.82-10.8L66.82-10.8 73.19 0ZM58.61-22.21L58.61-14.39 63.08-14.39Q65.25-14.39 66.32-15.44 67.39-16.49 67.39-18.36L67.39-18.36Q67.39-20.19 66.32-21.2 65.25-22.21 63.08-22.21L63.08-22.21 58.61-22.21ZM94.82 0L93.07-5.08 82.46-5.08 80.7 0 75.09 0 84.67-26.68 90.89-26.68 100.47 0 94.82 0ZM83.91-9.35L91.62-9.35 87.76-20.5 83.91-9.35ZM115.43 0.27Q111.69 0.27 108.56-1.49 105.43-3.24 103.6-6.35 101.76-9.47 101.76-13.4L101.76-13.4Q101.76-17.29 103.6-20.4 105.43-23.51 108.56-25.27 111.69-27.02 115.43-27.02L115.43-27.02Q119.21-27.02 122.32-25.27 125.43-23.51 127.24-20.4 129.05-17.29 129.05-13.4L129.05-13.4Q129.05-9.47 127.24-6.35 125.43-3.24 122.3-1.49 119.17 0.27 115.43 0.27L115.43 0.27ZM115.43-4.5Q117.83-4.5 119.66-5.59 121.5-6.68 122.53-8.7 123.56-10.73 123.56-13.4L123.56-13.4Q123.56-16.07 122.53-18.07 121.5-20.08 119.66-21.15 117.83-22.21 115.43-22.21L115.43-22.21Q113.02-22.21 111.17-21.15 109.32-20.08 108.29-18.07 107.26-16.07 107.26-13.4L107.26-13.4Q107.26-10.73 108.29-8.7 109.32-6.68 111.17-5.59 113.02-4.5 115.43-4.5L115.43-4.5ZM153.82 0L147.06 0 137.37-11.87 137.37 0 132.02 0 132.02-26.64 137.37-26.64 137.37-14.69 147.06-26.64 153.51-26.64 142.52-13.44 153.82 0ZM171.79-22.33L161.67-22.33 161.67-15.65 170.64-15.65 170.64-11.41 161.67-11.41 161.67-4.35 171.79-4.35 171.79 0 156.33 0 156.33-26.68 171.79-26.68 171.79-22.33Z" transform="translate(-2.630000114440918, 27.020000457763672)"></path></g></g></g></g> <g data-gra="path-slogan" fill-rule="" class="tp-slogan" fill="#ffdf6b" transform="translate(5,111.788818359375)"><rect x="0" height="1" y="5.9832000732421875" width="14.278396606445312"></rect> <rect height="1" y="5.9832000732421875" width="14.278396606445312" x="218.985595703125"></rect> <g transform="translate(17.278396606445312,0)"><g transform="scale(1.2800000000000002)"><path d="M10.21-8.38L12.02-8.38L9.68 0L7.70 0L6.13-5.96L4.49 0L2.52 0.01L0.26-8.38L2.06-8.38L3.54-1.87L5.24-8.38L7.12-8.38L8.72-1.91L10.21-8.38ZM18.38-8.38L20.06-8.38L20.06 0L18.38 0L18.38-3.56L14.80-3.56L14.80 0L13.12 0L13.12-8.38L14.80-8.38L14.80-4.93L18.38-4.93L18.38-8.38ZM26.58-7.02L23.40-7.02L23.40-4.92L26.22-4.92L26.22-3.59L23.40-3.59L23.40-1.37L26.58-1.37L26.58 0L21.72 0L21.72-8.39L26.58-8.39L26.58-7.02ZM34.37 0L32.42 0L30.58-3.26L29.78-3.26L29.78 0L28.10 0L28.10-8.38L31.25-8.38Q32.22-8.38 32.90-8.03Q33.59-7.69 33.93-7.11Q34.27-6.53 34.27-5.81L34.27-5.81Q34.27-4.98 33.79-4.31Q33.31-3.65 32.36-3.40L32.36-3.40L34.37 0ZM29.78-6.98L29.78-4.52L31.19-4.52Q31.87-4.52 32.21-4.85Q32.54-5.18 32.54-5.77L32.54-5.77Q32.54-6.35 32.21-6.67Q31.87-6.98 31.19-6.98L31.19-6.98L29.78-6.98ZM40.66-7.02L37.48-7.02L37.48-4.92L40.30-4.92L40.30-3.59L37.48-3.59L37.48-1.37L40.66-1.37L40.66 0L35.80 0L35.80-8.39L40.66-8.39L40.66-7.02ZM47.92-8.38L49.70-8.38L46.63 0L44.59 0L41.52-8.38L43.32-8.38L45.62-1.72L47.92-8.38ZM55.57-7.02L52.39-7.02L52.39-4.92L55.21-4.92L55.21-3.59L52.39-3.59L52.39-1.37L55.57-1.37L55.57 0L50.71 0L50.71-8.39L55.57-8.39L55.57-7.02ZM63.36 0L61.42 0L59.57-3.26L58.78-3.26L58.78 0L57.10 0L57.10-8.38L60.24-8.38Q61.21-8.38 61.90-8.03Q62.58-7.69 62.92-7.11Q63.26-6.53 63.26-5.81L63.26-5.81Q63.26-4.98 62.78-4.31Q62.30-3.65 61.36-3.40L61.36-3.40L63.36 0ZM58.78-6.98L58.78-4.52L60.18-4.52Q60.86-4.52 61.20-4.85Q61.54-5.18 61.54-5.77L61.54-5.77Q61.54-6.35 61.20-6.67Q60.86-6.98 60.18-6.98L60.18-6.98L58.78-6.98ZM72.43-8.38L74.30-8.38L71.47-2.92L71.47 0L69.79 0L69.79-2.92L66.95-8.38L68.84-8.38L70.64-4.55L72.43-8.38ZM79.16 0.08Q77.99 0.08 77.00-0.47Q76.02-1.02 75.44-2.00Q74.87-2.98 74.87-4.21L74.87-4.21Q74.87-5.44 75.44-6.41Q76.02-7.39 77.00-7.94Q77.99-8.50 79.16-8.50L79.16-8.50Q80.35-8.50 81.33-7.94Q82.31-7.39 82.88-6.41Q83.45-5.44 83.45-4.21L83.45-4.21Q83.45-2.98 82.88-2.00Q82.31-1.02 81.32-0.47Q80.34 0.08 79.16 0.08L79.16 0.08ZM79.16-1.42Q79.92-1.42 80.50-1.76Q81.07-2.10 81.40-2.74Q81.72-3.37 81.72-4.21L81.72-4.21Q81.72-5.05 81.40-5.68Q81.07-6.31 80.50-6.65Q79.92-6.98 79.16-6.98L79.16-6.98Q78.41-6.98 77.83-6.65Q77.24-6.31 76.92-5.68Q76.60-5.05 76.60-4.21L76.60-4.21Q76.60-3.37 76.92-2.74Q77.24-2.10 77.83-1.76Q78.41-1.42 79.16-1.42L79.16-1.42ZM84.67-8.38L86.35-8.38L86.35-3.19Q86.35-2.34 86.80-1.89Q87.24-1.44 88.04-1.44L88.04-1.44Q88.86-1.44 89.30-1.89Q89.75-2.34 89.75-3.19L89.75-3.19L89.75-8.38L91.44-8.38L91.44-3.20Q91.44-2.14 90.98-1.40Q90.52-0.66 89.74-0.29Q88.97 0.08 88.02 0.08L88.02 0.08Q87.08 0.08 86.32-0.29Q85.56-0.66 85.12-1.40Q84.67-2.14 84.67-3.20L84.67-3.20L84.67-8.38ZM101.60 0L101.05-1.60L97.72-1.60L97.16 0L95.40 0L98.41-8.39L100.37-8.39L103.38 0L101.60 0ZM98.17-2.94L100.60-2.94L99.38-6.44L98.17-2.94ZM110.77 0L108.83 0L106.98-3.26L106.19-3.26L106.19 0L104.51 0L104.51-8.38L107.65-8.38Q108.62-8.38 109.31-8.03Q109.99-7.69 110.33-7.11Q110.68-6.53 110.68-5.81L110.68-5.81Q110.68-4.98 110.20-4.31Q109.72-3.65 108.77-3.40L108.77-3.40L110.77 0ZM106.19-6.98L106.19-4.52L107.59-4.52Q108.28-4.52 108.61-4.85Q108.95-5.18 108.95-5.77L108.95-5.77Q108.95-6.35 108.61-6.67Q108.28-6.98 107.59-6.98L107.59-6.98L106.19-6.98ZM117.06-7.02L113.88-7.02L113.88-4.92L116.70-4.92L116.70-3.59L113.88-3.59L113.88-1.37L117.06-1.37L117.06 0L112.20 0L112.20-8.39L117.06-8.39L117.06-7.02ZM118.72-1.76L120.42-1.76L119.02 1.61L117.94 1.61L118.72-1.76ZM127.38 0.08Q126.50 0.08 125.80-0.22Q125.10-0.52 124.69-1.08Q124.28-1.64 124.27-2.41L124.27-2.41L126.07-2.41Q126.11-1.90 126.44-1.60Q126.77-1.30 127.34-1.30L127.34-1.30Q127.93-1.30 128.27-1.58Q128.60-1.86 128.60-2.32L128.60-2.32Q128.60-2.69 128.38-2.93Q128.15-3.17 127.81-3.31Q127.46-3.44 126.86-3.61L126.86-3.61Q126.05-3.85 125.54-4.09Q125.03-4.32 124.66-4.79Q124.30-5.27 124.30-6.06L124.30-6.06Q124.30-6.80 124.67-7.36Q125.04-7.91 125.71-8.20Q126.38-8.50 127.25-8.50L127.25-8.50Q128.54-8.50 129.35-7.87Q130.16-7.24 130.25-6.11L130.25-6.11L128.40-6.11Q128.38-6.54 128.03-6.82Q127.69-7.10 127.13-7.10L127.13-7.10Q126.64-7.10 126.34-6.85Q126.05-6.60 126.05-6.12L126.05-6.12Q126.05-5.78 126.27-5.56Q126.49-5.34 126.82-5.20Q127.15-5.06 127.75-4.88L127.75-4.88Q128.57-4.64 129.08-4.40Q129.60-4.16 129.97-3.68Q130.34-3.20 130.34-2.42L130.34-2.42Q130.34-1.75 130.00-1.18Q129.65-0.60 128.98-0.26Q128.30 0.08 127.38 0.08L127.38 0.08ZM131.80-8.38L133.48-8.38L133.48 0L131.80 0L131.80-8.38ZM142.30-8.39L142.30 0L140.62 0L136.81-5.75L136.81 0L135.13 0L135.13-8.39L136.81-8.39L140.62-2.63L140.62-8.39L142.30-8.39ZM151.72-5.86L149.78-5.86Q149.50-6.38 148.99-6.66Q148.49-6.94 147.82-6.94L147.82-6.94Q147.07-6.94 146.50-6.60Q145.92-6.26 145.60-5.64Q145.27-5.02 145.27-4.20L145.27-4.20Q145.27-3.36 145.60-2.74Q145.93-2.11 146.52-1.78Q147.11-1.44 147.89-1.44L147.89-1.44Q148.85-1.44 149.46-1.95Q150.07-2.46 150.26-3.37L150.26-3.37L147.38-3.37L147.38-4.66L151.92-4.66L151.92-3.19Q151.75-2.32 151.20-1.57Q150.65-0.83 149.78-0.38Q148.91 0.07 147.83 0.07L147.83 0.07Q146.62 0.07 145.64-0.47Q144.66-1.02 144.10-1.99Q143.54-2.96 143.54-4.20L143.54-4.20Q143.54-5.44 144.10-6.41Q144.66-7.39 145.64-7.94Q146.62-8.48 147.82-8.48L147.82-8.48Q149.23-8.48 150.28-7.79Q151.32-7.10 151.72-5.86L151.72-5.86ZM153.53-8.52L155.34-8.52L155.15-2.72L153.73-2.72L153.53-8.52ZM154.48 0.08Q154.02 0.08 153.73-0.20Q153.43-0.48 153.43-0.90L153.43-0.90Q153.43-1.32 153.73-1.60Q154.02-1.88 154.48-1.88L154.48-1.88Q154.92-1.88 155.21-1.60Q155.50-1.32 155.50-0.90L155.50-0.90Q155.50-0.48 155.21-0.20Q154.92 0.08 154.48 0.08L154.48 0.08Z" transform="translate(-0.264, 8.52)"></path></g></g></g></g>
+</svg>

lyrics_transcriber/frontend/src/App.tsx

@@ -1,12 +1,23 @@
 import UploadFileIcon from '@mui/icons-material/UploadFile'
 import { Alert, Box, Button, Modal, Typography } from '@mui/material'
-import { useEffect, useState } from 'react'
+import { ThemeProvider } from '@mui/material/styles'
+import CssBaseline from '@mui/material/CssBaseline'
+import { useEffect, useState, useMemo } from 'react'
 import { ApiClient, FileOnlyClient, LiveApiClient } from './api'
 import CorrectionMetrics from './components/CorrectionMetrics'
 import LyricsAnalyzer from './components/LyricsAnalyzer'
+import AppHeader from './components/AppHeader'
 import { CorrectionData } from './types'
+import { createAppTheme } from './theme'
+
+const THEME_STORAGE_KEY = 'nomad-karaoke-lyrics-theme'
 
 export default function App() {
+  const [isDarkMode, setIsDarkMode] = useState(() => {
+    // Initialize from localStorage
+    const stored = localStorage.getItem(THEME_STORAGE_KEY)
+    return stored !== 'light' // Default to dark
+  })
   const [data, setData] = useState<CorrectionData | null>(null)
   const [showMetadata, setShowMetadata] = useState(false)
   const [error, setError] = useState<string | null>(null)
@@ -14,30 +25,42 @@ export default function App() {
   const [isReadOnly, setIsReadOnly] = useState(true)
   const [audioHash, setAudioHash] = useState<string>('')
 
+  // Create theme based on mode
+  const theme = useMemo(() => createAppTheme(isDarkMode ? 'dark' : 'light'), [isDarkMode])
+
+  // Handle theme toggle
+  const handleToggleTheme = () => {
+    const newIsDark = !isDarkMode
+    setIsDarkMode(newIsDark)
+    localStorage.setItem(THEME_STORAGE_KEY, newIsDark ? 'dark' : 'light')
+  }
+
   useEffect(() => {
     // Parse query parameters
     const params = new URLSearchParams(window.location.search)
     const encodedApiUrl = params.get('baseApiUrl')
     const audioHashParam = params.get('audioHash')
+    const reviewTokenParam = params.get('reviewToken')
 
     if (encodedApiUrl) {
       const baseApiUrl = decodeURIComponent(encodedApiUrl)
-      setApiClient(new LiveApiClient(baseApiUrl))
+      // Pass reviewToken to LiveApiClient for authentication
+      setApiClient(new LiveApiClient(baseApiUrl, reviewTokenParam || undefined))
       setIsReadOnly(false)
       if (audioHashParam) {
         setAudioHash(audioHashParam)
       }
       // Fetch initial data
-      fetchData(baseApiUrl)
+      fetchData(baseApiUrl, reviewTokenParam || undefined)
     } else {
       setApiClient(new FileOnlyClient())
       setIsReadOnly(true)
     }
   }, [])
 
-  const fetchData = async (baseUrl: string) => {
+  const fetchData = async (baseUrl: string, reviewToken?: string) => {
     try {
-      const client = new LiveApiClient(baseUrl)
+      const client = new LiveApiClient(baseUrl, reviewToken)
       const data = await client.getCorrectionData()
       // console.log('Full correction data from API:', data)
       setData(data)
@@ -143,70 +166,78 @@ export default function App() {
 
   if (!data) {
     return (
-      <Box sx={{ p: 3 }}>
-        {error && (
-          <Alert severity="error" sx={{ mb: 2 }} onClose={() => setError(null)}>
-            {error}
-          </Alert>
-        )}
-        {isReadOnly ? (
-          <>
-            <Alert severity="info" sx={{ mb: 2 }}>
-              Running in read-only mode. Connect to an API to enable editing.
+      <ThemeProvider theme={theme}>
+        <CssBaseline />
+        <AppHeader isDarkMode={isDarkMode} onToggleTheme={handleToggleTheme} />
+        <Box sx={{ p: 3 }}>
+          {error && (
+            <Alert severity="error" sx={{ mb: 2 }} onClose={() => setError(null)}>
+              {error}
             </Alert>
-            <Box sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', mb: 3 }}>
-              <Typography variant="h4">
-                Lyrics Correction Review
+          )}
+          {isReadOnly ? (
+            <>
+              <Alert severity="info" sx={{ mb: 2 }}>
+                Running in read-only mode. Connect to an API to enable editing.
+              </Alert>
+              <Box sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', mb: 3 }}>
+                <Typography variant="h4">
+                  Lyrics Correction Review
+                </Typography>
+                <Button
+                  variant="outlined"
+                  startIcon={<UploadFileIcon />}
+                  onClick={handleFileLoad}
+                >
+                  Load File
+                </Button>
+              </Box>
+              <Box sx={{ mb: 3 }}>
+                <CorrectionMetrics />
+              </Box>
+            </>
+          ) : (
+            <Box sx={{ display: 'flex', justifyContent: 'center', alignItems: 'center', height: '50vh' }}>
+              <Typography variant="h6" color="text.secondary">
+                Loading Lyrics Transcription Review...
               </Typography>
-              <Button
-                variant="outlined"
-                startIcon={<UploadFileIcon />}
-                onClick={handleFileLoad}
-              >
-                Load File
-              </Button>
-            </Box>
-            <Box sx={{ mb: 3 }}>
-              <CorrectionMetrics />
             </Box>
-          </>
-        ) : (
-          <Box sx={{ display: 'flex', justifyContent: 'center', alignItems: 'center', height: '50vh' }}>
-            <Typography variant="h6" color="text.secondary">
-              Loading Lyrics Correction Review...
-            </Typography>
-          </Box>
-        )}
-      </Box>
+          )}
+        </Box>
+      </ThemeProvider>
     )
   }
 
   return (
-    <Box sx={{
-      p: 1.5,
-      pb: 3,
-      maxWidth: '100%',
-      overflowX: 'hidden'
-    }}>
-      {error && (
-        <Alert severity="error" sx={{ mb: 1 }} onClose={() => setError(null)}>
-          {error}
-        </Alert>
-      )}
-      {isReadOnly && (
-        <Alert severity="info" sx={{ mb: 1 }}>
-          Running in read-only mode. Connect to an API to enable editing.
-        </Alert>
-      )}
-      <LyricsAnalyzer
-        data={data}
-        onFileLoad={handleFileLoad}
-        onShowMetadata={() => setShowMetadata(true)}
-        apiClient={apiClient}
-        isReadOnly={isReadOnly}
-        audioHash={audioHash}
-      />
-      {renderMetadataModal()}
-    </Box>
+    <ThemeProvider theme={theme}>
+      <CssBaseline />
+      <AppHeader isDarkMode={isDarkMode} onToggleTheme={handleToggleTheme} />
+      <Box sx={{
+        p: 1.5,
+        pb: 3,
+        maxWidth: '100%',
+        overflowX: 'hidden'
+      }}>
+        {error && (
+          <Alert severity="error" sx={{ mb: 1 }} onClose={() => setError(null)}>
+            {error}
+          </Alert>
+        )}
+        {isReadOnly && (
+          <Alert severity="info" sx={{ mb: 1 }}>
+            Running in read-only mode. Connect to an API to enable editing.
+          </Alert>
+        )}
+        <LyricsAnalyzer
+          data={data}
+          onFileLoad={handleFileLoad}
+          onShowMetadata={() => setShowMetadata(true)}
+          apiClient={apiClient}
+          isReadOnly={isReadOnly}
+          audioHash={audioHash}
+        />
+        {renderMetadataModal()}
+      </Box>
+    </ThemeProvider>
   )
 }

lyrics_transcriber/frontend/src/api.ts

@@ -35,14 +35,29 @@ interface AddLyricsRequest {
 }
 
 export class LiveApiClient implements ApiClient {
-    constructor(private baseUrl: string) {
+    private reviewToken?: string;
+
+    constructor(private baseUrl: string, reviewToken?: string) {
         this.baseUrl = baseUrl.replace(/\/$/, '')
+        this.reviewToken = reviewToken
     }
 
     public isUpdatingHandlers = false;
 
+    /**
+     * Build URL with reviewToken query parameter if available
+     */
+    private buildUrl(path: string): string {
+        const url = `${this.baseUrl}${path}`
+        if (this.reviewToken) {
+            const separator = url.includes('?') ? '&' : '?'
+            return `${url}${separator}review_token=${encodeURIComponent(this.reviewToken)}`
+        }
+        return url
+    }
+
     async getCorrectionData(): Promise<CorrectionData> {
-        const response = await fetch(`${this.baseUrl}/correction-data`);
+        const response = await fetch(this.buildUrl('/correction-data'));
         if (!response.ok) {
             throw new Error(`API error: ${response.statusText}`);
         }
@@ -64,7 +79,7 @@ export class LiveApiClient implements ApiClient {
             corrected_segments: data.corrected_segments
         };
 
-        const response = await fetch(`${this.baseUrl}/complete`, {
+        const response = await fetch(this.buildUrl('/complete'), {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -78,7 +93,7 @@ export class LiveApiClient implements ApiClient {
     }
 
     getAudioUrl(audioHash: string): string {
-        return `${this.baseUrl}/audio/${audioHash}`
+        return this.buildUrl(`/audio/${audioHash}`)
     }
 
     async generatePreviewVideo(data: CorrectionData): Promise<PreviewVideoResponse> {
@@ -88,7 +103,7 @@ export class LiveApiClient implements ApiClient {
             corrected_segments: data.corrected_segments
         };
 
-        const response = await fetch(`${this.baseUrl}/preview-video`, {
+        const response = await fetch(this.buildUrl('/preview-video'), {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -107,7 +122,7 @@ export class LiveApiClient implements ApiClient {
     }
 
     getPreviewVideoUrl(previewHash: string): string {
-        return `${this.baseUrl}/preview-video/${previewHash}`;
+        return this.buildUrl(`/preview-video/${previewHash}`);
     }
 
     async updateHandlers(enabledHandlers: string[]): Promise<CorrectionData> {
@@ -116,7 +131,7 @@ export class LiveApiClient implements ApiClient {
         console.log('API: Set isUpdatingHandlers to', this.isUpdatingHandlers);
         
         try {
-            const response = await fetch(`${this.baseUrl}/handlers`, {
+            const response = await fetch(this.buildUrl('/handlers'), {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -147,7 +162,7 @@ export class LiveApiClient implements ApiClient {
             lyrics
         };
 
-        const response = await fetch(`${this.baseUrl}/add-lyrics`, {
+        const response = await fetch(this.buildUrl('/add-lyrics'), {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -170,7 +185,7 @@ export class LiveApiClient implements ApiClient {
     async submitAnnotations(annotations: Omit<CorrectionAnnotation, 'annotation_id' | 'timestamp'>[]): Promise<void> {
         // Submit each annotation to the backend
         for (const annotation of annotations) {
-            const response = await fetch(`${this.baseUrl}/v1/annotations`, {
+            const response = await fetch(this.buildUrl('/v1/annotations'), {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -186,7 +201,7 @@ export class LiveApiClient implements ApiClient {
     }
 
     async getAnnotationStats(): Promise<any> {
-        const response = await fetch(`${this.baseUrl}/v1/annotations/stats`);
+        const response = await fetch(this.buildUrl('/v1/annotations/stats'));
         if (!response.ok) {
             throw new Error(`API error: ${response.statusText}`);
         }

lyrics_transcriber/frontend/src/components/AIFeedbackModal.tsx

@@ -1,4 +1,4 @@
-import React from "react";
+import React, { useEffect, useRef } from "react";
 
 type Props = {
   isOpen: boolean;
@@ -12,22 +12,57 @@ export const AIFeedbackModal: React.FC<Props> = ({ isOpen, onClose, onSubmit, su
   const [finalText, setFinalText] = React.useState("");
   const [reasonCategory, setReason] = React.useState("AI_CORRECT");
   const [reasonDetail, setDetail] = React.useState("");
+  const modalRef = useRef<HTMLDivElement>(null);
+
+  // Handle Escape key to close modal
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape' && isOpen) {
+        onClose();
+      }
+    };
+    document.addEventListener('keydown', handleKeyDown);
+    return () => document.removeEventListener('keydown', handleKeyDown);
+  }, [isOpen, onClose]);
+
+  // Focus modal on open
+  useEffect(() => {
+    if (isOpen && modalRef.current) {
+      modalRef.current.focus();
+    }
+  }, [isOpen]);
 
   if (!isOpen) return null;
 
+  // Dark theme colors matching karaoke-gen
+  const colors = {
+    background: '#1a1a1a',    // slate-800
+    text: '#f8fafc',          // slate-50
+    textSecondary: '#888888', // slate-400
+    border: '#2a2a2a',        // slate-700
+    inputBg: '#0f0f0f',       // slate-900
+  };
+
   return (
-    <div style={{ position: "fixed", inset: 0, background: "rgba(0,0,0,0.5)", display: "flex", alignItems: "center", justifyContent: "center" }}>
-      <div style={{ background: "#fff", padding: 16, width: 480, borderRadius: 8 }}>
-        <h3>AI Suggestion</h3>
-        <p style={{ marginTop: 8 }}>
+    <div style={{ position: "fixed", inset: 0, background: "rgba(0,0,0,0.7)", display: "flex", alignItems: "center", justifyContent: "center", zIndex: 1300 }}>
+      <div
+        ref={modalRef}
+        role="dialog"
+        aria-modal="true"
+        aria-labelledby="ai-feedback-title"
+        tabIndex={-1}
+        style={{ background: colors.background, padding: 16, width: 480, borderRadius: 8, border: `1px solid ${colors.border}`, color: colors.text, outline: 'none' }}
+      >
+        <h3 id="ai-feedback-title" style={{ color: colors.text, margin: 0 }}>AI Suggestion</h3>
+        <p style={{ marginTop: 8, color: colors.text }}>
           {suggestion?.text ?? "No suggestion"}
           {suggestion?.confidence != null ? ` (confidence ${Math.round((suggestion.confidence || 0) * 100)}%)` : null}
         </p>
-        {suggestion?.reasoning ? <small>{suggestion.reasoning}</small> : null}
+        {suggestion?.reasoning ? <small style={{ color: colors.textSecondary }}>{suggestion.reasoning}</small> : null}
 
-        <div style={{ marginTop: 12 }}>
-          <label>Action</label>
-          <select value={reviewerAction} onChange={(e) => setAction(e.target.value)} style={{ marginLeft: 8 }}>
+        <div style={{ marginTop: 12, display: 'flex', alignItems: 'center', gap: 8 }}>
+          <label htmlFor="ai-action-select" style={{ color: colors.text }}>Action</label>
+          <select id="ai-action-select" value={reviewerAction} onChange={(e) => setAction(e.target.value)} style={{ background: colors.inputBg, color: colors.text, border: `1px solid ${colors.border}`, borderRadius: 4, padding: '4px 8px' }}>
             <option value="ACCEPT">Accept</option>
             <option value="REJECT">Reject</option>
             <option value="MODIFY">Modify</option>
@@ -35,15 +70,15 @@ export const AIFeedbackModal: React.FC<Props> = ({ isOpen, onClose, onSubmit, su
         </div>
 
         {reviewerAction === "MODIFY" ? (
-          <div style={{ marginTop: 12 }}>
-            <label>Final Text</label>
-            <input value={finalText} onChange={(e) => setFinalText(e.target.value)} style={{ marginLeft: 8, width: "100%" }} />
+          <div style={{ marginTop: 12, display: 'flex', flexDirection: 'column', gap: 4 }}>
+            <label htmlFor="ai-final-text" style={{ color: colors.text }}>Final Text</label>
+            <input id="ai-final-text" value={finalText} onChange={(e) => setFinalText(e.target.value)} style={{ width: "100%", background: colors.inputBg, color: colors.text, border: `1px solid ${colors.border}`, borderRadius: 4, padding: '4px 8px', boxSizing: 'border-box' }} />
           </div>
         ) : null}
 
-        <div style={{ marginTop: 12 }}>
-          <label>Reason</label>
-          <select value={reasonCategory} onChange={(e) => setReason(e.target.value)} style={{ marginLeft: 8 }}>
+        <div style={{ marginTop: 12, display: 'flex', alignItems: 'center', gap: 8 }}>
+          <label htmlFor="ai-reason-select" style={{ color: colors.text }}>Reason</label>
+          <select id="ai-reason-select" value={reasonCategory} onChange={(e) => setReason(e.target.value)} style={{ background: colors.inputBg, color: colors.text, border: `1px solid ${colors.border}`, borderRadius: 4, padding: '4px 8px' }}>
             <option value="AI_CORRECT">AI_CORRECT</option>
             <option value="AI_INCORRECT">AI_INCORRECT</option>
             <option value="AI_SUBOPTIMAL">AI_SUBOPTIMAL</option>
@@ -52,17 +87,18 @@ export const AIFeedbackModal: React.FC<Props> = ({ isOpen, onClose, onSubmit, su
           </select>
         </div>
 
-        <div style={{ marginTop: 12 }}>
-          <label>Details</label>
-          <textarea value={reasonDetail} onChange={(e) => setDetail(e.target.value)} style={{ marginLeft: 8, width: "100%" }} />
+        <div style={{ marginTop: 12, display: 'flex', flexDirection: 'column', gap: 4 }}>
+          <label htmlFor="ai-details-textarea" style={{ color: colors.text }}>Details</label>
+          <textarea id="ai-details-textarea" value={reasonDetail} onChange={(e) => setDetail(e.target.value)} style={{ width: "100%", background: colors.inputBg, color: colors.text, border: `1px solid ${colors.border}`, borderRadius: 4, padding: '4px 8px', boxSizing: 'border-box' }} />
         </div>
 
         <div style={{ display: "flex", gap: 8, justifyContent: "flex-end", marginTop: 16 }}>
-          <button onClick={onClose}>Cancel</button>
+          <button onClick={onClose} style={{ background: colors.border, color: colors.text, border: 'none', borderRadius: 4, padding: '6px 12px', cursor: 'pointer' }}>Cancel</button>
           <button
             onClick={() =>
               onSubmit({ reviewerAction, finalText: finalText || undefined, reasonCategory, reasonDetail: reasonDetail || undefined })
             }
+            style={{ background: '#f97316', color: '#fff', border: 'none', borderRadius: 4, padding: '6px 12px', cursor: 'pointer' }}
           >
             Submit
           </button>
@@ -73,5 +109,3 @@ export const AIFeedbackModal: React.FC<Props> = ({ isOpen, onClose, onSubmit, su
 };
 
 export default AIFeedbackModal;
-
-

lyrics_transcriber/frontend/src/components/AppHeader.tsx

@@ -0,0 +1,65 @@
+import { Box, IconButton, Tooltip, Typography, useTheme } from '@mui/material'
+import { Sun, Moon } from 'lucide-react'
+
+interface AppHeaderProps {
+    isDarkMode?: boolean
+    onToggleTheme?: () => void
+}
+
+export default function AppHeader({ isDarkMode = true, onToggleTheme }: AppHeaderProps) {
+    const theme = useTheme()
+
+    return (
+        <Box
+            component="header"
+            sx={{
+                borderBottom: `1px solid ${theme.palette.divider}`,
+                backgroundColor: theme.palette.background.paper,
+                backdropFilter: 'blur(8px)',
+                position: 'sticky',
+                top: 0,
+                zIndex: 1100,
+                px: 2,
+                py: 1.5,
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'space-between',
+            }}
+        >
+            <Box sx={{ display: 'flex', alignItems: 'center', gap: 1.5 }}>
+                <img src="/nomad-karaoke-logo.svg" alt="Nomad Karaoke" style={{ height: 40 }} />
+                <Typography
+                    variant="h6"
+                    sx={{
+                        fontWeight: 'bold',
+                        color: theme.palette.text.primary,
+                        fontSize: '1.1rem',
+                        lineHeight: 1,
+                        m: 0,
+                    }}
+                >
+                    Lyrics Transcription Review
+                </Typography>
+            </Box>
+
+            <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>
+                {onToggleTheme && (
+                    <Tooltip title={isDarkMode ? 'Switch to light mode' : 'Switch to dark mode'}>
+                        <IconButton
+                            onClick={onToggleTheme}
+                            sx={{
+                                color: theme.palette.text.secondary,
+                                '&:hover': {
+                                    color: theme.palette.text.primary,
+                                    backgroundColor: theme.palette.action.hover,
+                                },
+                            }}
+                        >
+                            {isDarkMode ? <Sun className="w-5 h-5" /> : <Moon className="w-5 h-5" />}
+                        </IconButton>
+                    </Tooltip>
+                )}
+            </Box>
+        </Box>
+    )
+}

lyrics_transcriber/frontend/src/components/CorrectedWordWithActions.tsx

@@ -42,7 +42,7 @@ const WordContainer = styled(Box, {
         '50%': { opacity: 0.5 }
     },
     '&:hover': {
-        backgroundColor: '#c8e6c9'
+        backgroundColor: 'rgba(34, 197, 94, 0.35)' // green tint hover for dark mode
     }
 }))
 
@@ -51,7 +51,7 @@ const OriginalWordLabel = styled(Box)({
     top: '-14px',
     left: '0',
     fontSize: '0.6rem',
-    color: '#666',
+    color: '#888888', // slate-400 for dark mode
     textDecoration: 'line-through',
     opacity: 0.7,
     whiteSpace: 'nowrap',
@@ -71,10 +71,10 @@ const ActionButton = styled(IconButton)(({ theme }) => ({
     minHeight: '20px',
     width: '20px',
     height: '20px',
-    backgroundColor: 'rgba(255, 255, 255, 0.9)',
-    border: '1px solid rgba(0, 0, 0, 0.1)',
+    backgroundColor: 'rgba(30, 41, 59, 0.9)', // slate-800 with opacity for dark mode
+    border: '1px solid rgba(248, 250, 252, 0.1)', // light border for dark mode
     '&:hover': {
-        backgroundColor: 'rgba(255, 255, 255, 1)',
+        backgroundColor: 'rgba(51, 65, 85, 1)', // slate-700 for dark mode
         transform: 'scale(1.1)'
     },
     '& .MuiSvgIcon-root': {