Release v0.3.0: перевод с экрана по клавише Ё.

Добавлены оверлей выделения, Windows OCR, модалка рядом с выделением и обновлены README и release notes.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: MrMe0ws

README.md

@@ -7,11 +7,12 @@
   <img src="photo/modal.png" alt="Пример работы" width="420" style="max-width: 100%; height: auto;">
 </p>
 
-**MeowsL** — фоновый переводчик для Windows. Работает из системного трея: скопировал текст, нажал Ctrl+c+c — получил перевод в компактном popup-окне.
+**MeowsL** — фоновый переводчик для Windows из системного трея. **Ctrl+C+C** — перевод из буфера; **Ё** — выдели текст на экране рамкой. Результат в компактном popup-окне.
 
 ## Возможности
 
 - **Ctrl+C+C** — открыть перевод текста из буфера обмена
+- **Ё** — выделить область на экране и перевести текст с картинки
 - **Ctrl+Alt+T** — запасной хоткей
 - Автоопределение языка: русский ↔ английский
 - Редактирование исходного текста с debounce-переводом
@@ -47,13 +48,23 @@ py -3 main.py
 3. Можно править верхнее поле — перевод обновится автоматически.
 4. Закройте окно через `Esc`, клик мимо окна или **×** — приложение останется в трее.
 
+### Перевод с экрана (картинки, PDF, игры)
+
+1. Нажмите **Ё** (физическая клавиша слева от `1`).
+2. Зажмите левую кнопку мыши и обведите нужный текст рамкой.
+3. Отпустите кнопку — MeowsL распознает текст и покажет перевод.
+4. `Esc` во время выделения — отмена.
+
+> Для распознавания используется встроенный Windows OCR. Убедитесь, что в системе установлены OCR-пакеты нужных языков (обычно EN и RU уже есть). Проверка в PowerShell: `Get-WindowsCapability -Online -Name "Language.OCR*"`.
+
 
 ## Стек
 
 - Python 3.10+
 - PyQt6 — интерфейс
 - `deep_translator` — Google Translate API
 - `keyboard` — глобальные хоткеи Windows
+- `winocr` + `Pillow` — захват и распознавание текста с экрана (Windows OCR)
 - PyInstaller — сборка в exe
 
 ## Структура

RELEASE_NOTES.md

@@ -1,31 +1,39 @@
-# Релиз v0.2.1
+# Релиз v0.3.0
 
 ## Вариант для GitHub Releases
 
 ## 🚀 Новое
 
-- **Автозапуск с Windows** — галочка «Запускать с Windows» в меню трея; состояние сохраняется в настройках и синхронизируется с реестром (`HKCU\...\Run`) при старте приложения
+- **Перевод с экрана по клавише Ё** — нажмите физическую клавишу "Ё", обведите текст рамкой мышью и получите перевод в модалке
+- **Оверлей выделения** — затемнение экрана, пунктирная рамка, отмена по `Esc`
+- **Модалка рядом с выделением** — окно перевода открывается под, над или сбоку от выбранной области (с учётом границ экрана)
 
 ## ✨ Улучшения
 
-- В **README** добавлено описание автозапуска; уточнена формулировка про необходимость прав администратора для глобальных хоткеев
+- Хоткей **Ё** привязан к физической клавише (scan code 41) и работает независимо от раскладки
+- Распознавание текста с экрана через встроенный **Windows OCR** (английский пакет)
+
 
 ## 🧱 Технические изменения
 
-- Модуль `platform/autostart.py`: запись в реестр, синхронизация пути к exe при обновлении
-- Установщик Inno Setup: при деинсталляции удаляется запись автозапуска MeowsL из реестра
+- Новые модули: `screen_capture_overlay`, `ocr`, `ocr_runner`
+- Зависимости: `winocr`, `Pillow`
+- Обновлены `build/meowsl.spec` (сборка WinRT/OCR), `README.md`, `requirements.txt`
 
 ---
 
 ## Вариант для Telegram
 
