hyperframes 0.4.10 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -17,6 +17,8 @@ Requires: Docker installed and running.
17
17
  - `-f, --fps` — 24, 30, or 60 (default: 30)
18
18
  - `-q, --quality` — draft, standard, high (default: standard)
19
19
  - `-w, --workers` — Parallel workers 1-8 (default: auto)
20
+ - `--crf` — Override encoder CRF (mutually exclusive with `--video-bitrate`)
21
+ - `--video-bitrate` — Target video bitrate such as `10M` (mutually exclusive with `--crf`)
20
22
  - `--gpu` — Use GPU encoding (NVENC, VideoToolbox, VAAPI)
21
23
  - `-o, --output` — Custom output path
22
24
 
@@ -16,6 +16,25 @@ Match voice to content. Default is `af_heart`.
16
16
 
17
17
  Run `npx hyperframes tts --list` for all 54 voices (8 languages).
18
18
 
19
+ ## Multilingual Phonemization
20
+
21
+ Kokoro voice IDs encode language in the first letter: `a`=American English, `b`=British English, `e`=Spanish, `f`=French, `h`=Hindi, `i`=Italian, `j`=Japanese, `p`=Brazilian Portuguese, `z`=Mandarin. The CLI auto-detects the phonemizer locale from that prefix — you don't need to pass `--lang` when the voice matches the text.
22
+
23
+ ```bash
24
+ npx hyperframes tts "La reunión empieza a las nueve" --voice ef_dora --output es.wav
25
+ npx hyperframes tts "今日はいい天気ですね" --voice jf_alpha --output ja.wav
26
+ ```
27
+
28
+ Use `--lang` only to override auto-detection (e.g. stylized accents):
29
+
30
+ ```bash
31
+ npx hyperframes tts "Hello there" --voice af_heart --lang fr-fr --output accented.wav
32
+ ```
33
+
34
+ Valid `--lang` codes: `en-us`, `en-gb`, `es`, `fr-fr`, `hi`, `it`, `pt-br`, `ja`, `zh`.
35
+
36
+ Non-English phonemization requires `espeak-ng` installed system-wide (`brew install espeak-ng` on macOS, `apt-get install espeak-ng` on Debian/Ubuntu).
37
+
19
38
  ## Speed Tuning
20
39
 
21
40
  - **0.7-0.8** — Tutorial, complex content
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hyperframes",
3
- "version": "0.4.10",
3
+ "version": "0.4.11",
4
4
  "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
5
5
  "repository": {
6
6
  "type": "git",