Roborock S5 Hungarian voice pack (Noémi)

English · Magyar

---

English

Hungarian TTS voice pack for Roborock S5 / Gen1–Gen2, as a Valetudo-compatible .pkg.

This repository does not store audio files. The installable roborock-s5-hu-noemi.pkg is published as a GitHub Release asset (release-please + CI).

Voice: Microsoft Edge TTS hu-HU-NoemiNeural. Format: mono 16 kHz Int16 WAV → ccrypt-encrypted Roborock voice pack.

Install with Valetudo

Recommended: local HTTP server. Roborock firmware often fails to download GitHub Release assets (Download failed / timeout). GitHub answers with a 302 redirect to a long signed release-assets.githubusercontent.com URL; the robot’s downloader does not handle that reliably. Serving the .pkg yourself on the LAN is the method that works.

1. Download roborock-s5-hu-noemi.pkg (and optionally the .md5) from the latest Release on your computer.
2. In that folder, start a simple server:

python3 -m http.server 8000
# LAN IP on macOS, e.g.: ipconfig getifaddr en0

3. Valetudo → Robot settings → Voice packs — use http:// (not https):

Field	Value
URL	http://<YOUR_PC_LAN_IP>:8000/roborock-s5-hu-noemi.pkg
Language	va (try en or hu if needed)
Hash	leave empty, or use the value from roborock-s5-hu-noemi.pkg.md5

Keep the PC and robot on the same Wi‑Fi, leave the server running until install finishes.

GitHub Release URLs (…/releases/…/download/… or direct release-assets.githubusercontent.com links) are fine for humans downloading the file, but are not a reliable Valetudo install URL on Roborock.

Texts

• texts/texts_hu.yaml — Hungarian lines (edit these)
• texts/texts_en.yaml — English reference

Local development

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
pre-commit install   # format, lint + conventional commit-msg

Hooks run ruff (format/lint), yamllint, shellcheck, actionlint, and enforce conventional commit messages (feat:, fix:, …).

Generate locally

source .venv/bin/activate
pip install -r requirements.txt
# needs ffmpeg (brew install ffmpeg)
python scripts/validate_texts.py
python scripts/generate_hu.py --force
# needs ccrypt (brew install ccrypt)
./scripts/package_valetudo.sh

Output: custom/hu/*.wav, then dist/roborock-s5-hu-noemi.pkg + MD5 + valetudo-install.txt.

Release flow

Conventional commits on main → release-please opens a release PR → after merge, GitHub Release + CI uploads:

• roborock-s5-hu-noemi.pkg
• roborock-s5-hu-noemi.pkg.md5
• valetudo-install.txt

Example commits:

feat: more natural error11 wording
fix: missing restart_spot text

Compatibility

• Roborock S5 / S50 (and similar Gen2), plus Gen1 voice-pack format
• Valetudo voice pack management
• Not Dreame / newer Roborock OGG packs

Licence / notes

Generated Hungarian audio comes from these scripts; Microsoft Edge TTS terms apply. This repo does not redistribute the stock English factory pack.

---

Magyar

Magyar TTS hangcsomag Roborock S5 / Gen1–Gen2 robotokhoz, Valetudo-kompatibilis .pkg formátumban.

A repository nem tartalmaz hangfájlokat. A telepíthető roborock-s5-hu-noemi.pkg a GitHub Releases assetjeként készül (release-please + CI).

Hang: Microsoft Edge TTS hu-HU-NoemiNeural. Formátum: mono 16 kHz Int16 WAV → ccrypt-titkosított Roborock voice pack.

Valetudo telepítés

Ajánlott: helyi HTTP szerver. A Roborock firmware gyakran nem tudja letölteni a GitHub Release asseteket (Download failed / timeout). A GitHub 302 redirecttel egy hosszú, aláírt release-assets.githubusercontent.com URL-re küld; a robot letöltője ezt nem kezeli megbízhatóan. LAN-on saját szerverrel viszont stabilan megy.

1. Töltsd le a roborock-s5-hu-noemi.pkg fájlt (és opcionálisan az .md5-öt) a legfrissebb release-ből a számítógépedre.
2. Abban a mappában indíts egyszerű szervert:

python3 -m http.server 8000
# LAN IP macOS-en pl.: ipconfig getifaddr en0

3. Valetudo → Robot settings → Voice packs — http:// kell (ne https):

Mező	Érték
URL	http://<A_GEPED_LAN_IP>:8000/roborock-s5-hu-noemi.pkg
Language	va (ha kell, próbáld: en vagy hu)
Hash	üresen hagyható, vagy a roborock-s5-hu-noemi.pkg.md5 értéke

A gép és a robot legyen ugyanazon a Wi‑Fi-n; a szerver fusson a telepítés végéig.

A GitHub Release URL-ek (…/releases/…/download/… vagy közvetlen release-assets.githubusercontent.com linkek) embereknek jók a fájl letöltéséhez, de Roborockon nem megbízható Valetudo telepítési URL.

Szövegek

• texts/texts_hu.yaml — magyar mondatok (szerkeszd ezt)
• texts/texts_en.yaml — angol referencia

Helyi fejlesztés

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
pre-commit install   # format, lint + conventional commit-msg

A hookok commit előtt futtatják a ruff format/lint, yamllint, shellcheck, actionlint ellenőrzéseket, és a commit üzenetet conventional commit formátumra (feat:, fix:, …) ellenőrzik.

Helyi generálás

source .venv/bin/activate
pip install -r requirements.txt
# ffmpeg kell (brew install ffmpeg)
python scripts/validate_texts.py
python scripts/generate_hu.py --force
# ccrypt kell (brew install ccrypt)
./scripts/package_valetudo.sh

Kimenet: custom/hu/*.wav, majd dist/roborock-s5-hu-noemi.pkg + MD5 + valetudo-install.txt.

Release folyamat

Conventional commits a main ágon → release-please release PR-t nyit → merge után GitHub Release + CI feltölti:

• roborock-s5-hu-noemi.pkg
• roborock-s5-hu-noemi.pkg.md5
• valetudo-install.txt

Példa commit üzenetek:

feat: természetesebb error11 fordítás
fix: hiányzó restart_spot szöveg javítása

Kompatibilitás

• Roborock S5 / S50 (és hasonló Gen2), illetve Gen1 voice pack formátum
• Valetudo voice pack management
• Nem Dreame / újabb Roborock OGG csomag

Licenc / megjegyzés

A TTS-sel generált magyar hangok a scriptjeidből származnak; a Microsoft Edge TTS használatára a szolgáltató feltételei vonatkoznak. Az eredeti gyári angol hangcsomagot ez a repo nem terjeszti.