feat(audio): add offline local neural voice via Piper (sv + en)

Announcements can use Piper, a free local neural TTS, instead of the browser's system
voice. No account, no paid service, and it keeps working with no internet at the track.

- npm run tts:install (or Settings -> Audio -> Install) downloads the standalone Piper
  release for Linux/Windows/macOS plus Swedish and English voices into piper/ once
- server/tts.js generates each line once, one at a time, and caches it as WAV under
  data/tts/; a new line takes ~0.3 s with the standalone build
- src/piper_speech.js plays it and falls back to the browser voice if Piper is missing,
  errors, or takes over 2.5 s, so no announcement is lost and timing is never held up
- "Pre-generate phrases and driver names" renders every fixed phrase and name in both
  languages before race day

Browser voice stays the default. Generation routes fall under the admin PIN.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
larssandandClaude Opus 5.5 committed 2026-09-27 19:28:15 +02:00
1 parent 9016ce02e4
commit e8a2799a92
25 files changed
+776 -19

No files matched your search

+32 -2
View File
@@ -1064,6 +1064,19 @@ const TRANSLATIONS = {
"guide.tab_run": "Köra ett race",
"guide.tab_training": "Träning & resultat",
"guide.tab_videos": "Videoguider",
"tts.title": "Röstmotor",
"tts.hint": "Lokal röst (Piper) låter mer naturligt än webbläsarens röst och fungerar helt utan internet. Installera en gång (kräver internet just då), sedan körs allt lokalt. Om Piper saknas eller dröjer används webbläsarens röst automatiskt.",
"tts.engine": "Röstmotor",
"tts.engine_browser": "Webbläsarens röst",
"tts.engine_piper": "Lokal röst (Piper, offline)",
"tts.status_ready": "Piper är installerat.",
"tts.status_missing": "Piper eller röster saknas - klicka Installera.",
"tts.cached": "{count} repliker sparade",
"tts.install": "Installera Piper + svenska/engelska röster",
"tts.reinstall": "Kontrollera installation",
"tts.pregenerate": "Förgenerera fraser och förarnamn",
"tts.pregenerate_progress": "Förgenererat {done} av {total} ({failed} misslyckades)",
"tts.test": "Testa rösten",
"auth.title": "Admin-PIN",
"auth.hint": "Skyddar alla ändringar (race, resultat, inställningar, uppdatering) med en PIN. Läsning och publika overlay-/träningslänkar påverkas inte. Inloggningen sparas i webbläsaren i 30 dagar.",
"auth.state_off": "Av - vem som helst på nätverket kan ändra.",
@@ -1507,7 +1520,7 @@ const TRANSLATIONS = {
"audio.max_delay": "Största fördröjning (sek)",
"audio.per_competitor": "Olika passing-ton per förare/bil",
"audio.test": "Testa",
"audio.note": "Fasta effekter spelas från ljudpaketets WAV-filer. Röstutrop använder webbläsarens installerade systemröster. Val sparas automatiskt; kritiska utrop avbryter lägre prioriterat tal.",
"audio.note": "Fasta effekter spelas från ljudpaketets WAV-filer. Röstutrop använder vald röstmotor ovan - lokal Piper-röst eller webbläsarens systemröster. Val sparas automatiskt; kritiska utrop avbryter lägre prioriterat tal.",
"audio.effect": "Effekt",
"audio.voice": "Röst",
"audio.track_call": "STOPP PÅ BANAN",
@@ -1746,6 +1759,7 @@ const TRANSLATIONS = {
"guide.audio_7": "7. Personbästa, snabbaste varv, banrekord, ledarbyte, tidsvarningar, depå in/ut, finish och podium hämtas från befintliga timinghändelser.",
"guide.audio_8": "8. Ljudet spelas i operatörens webbläsare. Klicka Testa före racet, kontrollera ljudutgången och håll Tidtagning-fliken öppen.",
"guide.audio_9": "9. Staggered start i ett kvalheat läser upp varje bils transpondernummer i startordning, cirka 3 sekunder mellan varje bil, direkt efter den vanliga starten - mass/position-start läser aldrig upp enskilda bilar.",
"guide.audio_10": "10. Bättre röst utan internet: under Inställningar -> Ljud -> Röstmotor, klicka Installera en gång (hämtar Piper och svenska + engelska röster, kräver internet just då) och välj Lokal röst. Klicka sedan Förgenerera fraser och förarnamn före racedagen. Allt körs sedan lokalt; saknas Piper eller dröjer den används webbläsarens röst automatiskt.",
"guide.sponsor_title": "Skapa Sponsor Event: 10 personer, 4 bilar",
"guide.sponsor_1": "1. Lägg upp 4 bilar i sidan Bilar med unikt transponder-ID. Lägg gärna också in märke/modell i brandfältet.",
"guide.sponsor_2": "2. Lägg upp 10 förare i sidan Förare. Du kan också spara team/märke i brandfältet och filtrera listan på det senare.",
@@ -2645,6 +2659,19 @@ const TRANSLATIONS = {
"guide.tab_run": "Run a race",
"guide.tab_training": "Training & results",
"guide.tab_videos": "Video guides",
"tts.title": "Voice engine",
"tts.hint": "The local voice (Piper) sounds more natural than the browser voice and works with no internet at all. Install once (needs internet just then), after that everything runs locally. If Piper is missing or slow, the browser voice is used automatically.",
"tts.engine": "Voice engine",
"tts.engine_browser": "Browser voice",
"tts.engine_piper": "Local voice (Piper, offline)",
"tts.status_ready": "Piper is installed.",
"tts.status_missing": "Piper or voices missing - click Install.",
"tts.cached": "{count} lines cached",
"tts.install": "Install Piper + Swedish/English voices",
"tts.reinstall": "Check installation",
"tts.pregenerate": "Pre-generate phrases and driver names",
"tts.pregenerate_progress": "Pre-generated {done} of {total} ({failed} failed)",
"tts.test": "Test the voice",
"auth.title": "Admin PIN",
"auth.hint": "Protects every change (races, results, settings, updates) with a PIN. Reading and public overlay/training links are unaffected. The login is remembered in this browser for 30 days.",
"auth.state_off": "Off - anyone on the network can make changes.",
@@ -3088,7 +3115,7 @@ const TRANSLATIONS = {
"audio.max_delay": "Maximum delay (seconds)",
"audio.per_competitor": "Different passing tone per driver/car",
"audio.test": "Test",
"audio.note": "Fixed effects use WAV files from the sound pack. Voice announcements use the browser installed system voices. Changes save automatically; critical announcements interrupt lower-priority speech.",
"audio.note": "Fixed effects use WAV files from the sound pack. Voice announcements use the voice engine chosen above - the local Piper voice or the browser's system voices. Changes save automatically; critical announcements interrupt lower-priority speech.",
"audio.effect": "Effect",
"audio.voice": "Voice",
"audio.track_call": "TRACK CALL",
@@ -3327,6 +3354,7 @@ const TRANSLATIONS = {
"guide.audio_7": "7. Personal best, fastest lap, track record, leader changes, time warnings, pit entry/exit, finish, and podium reuse existing timing events.",
"guide.audio_8": "8. Audio plays in the operator browser. Use Test before racing, verify the audio output, and keep the Timing tab open.",
"guide.audio_9": "9. A staggered start in a qualifying heat calls out each car's transponder number in grid order, about 3 seconds apart, right after the official start - a mass/position start never calls out individual cars.",
"guide.audio_10": "10. Better voice without internet: under Settings -> Audio -> Voice engine, click Install once (downloads Piper plus Swedish and English voices, needs internet just then) and choose Local voice. Then click Pre-generate phrases and driver names before race day. Everything then runs locally; if Piper is missing or slow the browser voice is used automatically.",
"guide.sponsor_title": "Create Sponsor Event: 10 drivers, 4 cars",
"guide.sponsor_1": "1. Add 4 cars in Cars with unique transponder IDs. You can also store brand/model in the brand field.",
"guide.sponsor_2": "2. Add 10 drivers in Drivers. You can also store team/brand in the brand field and filter by it later.",
@@ -4080,6 +4108,7 @@ function loadState() {
speechVoiceUri: String(parsed.settings?.speechVoiceUri || ""),
speechRate: Math.max(0.65, Math.min(1.35, Number(parsed.settings?.speechRate || 0.95) || 0.95)),
speechPitch: Math.max(0.7, Math.min(1.3, Number(parsed.settings?.speechPitch || 1) || 1)),
ttsEngine: parsed.settings?.ttsEngine === "piper" ? "piper" : "browser",
speakerPassingCueEnabled: parsed.settings?.speakerPassingCueEnabled === true,
speakerLeaderCueEnabled: parsed.settings?.speakerLeaderCueEnabled !== false,
speakerFinishCueEnabled: parsed.settings?.speakerFinishCueEnabled !== false,
@@ -4148,6 +4177,7 @@ function loadState() {
speechVoiceUri: "",
speechRate: 0.95,
speechPitch: 1,
ttsEngine: "browser",
speakerPassingCueEnabled: false,
speakerLeaderCueEnabled: true,
speakerFinishCueEnabled: true,