UA Voice CC Bridge 🎮🔊

Плагін для Decky Loader який озвучує субтитри в іграх на Steam Deck українською мовою через синтез мови.

⚠️ Важливо: Плагін не робить переклад! Він лише зчитує та озвучує субтитри які вже є в грі. Гра повинна мати вбудовані українські субтитри — інакше плагін працюватиме некоректно.

Як це працює

Плагін робить знімок зони субтитрів на екрані, розпізнає текст через OCR і озвучує його через синтезатор мови Piper.

Знімок екрану → OCR (Tesseract) → Синтез мови (Piper) → Звук
~200мс          ~100мс             ~160мс

Загальна затримка від появи субтитрів до озвучення: ~300мс

Можливості

• 🎯 Розпізнавання субтитрів в будь-якій грі
• 🔊 Синтез мови українською (3 голоси: Микита, Лада, Тетяна)
• ⌨️ Режим "Друкарська машинка" — озвучення субтитрів по мірі появи
• 🎛️ Налаштування зони субтитрів, фільтрів зображення, OCR і TTS
• 👁️ Превью зображення з фільтрами
• 🎮 Профілі налаштувань для кожної гри окремо

Вимоги

• Steam Deck з встановленим Decky Loader
• Гра з українськими субтитрами

Встановлення

Спосіб 1 — Через Decky (найпростіший) ✅

1. Завантаж zip з Releases
2. Відкрий на Steam Deck: Decky → ⚙️ Settings → Developer → Install Plugin from URL
3. Вставте пряме посилання на zip файл
4. Готово! Плагін з'явиться в меню Decky ✅

Спосіб 2 — Вручну

1. Завантаж zip з Releases
2. Розпакуй в /home/deck/homebrew/plugins/
   • Має вийти папка /home/deck/homebrew/plugins/UA_VoiceCCBridge/
3. Перезапусти Decky через термінал:

   sudo systemctl restart plugin_loader
   

Спосіб 3 — Через Decky Store

(Очікується у майбутніх релізах)

Використання

1. Відкрийте меню Decky (кнопка ... на Steam Deck)
2. Знайдіть UA Voice CC Bridge
3. Запустіть гру з українськими субтитрами
4. Налаштуйте зону субтитрів через меню Зона субтитрів
5. Увімкніть Активація воркера
6. Грайте з озвученими субтитрами! 🎮

Налаштування

Зона субтитрів

Вкажіть де на екрані знаходяться субтитри. Використовуйте кнопку Зробити знімок для перевірки.

Фільтри зображення

Налаштуйте контраст, яскравість та кольоровий фільтр для кращого розпізнавання тексту.

OCR

• Інтервал — як часто робити знімок (мс)
• Мін. довжина — мінімальна кількість символів для озвучення
• Фільтр повторів — поріг схожості для фільтрації дублікатів

TTS (Синтез мови)

• Голос — Lada / Mykyta / Tetiana
• Швидкість — швидкість читання
• Живість голосу — варіативність інтонації
• Дихання — природність переходів між звуками

Технічні деталі

Компонент	Технологія
OCR	Tesseract 5 + tesserocr
TTS	Piper + ukrainian-tts
Знімок	GStreamer + PipeWire
UI	React + Decky Loader SDK

Підтримати проєкт

Якщо плагін вам корисний і хочете підтримати розробку — буду дуже радий! ☕

Monobank: send.monobank.ua/jar/7oNtZZsgCb

💳 Картка: 4874 1000 2613 9066

Ліцензія

MIT License

---

Зроблено з ❤️ для українських гравців