-0.2.1 https://github.com/MrMe0ws/MeowsL/releases/tag/0.2.1
+0.3.0 https://github.com/MrMe0ws/MeowsL/releases/tag/0.3.0
 
 🚀 Новое
-• Автозапуск с Windows — галочка «Запускать с Windows» в меню трея
+• Перевод с экрана по клавише Ё — выделите текст рамкой и получите перевод в модалке
+• Оверлей выделения с затемнением экрана; отмена по Esc
+• Модалка открывается рядом с выделенной областью
 
 ✨ Улучшения
-• README: описание автозапуска и уточнение про хоткеи
+• Хоткей Ё работает на любой раскладке клавиатуры
+• Распознавание текста через Windows OCR
 
 🧱 Технические изменения
-• Синхронизация автозапуска с реестром при старте; очистка записи при удалении через установщик
+• winocr и Pillow; обновлены сборка exe и README

build/installer.iss

@@ -2,7 +2,7 @@
 ; Скачать Inno Setup: https://jrsoftware.org/isinfo.php
 
 #define MyAppName "MeowsL"
-#define MyAppVersion "0.2.0"
+#define MyAppVersion "0.3.0"
 #define MyAppPublisher "MeowsLate"
 #define MyAppExeName "MeowsL.exe"
 

build/meowsl.spec

@@ -1,23 +1,40 @@
 # -*- mode: python ; coding: utf-8 -*-
 from pathlib import Path
 
+from PyInstaller.utils.hooks import collect_all, collect_submodules
+
 # SPECPATH = папка build; корень проекта — на уровень выше
 ROOT = Path(SPECPATH).parent
 
+winocr_datas, winocr_binaries, winocr_hiddenimports = collect_all("winocr")
+winrt_hiddenimports = collect_submodules("winrt")
+
 a = Analysis(
     [str(ROOT / "main.py")],
     pathex=[str(ROOT / "src")],
-    binaries=[],
+    binaries=winocr_binaries,
     datas=[
         (str(ROOT / "photo" / "logo.png"), "photo"),
         (str(ROOT / "photo" / "logo-icon.png"), "photo"),
+        *winocr_datas,
     ],
     hiddenimports=[
         "PyQt6.QtCore",
         "PyQt6.QtGui",
         "PyQt6.QtWidgets",
         "deep_translator",
         "keyboard",
+        "winocr",
+        "PIL",
+        "PIL.Image",
+        "winrt.windows.media.ocr",
+        "winrt.windows.globalization",
+        "winrt.windows.graphics.imaging",
+        "winrt.windows.storage.streams",
+        "winrt.windows.foundation",
+        "winrt.windows.foundation.collections",
+        *winocr_hiddenimports,
+        *winrt_hiddenimports,
     ],
     hookspath=[],
     hooksconfig={},

pyproject.toml

@@ -4,14 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "translate-meows"
-version = "0.2.0"
+version = "0.3.0"
 description = "Глобальный переводчик по хоткею для Windows"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "PyQt6>=6.6.0",
     "deep-translator>=1.11.4",
     "keyboard>=0.13.5",
+    "winocr>=0.0.15",
+    "Pillow>=10.0.0",
 ]
 
 [project.scripts]

requirements.txt

@@ -1,3 +1,5 @@
 PyQt6>=6.6.0
 deep-translator>=1.11.4
 keyboard>=0.13.5
+winocr>=0.0.15
+Pillow>=10.0.0

src/translate_meows/app.py

@@ -2,22 +2,27 @@
 
 import sys
 
-from PyQt6.QtCore import QObject, Qt, pyqtSignal
-from PyQt6.QtGui import QGuiApplication
+from PyQt6.QtCore import QObject, Qt, QRect, pyqtSignal
+from PyQt6.QtGui import QGuiApplication, QImage
 from PyQt6.QtWidgets import QApplication, QMessageBox, QSystemTrayIcon
 
 from translate_meows.config import APP_NAME
 from translate_meows.platform import autostart
 from translate_meows.platform.hotkey import HotkeyListener
 from translate_meows.platform.tray import TrayManager
