release: v0.1.21 -- ctrl+q default window snap (T-180)

Author: VAC34

CHANGELOG.md

@@ -4,6 +4,31 @@ All notable changes to SAIPENVIEW are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 Semantic versioning — see `saipenview/__init__.py`.
 
+## [0.1.21] - 2026-08-07
+
+### Changed
+
+- **Default window-snap hotkey is now `Ctrl+Q` (T-180).** `snap_hotkey`
+  ships `["ctrl+q"]` instead of `["alt+f14"]`, reversing the 4d291a0
+  decision that freed the combo — a global binding hijacks it in every app
+  and it collides with common quit accelerators, a tradeoff the user
+  explicitly accepted. The load-time migration that silently purged `ctrl+q`
+  from any saved config is gone: a snap binding the user sets in Settings
+  now survives restarts instead of being reset on the next launch. Settings
+  placeholder, quick-help and all 34 locale/README translations follow.
+
+### Removed
+
+- `config.py`'s `_is_ctrl_q` load-time strip and its four migration tests
+  (the strip existed only to clean configs that predated 4d291a0).
+
+### Fixed
+
+- Release version files reconciled: `pyproject.toml` and
+  `saipenview/__init__.py` had lagged v0.1.18..v0.1.20 (tags shipped while
+  the declared version stayed 0.1.17, so wheels carried stale METADATA).
+  Reset to 0.1.21 so the tag, the wheel and the changelog agree again.
+
 ## [0.1.20] - 2026-08-07
 
 ### Added

README.md

@@ -75,7 +75,7 @@
 
 ### ⌨️ Hotkeys & Window
 - **Show/Hide** — `Ctrl+Alt+X` (configurable)
-- **Snap corners** — `Alt+F14` cycles TL → TR → BL → BR
+- **Snap corners** — `Ctrl+Q` cycles TL → TR → BL → BR
 - **Zoom** — `Ctrl+MouseWheel`, `Ctrl+`+`/`-`
 - **System tray** — minimize to tray, start hidden
 - **Always-on-top** toggle
@@ -142,7 +142,7 @@ Coming soon ✨
 | Action | How |
 |---|---|
 | **Show / Hide** | `Ctrl+Alt+X` or `Alt+F15` (both configurable) |
-| **Snap corner** | `Alt+F14` — cycles Top-Left → Top-Right → Bottom-Left → Bottom-Right |
+| **Snap corner** | `Ctrl+Q` — cycles Top-Left → Top-Right → Bottom-Left → Bottom-Right |
 | **Kill switch** | `Ctrl+Shift+Alt+Q` — force-quit the process |
 | **Zoom in / out** | `Ctrl+MouseWheel` or `Ctrl` + `+` / `-` |
 | **Zoom reset** | `Ctrl+0` |
@@ -235,7 +235,7 @@ Key defaults (abridged — the full `DEFAULTS` dict lives in `saipenview/config.
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "theme":            "goldendefault",
@@ -313,7 +313,7 @@ saipenview/
 ├── tray.py             pystray system-tray icon + menu
 ├── hotkey.py           Global hotkey registration (keyboard lib)
 ├── autostart.py        Windows Registry autostart management
-├── zone_picker.py      Alt+F14 corner-snap overlay (tkinter)
+├── zone_picker.py      Ctrl+Q corner-snap overlay (tkinter)
 ├── events.py           In-process event bus (EventBus)
 ├── guard.py            Single-instance lock + show-request handoff
 ├── git_diff.py         Working-tree diff / commit / revert for agent actions

docs/i18n/README.ar.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ اختصارات المفاتيح والنوافذ
 - **إظهار/إخفاء** — `Ctrl+Alt+X` (قابل للضبط)
