Інструкція з встановлення CyrFlip

Як пов'язані дві частини

Застосунок - це «мозок»: він знає активну розкладку. Розширення - лише поверхня для відображення в VS Code, бо VS Code малює власну каретку, позицію якої застосунок не може точно відстежити ззовні.

  CyrFlip.exe (трей)               %LOCALAPPDATA%\CyrFlip\        Розширення VS Code
  визначає EN / RU / UK    ──пише──▶      layout.txt      ──стежить──▶  малює маркер
                                                                       біля каретки редактора

Застосунок має бути запущений, інакше розширенню нема що показувати - воно лише читає те, що публікує застосунок. Без VS Code ви все одно отримуєте значок у треї, маркер на курсорі миші та гарячу клавішу транслітерації всюди.

Крок 1 - встановіть і запустіть застосунок CyrFlip

Будь-який із варіантів:

• Microsoft Store - знайдіть CyrFlip у застосунку Microsoft Store на Windows 10/11 і натисніть Отримати.
• winget:

  winget install SerZhyAle.CyrFlip

• Переносний ZIP - завантажте зі сторінки релізів, розпакуйте будь-куди та запустіть CyrFlip.exe. Встановлювати нічого не треба; працює на «голій» Windows 10/11.

Після запуску CyrFlip сидить у системному треї (без вікна). Значок показує активну розкладку (EN/RU/UK). Правий клік відкриває меню - гаряча клавіша «перевороту», перемикач Start with Windows (автозапуск) і Exit (вихід).

Увімкніть Start with Windows, щоб застосунок - а отже й маркер розкладки всюди, включно з VS Code - був доступний одразу після перезавантаження.

Крок 2 - встановіть розширення для VS Code (необов'язково)

Розширення для VS Code не є обов'язковим для роботи застосунку. Якщо ви не користуєтеся VS Code - пропустіть цей крок. Встановлюйте його лише якщо хочете маркер точно біля каретки всередині VS Code. Оберіть один спосіб:

• З Marketplace - відкрийте Extensions (Ctrl+Shift+X), знайдіть CyrFlip (видавець SerZhyAle) і натисніть Install.
• З файлу .vsix - візьміть cyrflip-vscode-<версія>.vsix з теки vscode-extension, потім у VS Code: Extensions ▸ ⋯ ▸ Install from VSIX.., або з термінала:

  code --install-extension cyrflip-vscode-<версія>.vsix

Після встановлення виконайте Developer: Reload Window (Ctrl+Shift+P). Розширення запускається саме - налаштування не потрібне.

Крок 3 - користуйтеся разом

1. Переконайтеся, що застосунок CyrFlip запущений (значок у треї показує EN/RU/UK).
2. Клацніть у редактор коду у VS Code і почніть друкувати. Перемкніть розкладку - кольоровий маркер EN/RU/UK слідує за кареткою, а в рядку стану видно ⌨ EN/RU/UK.
3. Скрізь в інших місцях (інші застосунки, діалоги, робочий стіл) маркер їде на курсорі-«балці» миші та на значку в треї - усе від того самого застосунку.
4. Набрали в неправильній розкладці? Виділіть і натисніть Ctrl+Shift+F12 - CyrFlip транслітерує на місці (QWERTY ↔ ЙЦУКЕН, EN ↔ RU). Кожен символ перемикається за скриптом, тому змішаний EN + RU також обробляється коректно. Працює в будь-якому застосунку, включно з VS Code.
5. Хочете, щоб клавіатура перемикалася слідом за виправленням? Увімкніть Change the language after the flip у меню трея - після фліпу CyrFlip також перемкне активну мову введення (EN → RU, інакше → EN), щоб ви продовжували друкувати в правильній розкладці.

Де показується розкладка

Усередині VS Code webview-панелі та віджети - вбудований термінал, поля пошуку, панелі чату, палітра команд - не можуть містити декорації редактора, тому маркер біля каретки там не з'являється. Розкладку все одно показують індикатор у рядку стану та маркер на курсорі миші.

Усунення проблем

• Немає маркера у VS Code. Перевірте, що застосунок запущений, потім що файл розкладки існує і його вміст змінюється при зміні розкладки. Шлях залежить від способу встановлення: portable/winget → %LOCALAPPDATA%\CyrFlip\layout.txt; Microsoft Store → %ProgramData%\CyrFlip\layout.txt. Індикатор у рядку стану - найшвидший спосіб переконатися, що розширення читає файл. Спробуйте Developer: Reload Window.
• Маркер біля краю поля (не у VS Code). У редакторах на основі Monaco зовнішній оверлей застосунку не може точно прочитати каретку - саме це й вирішує розширення, тож встановіть його.
• Курсор-«балка» миші лишився зміненим після жорсткого завершення. CyrFlip відновлює системний курсор під час виходу; якщо процес знято примусово («Зняти завдання»), запустіть CyrFlip знову або перезайдіть у систему, щоб відновити курсор.
• Гаряча клавіша не спрацьовує. Спершу виділіть текст і переконайтеся, що Ctrl+Shift+F12 не перехоплює інший інструмент. Клавішу можна змінити у config.json.