+from translate_meows.services.ocr_runner import OcrRunner
 from translate_meows.ui.icons import app_icon
 from translate_meows.ui.popup_window import TranslationPopup
+from translate_meows.ui.screen_capture_overlay import ScreenCaptureOverlay
+
+OCR_EMPTY_MESSAGE = "Текст не распознан"
 
 
 class HotkeyBridge(QObject):
     """Мост между потоком keyboard и главным потоком Qt."""
 
     triggered = pyqtSignal()
+    screen_capture_triggered = pyqtSignal()
 
 
 class TranslatorApp:
@@ -31,12 +36,27 @@ def __init__(self) -> None:
         self._app.setStyle("Fusion")
 
         self._popup = TranslationPopup()
+        self._overlay = ScreenCaptureOverlay()
+        self._ocr_runner = OcrRunner()
+        self._ocr_request_id = 0
+        self._capture_anchor: QRect | None = None
+
         self._bridge = HotkeyBridge()
         self._bridge.triggered.connect(
             self._on_hotkey_triggered, Qt.ConnectionType.QueuedConnection
         )
+        self._bridge.screen_capture_triggered.connect(
+            self._on_screen_capture_triggered, Qt.ConnectionType.QueuedConnection
+        )
 
-        self._hotkey = HotkeyListener(on_trigger=self._bridge.triggered.emit)
+        self._overlay.region_captured.connect(self._on_region_captured)
+        self._ocr_runner.finished.connect(self._on_ocr_finished)
+        self._ocr_runner.error.connect(self._on_ocr_error)
+
+        self._hotkey = HotkeyListener(
+            on_trigger=self._bridge.triggered.emit,
+            on_screen_capture=self._bridge.screen_capture_triggered.emit,
+        )
         self._tray = TrayManager(
             on_show=self._on_hotkey_triggered,
             on_quit=self._app.quit,
@@ -59,13 +79,47 @@ def run(self) -> int:
 
     def _on_about_to_quit(self) -> None:
         self._hotkey.stop()
+        self._overlay.dismiss()
+        self._ocr_request_id += 1
+        self._ocr_runner.shutdown(timeout_ms=15000)
         self._popup.shutdown()
 
     def _on_hotkey_triggered(self) -> None:
         clipboard = QGuiApplication.clipboard()
         text = clipboard.text() if clipboard else ""
         self._popup.show_with_text(text)
 
+    def _on_screen_capture_triggered(self) -> None:
+        if self._overlay.isVisible():
+            return
+        self._overlay.show_overlay()
+
+    def _on_region_captured(self, image: QImage, selection: QRect) -> None:
+        self._capture_anchor = selection
+        self._ocr_request_id += 1
+        self._ocr_runner.submit(image, self._ocr_request_id)
+
+    def _on_ocr_finished(self, text: str, request_id: int) -> None:
+        if request_id != self._ocr_request_id:
+            return
+        anchor = self._capture_anchor
+        self._capture_anchor = None
+        if text.strip():
+            self._popup.show_with_text(text, anchor_rect=anchor)
+            return
+        self._popup.show_with_text(
+            OCR_EMPTY_MESSAGE, auto_translate=False, anchor_rect=anchor
+        )
+
+    def _on_ocr_error(self, message: str, request_id: int) -> None:
+        if request_id != self._ocr_request_id:
+            return
+        anchor = self._capture_anchor
+        self._capture_anchor = None
+        self._popup.show_with_text(
+            message, auto_translate=False, anchor_rect=anchor
+        )
+
 
 def run() -> int:
     return TranslatorApp().run()

src/translate_meows/config.py

@@ -2,7 +2,7 @@
 
 APP_NAME = "Translate Meows"
 APP_DISPLAY_NAME = "MeowsL"
-APP_VERSION = "0.2.2"
+APP_VERSION = "0.3.0"
 
 # Перевод
 DEBOUNCE_MS = 600
@@ -11,6 +11,12 @@
 # Глобальные хоткеи
 DOUBLE_CTRL_C_INTERVAL_MS = 500
 FALLBACK_HOTKEY = "ctrl+alt+t"
+# Физическая клавиша слева от «1» (Ё / `) — scan code 41 на стандартной раскладке
+SCREEN_CAPTURE_SCAN_CODE = 41
+
+# Захват области экрана
+MIN_SELECTION_SIZE = 10
+POPUP_ANCHOR_MARGIN = 12
 
 # Окно
 POPUP_WIDTH = 420

src/translate_meows/platform/hotkey.py

@@ -6,32 +6,77 @@
 
 import keyboard
 
-from translate_meows.config import DOUBLE_CTRL_C_INTERVAL_MS, FALLBACK_HOTKEY
+from translate_meows.config import (
+    DOUBLE_CTRL_C_INTERVAL_MS,
+    FALLBACK_HOTKEY,
+    SCREEN_CAPTURE_SCAN_CODE,
+)
+
+
+def _register_scan_code_hotkey(
+    scan_code: int,
+    callback: Callable[[], None],
+    *,
+    suppress: bool = True,
+) -> Callable[[], None]:
+    """
+    Привязка к физической клавише по scan code.
+    Нужна для клавиши Ё, т.к. имя символа зависит от раскладки.
+    """
+    from keyboard import KEY_DOWN, _listener as listener
+
+    def hook(event) -> bool:
+        if event.event_type == KEY_DOWN:
+            callback()
+        if suppress:
+            return False
+        return True
+
+    listener.start_if_necessary()
+    store = listener.blocking_keys if suppress else listener.nonblocking_keys
+    store[scan_code].append(hook)
+
+    def remove() -> None:
+        if hook in store[scan_code]:
+            store[scan_code].remove(hook)
+
+    return remove
 
 
 class HotkeyListener:
     """
     Слушает глобальные хоткеи:
-    - Ctrl+C+C (двойное нажатие за 500 мс) — основной
+    - Ctrl+C+C (двойное нажатие за 500 мс) — перевод из буфера
     - Ctrl+Alt+T — запасной
+    - Ё (физ. клавиша scan 41) — выделение области экрана
     """
 
-    def __init__(self, on_trigger: Callable[[], None]) -> None:
+    def __init__(
+        self,
+        on_trigger: Callable[[], None],
+        on_screen_capture: Callable[[], None],
+    ) -> None:
         self._on_trigger = on_trigger
+        self._on_screen_capture = on_screen_capture
         self._last_ctrl_c = 0.0
         self._interval = DOUBLE_CTRL_C_INTERVAL_MS / 1000.0
         self._lock = Lock()
         self._ctrl_c_handle = None
         self._fallback_handle = None
+        self._screen_capture_remove: Optional[Callable[[], None]] = None
 
     def start(self) -> None:
-        # add_hotkey надёжнее raw hook на Windows
         self._ctrl_c_handle = keyboard.add_hotkey(
             "ctrl+c", self._on_ctrl_c, suppress=False, trigger_on_release=False
         )
         self._fallback_handle = keyboard.add_hotkey(
             FALLBACK_HOTKEY, self._on_trigger, suppress=False
         )
+        self._screen_capture_remove = _register_scan_code_hotkey(
+            SCREEN_CAPTURE_SCAN_CODE,
+            self._on_screen_capture,
+            suppress=True,
+        )
 
     def stop(self) -> None:
         if self._ctrl_c_handle is not None:
@@ -40,6 +85,9 @@ def stop(self) -> None:
         if self._fallback_handle is not None:
             keyboard.remove_hotkey(self._fallback_handle)
             self._fallback_handle = None
+        if self._screen_capture_remove is not None:
+            self._screen_capture_remove()
+            self._screen_capture_remove = None
 
     def _on_ctrl_c(self) -> None:
         now = time.monotonic()