-- **التصاق الزوايا** - `Alt+F14` يتنقل TL ← TR ← BL ← BR
+- **التصاق الزوايا** - `Ctrl+Q` يتنقل TL ← TR ← BL ← BR
 - **التكبير/التصغير** — `Ctrl+عجلة الماوس`، `Ctrl+`+`/`-`
 - **صينية النظام** — التصغير إلى الصينية، البدء مخفياً
 - **دائماً في الأعلى** تبديل
@@ -140,7 +140,7 @@ saipenview
 | الإجراء | كيفية الاستخدام |
 |---|---|
 | **إظهار / إخفاء** | `Ctrl+Alt+X` أو `Alt+F15` (كلاهما قابل للضبط) |
-| **التصاق الزاوية** | `Alt+F14` - يتنقل أعلى-يسار ← أعلى-يمين ← أسفل-يسار ← أسفل-يمين |
+| **التصاق الزاوية** | `Ctrl+Q` - يتنقل أعلى-يسار ← أعلى-يمين ← أسفل-يسار ← أسفل-يمين |
 | **مفتاح الإنهاء** | `Ctrl+Shift+Alt+Q` — إغلاق إجباري للعملية |
 | **تكبير / تصغير** | `Ctrl+عجلة الماوس` أو `Ctrl` + `+` / `-` |
 | **إعادة ضبط التكبير** | `Ctrl+0` |
@@ -225,7 +225,7 @@ saipenview/_data/config.json
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -269,7 +269,7 @@ saipenview/
 ├── tray.py             أيقونة صينية النظام والقائمة بـ pystray
 ├── hotkey.py           تسجيل الاختصارات العالمية (مكتبة keyboard)
 ├── autostart.py        إدارة التشغيل التلقائي في سجل Windows
-├── zone_picker.py      تراكب التصاق الزاوية Alt+F14 (tkinter)
+├── zone_picker.py      تراكب التصاق الزاوية Ctrl+Q (tkinter)
 ├── events.py           ناقل أحداث داخل العملية (EventBus)
 ├── guard.py            قفل النسخة الواحدة + تسليم طلب الإظهار
 ├── git_diff.py         فرق/تثبيت/تراجع شجرة العمل لإجراءات الوكيل

docs/i18n/README.bg.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ Бързи клавиши и Прозорец
 - **Показване/Скриване** — `Ctrl+Alt+X` (конфигурируемо)
-- **Залепване в ъгли** - `Alt+F14` превключва TL → TR → BL → BR
+- **Залепване в ъгли** - `Ctrl+Q` превключва TL → TR → BL → BR
 - **Мащабиране** — `Ctrl+КолелоНаМишката`, `Ctrl+`+`/`-`
 - **Системен трей** — минимизиране в трея, стартиране скрит
 - **Винаги най-отгоре** превключвател
@@ -140,7 +140,7 @@ saipenview
 | Действие | Как |
 |---|---|
 | **Показване / Скриване** | `Ctrl+Alt+X` или `Alt+F15` (и двете са конфигурируеми) |
-| **Залепване в ъгъл** | `Alt+F14` - превключва Горе-Ляво → Горе-Дясно → Долу-Ляво → Долу-Дясно |
+| **Залепване в ъгъл** | `Ctrl+Q` - превключва Горе-Ляво → Горе-Дясно → Долу-Ляво → Долу-Дясно |
 | **Аварийно спиране** | `Ctrl+Shift+Alt+Q` — принудително прекратяване на процеса |
 | **Увеличаване / Намаляване** | `Ctrl+КолелоНаМишката` или `Ctrl` + `+` / `-` |
 | **Нулиране на мащаба** | `Ctrl+0` |
@@ -225,7 +225,7 @@ saipenview/_data/config.json
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -269,7 +269,7 @@ saipenview/
 ├── tray.py             Икона в системния трей pystray + меню
 ├── hotkey.py           Глобална регистрация на бързи клавиши (библиотека keyboard)
 ├── autostart.py        Управление на автостарт в Windows Registry
