https://github.com/c-loftus/mandarin-clipboard-speaker

Speak 汉字 on the Linux desktop just by copying it to your clipboard
https://github.com/c-loftus/mandarin-clipboard-speaker

chinese language-learning mandarin mandarin-tts piper-tts

Last synced: 4 months ago
JSON representation

Speak 汉字 on the Linux desktop just by copying it to your clipboard

• Host: GitHub
• URL: https://github.com/c-loftus/mandarin-clipboard-speaker
• Owner: C-Loftus
• Created: 2025-05-24T23:20:36.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2025-06-01T13:57:50.000Z (5 months ago)
• Last Synced: 2025-06-26T19:02:06.817Z (4 months ago)
• Topics: chinese, language-learning, mandarin, mandarin-tts, piper-tts
• Language: Go
• Homepage:
• Size: 1010 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

          
# Mandarin Clipboard Speaker

- Automatically speak Chinese characters as Mandarin when they are copied to the system clipboard on Linux.

- Runs offline and works in any application with the goal to make 汉字 easier to read for non-native speakers.

## Running

- Clone the repo then run `go run main.go`

- If the local model is not present, it will be installed automatically

- For automatic start on boot via systemd, run `make install` with the included makefile

## Technical Details

This program runs and installs the [Piper](https://rhasspy.github.io/piper-samples/) text-to-speech model for Mandarin Chinese.  It currently installs the model and binary to the same location as [QuickPiperAudiobook](https://github.com/C-Loftus/QuickPiperAudiobook) but in the future once Piper is included within [speech dispatcher](https://github.com/brailcom/speechd), I can use that instead.

### Quickstart Video

[![Mandarin-Clipboard-Speaker Quickstart](./docs/video_thumbnail.jpg)](https://youtu.be/Ax4buJ-f4Jg "Mandarin-Clipboard-Speaker Quickstart")