https://github.com/yanorei32/libktts-server
A modern HTTP wrapper for the legacy KTTS Project Korean text-to-speech engine: https://libktts.yr32.net/
https://github.com/yanorei32/libktts-server
api korean korean-tts north-korean-language redstar redstaros rust text-to-speech tts web
Last synced: about 1 month ago
JSON representation
A modern HTTP wrapper for the legacy KTTS Project Korean text-to-speech engine: https://libktts.yr32.net/
- Host: GitHub
- URL: https://github.com/yanorei32/libktts-server
- Owner: yanorei32
- License: bsd-2-clause
- Created: 2025-11-25T12:05:24.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-05-06T03:33:38.000Z (about 2 months ago)
- Last Synced: 2026-05-06T05:26:35.922Z (about 2 months ago)
- Topics: api, korean, korean-tts, north-korean-language, redstar, redstaros, rust, text-to-speech, tts, web
- Language: Rust
- Homepage: https://libktts.yr32.net/
- Size: 155 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# libKTTS Server
## Introduction
> **조선어음성합성프로그람 《청봉》3.2** (kttsproject) is a program that reads text aloud.
>
> The kttsproject is our country's most excellent voice synthesis program, which won the honor of 1st place at the 17th National Program Contest and Exhibition in October Juche 95 (2006).
`libktts-server` is a server wrapper for this legacy TTS engine (kttsproject), allowing it to be used via a modern HTTP API.
## Official Hosted Instance
[https://libktts.yr32.net/](https://libktts.yr32.net/)
## Usage
### Docker
The easiest way to run `libktts-server` is using Docker, as it requires a specific 32-bit environment.
```bash
docker run -p 3000:3000 ghcr.io/yanorei32/libktts-server
```
### Configuration
You can configure the server using command-line arguments or environment variables.
| Argument | Env Var | Default | Description |
| :--- | :--- | :--- | :--- |
| `--listen` | `LISTEN` | `0.0.0.0:3000` | Socket address to bind to. |
| `--dic` | `DIC` | `/usr/share/apps/kttsdb/` | Path to the dictionary directory. |
| `--maximum-length` | `MAXIMUM_LENGTH` | `0` (Unlimited) | Maximum length of text to synthesize. |
### API
#### POST `/api/tts`
Synthesizes text to speech.
**Request:**
```json
{
"text": "안녕하십니까?"
}
```
**Response:**
- **Content-Type**: `audio/wav`
- **Body**: WAV audio data.
If the text exceeds `MAXIMUM_LENGTH`, a `400 Bad Request` is returned.
## Technical Details
This project uses a multi-stage Docker build to run the 32-bit `libktts` binary on modern systems. The core library, `libkttsproject-4.0-1.i386.rpm`, was extracted from RedStar 3.0.
- **Base**: `debian:trixie-slim`
- **Runtime**: `debian:squeeze` (i386) environment extracted into the final image.
- **Server**: Rust (Axum) application acting as a bridge.
The server uses `memfd_create` to pass audio data from the legacy library to the HTTP response without writing to disk.