-├── zone_picker.py      Оверлей за залепване в ъгъл Alt+F14 (tkinter)
+├── zone_picker.py      Оверлей за залепване в ъгъл Ctrl+Q (tkinter)
 ├── events.py           Вътрешнопроцесна шина за събития (EventBus)
 ├── guard.py            Заключване на един екземпляр + предаване на показване
 ├── git_diff.py         Diff / commit / revert на работното дърво за действия на агенти

docs/i18n/README.cs.md

@@ -74,7 +74,7 @@
 
 ### ⌨️ Hotkeys & Window
 - **Show/Hide** — `Ctrl+Alt+X` (configurable)
-- **Snap corners** — `Alt+F14` cycles TL → TR → BL → BR
+- **Snap corners** — `Ctrl+Q` cycles TL → TR → BL → BR
 - **Zoom** — `Ctrl+MouseWheel`, `Ctrl+`+`/`-`
 - **System tray** — minimize to tray, start hidden
 - **Always-on-top** toggle
@@ -141,7 +141,7 @@ Coming soon ✨
 | Action | How |
 |---|---|
 | **Show / Hide** | `Ctrl+Alt+X` or `Alt+F15` (both configurable) |
-| **Snap corner** | `Alt+F14` — cycles Top-Left → Top-Right → Bottom-Left → Bottom-Right |
+| **Snap corner** | `Ctrl+Q` — cycles Top-Left → Top-Right → Bottom-Left → Bottom-Right |
 | **Kill switch** | `Ctrl+Shift+Alt+Q` — force-quit the process |
 | **Zoom in / out** | `Ctrl+MouseWheel` or `Ctrl` + `+` / `-` |
 | **Zoom reset** | `Ctrl+0` |
@@ -234,7 +234,7 @@ Key defaults (abridged — the full `DEFAULTS` dict lives in `saipenview/config.
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -278,7 +278,7 @@ saipenview/
 ├── tray.py             pystray system-tray icon + menu
 ├── hotkey.py           Global hotkey registration (keyboard lib)
 ├── autostart.py        Windows Registry autostart management
-├── zone_picker.py      Alt+F14 corner-snap overlay (tkinter)
+├── zone_picker.py      Ctrl+Q corner-snap overlay (tkinter)
 ├── events.py           In-process event bus (EventBus)
 ├── guard.py            Single-instance lock + show-request handoff
 ├── git_diff.py         Working-tree diff / commit / revert for agent actions

docs/i18n/README.da.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ Genvejstaster & Vindue
 - **Vis/Skjul** — `Ctrl+Alt+X` (konfigurerbar)
-- **Fastgør til hjørner** - `Alt+F14` skifter OV → OH → NV → NH
+- **Fastgør til hjørner** - `Ctrl+Q` skifter OV → OH → NV → NH
 - **Zoom** — `Ctrl+Musehjul`, `Ctrl+`+`/`-`
 - **Systembakke** — minimer til bakke, start skjult
 - **Altid øverst**-skift
@@ -140,7 +140,7 @@ Kommer snart ✨
 | Handling | Hvordan |
 |---|---|
 | **Vis / Skjul** | `Ctrl+Alt+X` eller `Alt+F15` (begge kan konfigureres) |
-| **Fastgør til hjørne** | `Alt+F14` - skifter Øverst-venstre → Øverst-højre → Nederst-venstre → Nederst-højre |
+| **Fastgør til hjørne** | `Ctrl+Q` - skifter Øverst-venstre → Øverst-højre → Nederst-venstre → Nederst-højre |
 | **Nødstop (Kill switch)** | `Ctrl+Shift+Alt+Q` — tving afslutning af processen |
 | **Zoom ind / ud** | `Ctrl+Musehjul` eller `Ctrl` + `+` / `-` |
 | **Nulstil zoom** | `Ctrl+0` |
@@ -225,7 +225,7 @@ Vigtigste standardværdier (forkortet - den fulde `DEFAULTS`-ordbog ligger i `sa
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -269,7 +269,7 @@ saipenview/
 ├── tray.py             pystray-systembakkeikon + menu
 ├── hotkey.py           Global registrering af genvejstaster (keyboard lib)
 ├── autostart.py        Håndtering af Windows Registreringsdatabase autostart
