From 221756e501dd0d27b6d846817494647a9e63e8a7 Mon Sep 17 00:00:00 2001
From: "russell@unturf.com" <russell@unturf.com>
Date: Fri, 5 Jun 2026 18:03:31 -0400
Subject: [PATCH] pre_process_map: track config file in repo; fix Providence
 pronunciation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

F5-TTS mispronounces "Providence" — add hyphenation regex
(Prov-uh-dence). Promote config/pre_process_map.yaml from
gitignored generated file to tracked repo file so the regex
map ships via git pull instead of needing per-host manual edits.
.default.yaml retained as seed for fresh installs.
---
 .gitignore                   |  1 -
 config/pre_process_map.yaml  | 39 ++++++++++++++++++++++++++++++++++++
 pre_process_map.default.yaml |  3 +++
 3 files changed, 42 insertions(+), 1 deletion(-)
 create mode 100644 config/pre_process_map.yaml

diff --git a/.gitignore b/.gitignore
index 19a66fc..c69ef32 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,7 +2,6 @@ voices/
 .env
 speech.env
 vars.sh
-config/pre_process_map.yaml
 config/voice_to_speaker.yaml
 
 # Byte-compiled / optimized / DLL files
diff --git a/config/pre_process_map.yaml b/config/pre_process_map.yaml
new file mode 100644
index 0000000..bb206c5
--- /dev/null
+++ b/config/pre_process_map.yaml
@@ -0,0 +1,39 @@
+# regex pairs to clean the text before speaking
+- - ([^.])\.$
+  - \1
+- - '&amp;'
+  - '&'
+- - '&lt;'
+  - <
+- - '&gt;'
+  - '>'
+- - '&quot;'
+  - '"'
+- - '&#x27;'
+  - ''''
+- - '&copy;'
+  - '©'
+- - '&reg;'
+  - '®'
+- - '&nbsp;'
+  - ' '
+- - '"'
+  - ''
+- - ' biases '
+  - ' bias''s '
+- - ex\.
+  - for example
+- - e\.g\.
+  - for example
+- - ' ESG '
+  - ' E.S.G. '
+- - ' FY '
+  - ' F.Y. '
+- - ([0-9]+)-([0-9]+)
+  - \1 to \2
+# F5-TTS mispronounces "Providence" (RI city) — hyphenate to hint syllables
+- - (?i)\bProvidence\b
+  - Prov-uh-dence
+# xtts has a lot of trouble with these, but piper is fine.
+#- - '[\*=+-]+'
+#  - ' '
diff --git a/pre_process_map.default.yaml b/pre_process_map.default.yaml
index 90f0620..5e85545 100644
--- a/pre_process_map.default.yaml
+++ b/pre_process_map.default.yaml
@@ -31,6 +31,9 @@
   - ' F.Y. '
 - - ([0-9]+)-([0-9]+)
   - \1 to \2
+# F5-TTS mispronounces "Providence" (RI city) — hyphenate to hint syllables
+- - (?i)\bProvidence\b
+  - Prov-uh-dence
 # xtts has a lot of trouble with these, but piper is fine.
 #- - '[\*=+-]+'
 #  - ' '