//go:build extra // +build extra package extra import ( "bytes" "encoding/json" "fmt" "gf-lt/config" "gf-lt/models" "io" "log/slog" "net/http" "os" "regexp" "strings" "time" google_translate_tts "github.com/GrailFinder/google-translate-tts" "github.com/GrailFinder/google-translate-tts/handlers" "github.com/gopxl/beep/v2" "github.com/gopxl/beep/v2/mp3" "github.com/gopxl/beep/v2/speaker" "github.com/neurosnap/sentences/english" ) var ( TTSTextChan = make(chan string, 10000) TTSFlushChan = make(chan bool, 1) TTSDoneChan = make(chan bool, 1) // endsWithPunctuation = regexp.MustCompile(`[;.!?]$`) ) // cleanText removes markdown and special characters that are not suitable for TTS func cleanText(text string) string { // Remove markdown-like characters that might interfere with TTS text = strings.ReplaceAll(text, "*", "") // Bold/italic markers text = strings.ReplaceAll(text, "#", "") // Headers text = strings.ReplaceAll(text, "_", "") // Underline/italic markers text = strings.ReplaceAll(text, "~", "") // Strikethrough markers text = strings.ReplaceAll(text, "`", "") // Code markers text = strings.ReplaceAll(text, "[", "") // Link brackets text = strings.ReplaceAll(text, "]", "") // Link brackets text = strings.ReplaceAll(text, "!", "") // Exclamation marks (if not punctuation) // Remove HTML tags using regex htmlTagRegex := regexp.MustCompile(`<[^>]*>`) text = htmlTagRegex.ReplaceAllString(text, "") // Split text into lines to handle table separators lines := strings.Split(text, "\n") var filteredLines []string for _, line := range lines { // Check if the line looks like a table separator (e.g., |----|, |===|, | - - - |) // A table separator typically contains only |, -, =, and spaces isTableSeparator := regexp.MustCompile(`^\s*\|\s*[-=\s]+\|\s*$`).MatchString(strings.TrimSpace(line)) if !isTableSeparator { // If it's not a table separator, remove vertical bars but keep the content processedLine := strings.ReplaceAll(line, "|", "") filteredLines = append(filteredLines, processedLine) } // If it is a table separator, skip it (don't add to filteredLines) } text = strings.Join(filteredLines, "\n") text = strings.TrimSpace(text) // Remove leading/trailing whitespace return text } type Orator interface { Speak(text string) error Stop() // pause and resume? GetLogger() *slog.Logger } // impl https://github.com/remsky/Kokoro-FastAPI type KokoroOrator struct { logger *slog.Logger URL string Format models.AudioFormat Stream bool Speed float32 Language string Voice string currentStream *beep.Ctrl // Added for playback control textBuffer strings.Builder // textBuffer bytes.Buffer } // Google Translate TTS implementation type GoogleTranslateOrator struct { logger *slog.Logger speech *google_translate_tts.Speech currentStream *beep.Ctrl textBuffer strings.Builder } func (o *KokoroOrator) stoproutine() { <-TTSDoneChan o.logger.Debug("orator got done signal") o.Stop() // drain the channel for len(TTSTextChan) > 0 { <-TTSTextChan } } func (o *KokoroOrator) readroutine() { tokenizer, _ := english.NewSentenceTokenizer(nil) // var sentenceBuf bytes.Buffer // var remainder strings.Builder for { select { case chunk := <-TTSTextChan: // sentenceBuf.WriteString(chunk) // text := sentenceBuf.String() _, err := o.textBuffer.WriteString(chunk) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } text := o.textBuffer.String() sentences := tokenizer.Tokenize(text) o.logger.Debug("adding chunk", "chunk", chunk, "text", text, "sen-len", len(sentences)) for i, sentence := range sentences { if i == len(sentences)-1 { // last sentence o.textBuffer.Reset() _, err := o.textBuffer.WriteString(sentence.Text) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } continue // if only one (often incomplete) sentence; wait for next chunk } cleanedText := cleanText(sentence.Text) if cleanedText == "" { continue // Skip empty text after cleaning } o.logger.Debug("calling Speak with sentence", "sent", cleanedText) if err := o.Speak(cleanedText); err != nil { o.logger.Error("tts failed", "sentence", cleanedText, "error", err) } } case <-TTSFlushChan: o.logger.Debug("got flushchan signal start") // lln is done get the whole message out if len(TTSTextChan) > 0 { // otherwise might get stuck for chunk := range TTSTextChan { _, err := o.textBuffer.WriteString(chunk) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } if len(TTSTextChan) == 0 { break } } } // INFO: if there is a lot of text it will take some time to make with tts at once // to avoid this pause, it might be better to keep splitting on sentences // but keepinig in mind that remainder could be ommited by tokenizer // Flush remaining text remaining := o.textBuffer.String() remaining = cleanText(remaining) o.textBuffer.Reset() if remaining != "" { o.logger.Debug("calling Speak with remainder", "rem", remaining) if err := o.Speak(remaining); err != nil { o.logger.Error("tts failed", "sentence", remaining, "error", err) } } } } } func NewOrator(log *slog.Logger, cfg *config.Config) Orator { provider := cfg.TTS_PROVIDER if provider == "" { provider = "kokoro" } switch strings.ToLower(provider) { case "google", "google-translate", "google_translate": language := cfg.TTS_LANGUAGE if language == "" { language = "en" } speech := &google_translate_tts.Speech{ Folder: os.TempDir() + "/gf-lt-tts", // Temporary directory for caching Language: language, Proxy: "", // Proxy not supported Speed: cfg.TTS_SPEED, Handler: &handlers.Beep{}, } orator := &GoogleTranslateOrator{ logger: log, speech: speech, } go orator.readroutine() go orator.stoproutine() return orator default: // kokoro orator := &KokoroOrator{ logger: log, URL: cfg.TTS_URL, Format: models.AFMP3, Stream: false, Speed: cfg.TTS_SPEED, Language: "a", Voice: "af_bella(1)+af_sky(1)", } go orator.readroutine() go orator.stoproutine() return orator } } func (o *KokoroOrator) GetLogger() *slog.Logger { return o.logger } func (o *KokoroOrator) requestSound(text string) (io.ReadCloser, error) { payload := map[string]interface{}{ "input": text, "voice": o.Voice, "response_format": o.Format, "download_format": o.Format, "stream": o.Stream, "speed": o.Speed, // "return_download_link": true, "lang_code": o.Language, } payloadBytes, err := json.Marshal(payload) if err != nil { return nil, fmt.Errorf("failed to marshal payload: %w", err) } req, err := http.NewRequest("POST", o.URL, bytes.NewBuffer(payloadBytes)) //nolint:noctx if err != nil { return nil, fmt.Errorf("failed to create request: %w", err) } req.Header.Set("accept", "application/json") req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { return nil, fmt.Errorf("request failed: %w", err) } if resp.StatusCode != http.StatusOK { defer resp.Body.Close() return nil, fmt.Errorf("unexpected status code: %d", resp.StatusCode) } return resp.Body, nil } func (o *KokoroOrator) Speak(text string) error { o.logger.Debug("fn: Speak is called", "text-len", len(text)) body, err := o.requestSound(text) if err != nil { o.logger.Error("request failed", "error", err) return fmt.Errorf("request failed: %w", err) } defer body.Close() // Decode the mp3 audio from response body streamer, format, err := mp3.Decode(body) if err != nil { o.logger.Error("mp3 decode failed", "error", err) return fmt.Errorf("mp3 decode failed: %w", err) } defer streamer.Close() // here it spams with errors that speaker cannot be initialized more than once, but how would we deal with many audio records then? if err := speaker.Init(format.SampleRate, format.SampleRate.N(time.Second/10)); err != nil { o.logger.Debug("failed to init speaker", "error", err) } done := make(chan bool) // Create controllable stream and store reference o.currentStream = &beep.Ctrl{Streamer: beep.Seq(streamer, beep.Callback(func() { close(done) o.currentStream = nil })), Paused: false} speaker.Play(o.currentStream) <-done // we hang in this routine; return nil } func (o *KokoroOrator) Stop() { // speaker.Clear() o.logger.Debug("attempted to stop orator", "orator", o) speaker.Lock() defer speaker.Unlock() if o.currentStream != nil { // o.currentStream.Paused = true o.currentStream.Streamer = nil } } func (o *GoogleTranslateOrator) stoproutine() { <-TTSDoneChan o.logger.Debug("orator got done signal") o.Stop() // drain the channel for len(TTSTextChan) > 0 { <-TTSTextChan } } func (o *GoogleTranslateOrator) readroutine() { tokenizer, _ := english.NewSentenceTokenizer(nil) for { select { case chunk := <-TTSTextChan: _, err := o.textBuffer.WriteString(chunk) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } text := o.textBuffer.String() sentences := tokenizer.Tokenize(text) o.logger.Debug("adding chunk", "chunk", chunk, "text", text, "sen-len", len(sentences)) for i, sentence := range sentences { if i == len(sentences)-1 { // last sentence o.textBuffer.Reset() _, err := o.textBuffer.WriteString(sentence.Text) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } continue // if only one (often incomplete) sentence; wait for next chunk } cleanedText := cleanText(sentence.Text) if cleanedText == "" { continue // Skip empty text after cleaning } o.logger.Debug("calling Speak with sentence", "sent", cleanedText) if err := o.Speak(cleanedText); err != nil { o.logger.Error("tts failed", "sentence", cleanedText, "error", err) } } case <-TTSFlushChan: o.logger.Debug("got flushchan signal start") // lln is done get the whole message out if len(TTSTextChan) > 0 { // otherwise might get stuck for chunk := range TTSTextChan { _, err := o.textBuffer.WriteString(chunk) if err != nil { o.logger.Warn("failed to write to stringbuilder", "error", err) continue } if len(TTSTextChan) == 0 { break } } } remaining := o.textBuffer.String() remaining = cleanText(remaining) o.textBuffer.Reset() if remaining != "" { o.logger.Debug("calling Speak with remainder", "rem", remaining) if err := o.Speak(remaining); err != nil { o.logger.Error("tts failed", "sentence", remaining, "error", err) } } } } } func (o *GoogleTranslateOrator) GetLogger() *slog.Logger { return o.logger } func (o *GoogleTranslateOrator) Speak(text string) error { o.logger.Debug("fn: Speak is called", "text-len", len(text)) // Generate MP3 data using google-translate-tts reader, err := o.speech.GenerateSpeech(text) if err != nil { o.logger.Error("generate speech failed", "error", err) return fmt.Errorf("generate speech failed: %w", err) } // Decode the mp3 audio from reader (wrap with NopCloser for io.ReadCloser) streamer, format, err := mp3.Decode(io.NopCloser(reader)) if err != nil { o.logger.Error("mp3 decode failed", "error", err) return fmt.Errorf("mp3 decode failed: %w", err) } defer streamer.Close() playbackStreamer := beep.Streamer(streamer) speed := o.speech.Speed if speed <= 0 { speed = 1.0 } if speed != 1.0 { playbackStreamer = beep.ResampleRatio(3, float64(speed), streamer) } // Initialize speaker with the format's sample rate if err := speaker.Init(format.SampleRate, format.SampleRate.N(time.Second/10)); err != nil { o.logger.Debug("failed to init speaker", "error", err) } done := make(chan bool) // Create controllable stream and store reference o.currentStream = &beep.Ctrl{Streamer: beep.Seq(playbackStreamer, beep.Callback(func() { close(done) o.currentStream = nil })), Paused: false} speaker.Play(o.currentStream) <-done // wait for playback to complete return nil } func (o *GoogleTranslateOrator) Stop() { o.logger.Debug("attempted to stop google translate orator") speaker.Lock() defer speaker.Unlock() if o.currentStream != nil { o.currentStream.Streamer = nil } // Also stop the speech handler if possible if o.speech != nil { _ = o.speech.Stop() } }