-├── zone_picker.py      Alt+F14 hjørne-fastgørelsesoverlejring (tkinter)
+├── zone_picker.py      Ctrl+Q hjørne-fastgørelsesoverlejring (tkinter)
 ├── events.py           In-process hændelsesbus (EventBus)
 ├── guard.py            Enkeltinstans-lås + visning-anmodning overlevering
 ├── git_diff.py         Arbejdstræets diff / commit / revert for agenthandlinger

docs/i18n/README.de.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ Tastenkombinationen & Fenster
 - **Anzeigen/Ausblenden** — `Strg+Alt+X` (konfigurierbar)
-- **Ecken-Einrasten** - `Alt+F14` wechselt OL → OR → UL → UR
+- **Ecken-Einrasten** - `Ctrl+Q` wechselt OL → OR → UL → UR
 - **Zoom** — `Strg+Mausrad`, `Strg+`+`/`-`
 - **System-Tray** — in den Tray minimieren, versteckt starten
 - **Immer im Vordergrund**-Umschalter
@@ -140,7 +140,7 @@ Demnächst verfügbar ✨
 | Aktion | Wie |
 |---|---|
 | **Anzeigen / Ausblenden** | `Strg+Alt+X` oder `Alt+F15` (beide konfigurierbar) |
-| **Ecke einrasten** | `Alt+F14` - wechselt Oben-Links → Oben-Rechts → Unten-Links → Unten-Rechts |
+| **Ecke einrasten** | `Ctrl+Q` - wechselt Oben-Links → Oben-Rechts → Unten-Links → Unten-Rechts |
 | **Not-Aus (Kill Switch)** | `Strg+Umschalt+Alt+Q` — Prozess sofort beenden |
 | **Vergrößern / Verkleinern** | `Strg+Mausrad` oder `Strg` + `+` / `-` |
 | **Zoom zurücksetzen** | `Strg+0` |
@@ -225,7 +225,7 @@ Wichtige Standardwerte (gekurzt - das vollstandige `DEFAULTS`-Worterbuch befinde
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -269,7 +269,7 @@ saipenview/
 ├── tray.py             pystray System-Tray-Symbol + Menü
 ├── hotkey.py           Globale Hotkey-Registrierung (keyboard-Bibliothek)
 ├── autostart.py        Windows-Registrierungs-Autostart-Verwaltung
-├── zone_picker.py      Alt+F14 Ecken-Einrast-Overlay (tkinter)
+├── zone_picker.py      Ctrl+Q Ecken-Einrast-Overlay (tkinter)
 ├── events.py           Prozessinterner Ereignisbus (EventBus)
 ├── guard.py            Einzelinstanz-Sperre + Anzeige-Anfrage-Ubergabe
 ├── git_diff.py         Arbeitsbaum-Diff / Commit / Revert fur Agent-Aktionen

docs/i18n/README.ded.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ Клавиши и окно
 - **Показать/Скрыть** — `Ctrl+Alt+X` (настраивается)
-- **Привязка к углам** — `Alt+F14` гоняет по кругу ЛВ → ЛН → ПН → ПВ
+- **Привязка к углам** — `Ctrl+Q` гоняет по кругу ЛВ → ЛН → ПН → ПВ
 - **Масштаб** — `Ctrl+Колесо`, `Ctrl+`+`/`-`
 - **Трей** — сворачивается в трей, можно стартовать скрытым
 - **Поверх всех окон** — переключатель
@@ -142,7 +142,7 @@ saipenview
 | Действие | Как |
 |---|---|
 | **Показать / Скрыть** | `Ctrl+Alt+X` или `Alt+F15` (оба настраиваются) |
-| **Привязка к углу** | `Alt+F14` — цикл Верх-Лево → Верх-Право → Низ-Лево → Низ-Право |
+| **Привязка к углу** | `Ctrl+Q` — цикл Верх-Лево → Верх-Право → Низ-Лево → Низ-Право |
 | **Аварийный выход** | `Ctrl+Shift+Alt+Q` — принудительно, без соплей |
 | **Масштаб** | `Ctrl+Колесо` или `Ctrl` + `+` / `-` |
 | **Сброс масштаба** | `Ctrl+0` |
@@ -239,7 +239,7 @@ saipenview/_data/config.json
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -285,7 +285,7 @@ saipenview/
 ├── tray.py             Иконка pystray в трее + меню
 ├── hotkey.py           Глобальные хоткеи (keyboard)
 ├── autostart.py        Автозапуск через реестр Windows
-├── zone_picker.py      Оверлей привязки к углу Alt+F14 (tkinter)
+├── zone_picker.py      Оверлей привязки к углу Ctrl+Q (tkinter)
 ├── events.py           Внутрипроцессная шина событий (EventBus)
 ├── guard.py            Блокировка одиночного экземпляра + показ
 ├── git_diff.py         Diff / commit / revert рабочего дерева для агентов

docs/i18n/README.ee.md

@@ -73,7 +73,7 @@
 
 ### ⌨️ Kiirklahvid ja aken
 - **Kuva / Peida** — `Ctrl+Alt+X` (seadistatav)
-- **Nurga klõps** — `Alt+F14` tsüklina VP → VN → AN → AP
+- **Nurga klõps** — `Ctrl+Q` tsüklina VP → VN → AN → AP
 - **Suum** — `Ctrl+Hiireratas`, `Ctrl+`+`/`-`
 - **Süsteemsalv** — minimeerimine salve, peidetud käivitus
 - **Alati ees** — lüliti
@@ -142,7 +142,7 @@ Varsti ✨
 | Tegevus | Kuidas |
 |---|---|
 | **Kuva / Peida** | `Ctrl+Alt+X` või `Alt+F15` (mõlemad seadistatavad) |
-| **Nurga klõps** | `Alt+F14` — tsükkel Üles-Vasak → Üles-Parem → Alla-Vasak → Alla-Parem |
+| **Nurga klõps** | `Ctrl+Q` — tsükkel Üles-Vasak → Üles-Parem → Alla-Vasak → Alla-Parem |
 | **Hädasulge** | `Ctrl+Shift+Alt+Q` — protsessi sundlõpetamine |
 | **Suum sisse / välja** | `Ctrl+Hiireratas` või `Ctrl` + `+` / `-` |
 | **Suumi lähtestus** | `Ctrl+0` |
@@ -239,7 +239,7 @@ Peamised vaikimisi väärtused (lühendatud — täielik `DEFAULTS`-sõnastik on
 ```json
 {
   "hotkeys":          ["ctrl+alt+x", "alt+f15"],
-  "snap_hotkey":      ["alt+f14"],
+  "snap_hotkey":      ["ctrl+q"],
   "zoom_level":       1.0,
   "font_family":      "Verdana_m1",
   "scan_roots":       null,
@@ -285,7 +285,7 @@ saipenview/
 ├── tray.py             pystray salveikoon + menüü
 ├── hotkey.py           Globaalsete kiirklahvide registreerimine (keyboard)
 ├── autostart.py        Windowsi registri automaatkäivituse haldus
-├── zone_picker.py      Alt+F14 nurga-klõpsu ülekate (tkinter)
+├── zone_picker.py      Ctrl+Q nurga-klõpsu ülekate (tkinter)
 ├── events.py           Protsisisisene sündmussiin (EventBus)
 ├── guard.py            Ühekordse eksemplari lukk + näitamistaotluse edastus
 ├── git_diff.py         Tööpuu diff / commit / revert agentide tegevuste jaoks