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

Застосунок CyrFlip працює самостійно — ставить маркер розкладки на системний курсор і поруч із кареткою в будь-якому застосунку, транслітерує текст однією гарячою клавішею. Якщо ви використовуєте VS Code — необов'язкове розширення для VS Code додає той самий маркер точно біля каретки редактора Monaco. Нижче описано, як їх налаштувати.

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

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

  CyrFlip.exe (трей)               %LOCALAPPDATA%\CyrFlip\        Розширення VS Code
  визначає розкладку      ──пише──▶      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 сидить у системному треї (без вікна). Значок показує активну розкладку. Правий клік відкриває історію буфера, її увімкнення та паузу, перемикачі індикатора й Налаштування. У налаштуваннях є гарячі клавіші, автозапуск, приватність і діагностика.

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

Історія буфера (необов'язково)

Історія буфера вимкнена, доки ви не ввімкнете її в меню трея. Вона зберігає недавні Unicode-тексти у невеликому вікні поверх інших. Клацніть запис, щоб використати його; важливі записи можна закріпити, а непотрібні видалити. Ctrl+Shift+F10 показує або ховає вікно.

Історія зберігається лише локально та захищена Windows DPAPI для вашого облікового запису. Захоплення можна призупинити, очистити історію або повністю вимкнути функцію в треї чи налаштуваннях.

Налаштування по вкладках

Правий клік по значку в треї та Налаштування... (або подвійний клік по значку). Будь-яка зміна застосовується одразу - нічого перезапускати чи зберігати не треба.

Вкладка	Що там є
Загальні	Запуск разом із Windows; не давати комп'ютеру засинати та не блокувати екран (обидва запам'ятовуються - забутий увімкненим перемикач не дасть комп'ютеру заснути й після перезапуску, стежити за вашою батареєю CyrFlip не буде); мова інтерфейсу - 13 на вибір.
Індикатори	Маркер на курсорі миші (типово вимкнений), маркер біля каретки (увімкнений), компактна крапка замість літер, змінювати розкладку після перетворення тексту та синхронізувати CapsLock після виправлення регістру.
Гарячі клавіші	Загальний вимикач плюс окремі вимикач і сполучення для виправлення регістру та менеджера буфера - можна лишити тільки потрібне. Там само поступатися хоткеями віддаленому робочому столу: поки у фокусі вікно mstsc/msrdc, сполучення йде у віддалений сеанс - саме це потрібно, коли CyrFlip запущено на обох кінцях RDP. Тут само живе контекстне меню: його вимикач і акорд миші, що його відкриває.
Перетворення розкладок	Одна таблиця, де зібрані всі сполучення, що перетворюють текст між розкладками. Рядок EN ⇄ RU на `Ctrl`+`Shift`+`F12` створюється під час першого запуску, його можна змінити або видалити, як і будь-який інший; пар можна додати скільки завгодно, кожна зі своїм сполученням і своїм вимикачем.
Мови Windows	Налаштування введення самої Windows, без відкриття її панелі: встановлення, порядок і видалення розкладок (нічого не завантажується - розкладки вже входять до складу Windows), сполучення перебору (Alt+Shift, Ctrl+Shift, ` або вимкнено) та прямі сполучення на мову, які обробляє сама Windows, тому вони працюють і при закритому CyrFlip - і, на відміну від штатного вікна Windows, тут не лише Ctrl+Shift+цифра. Обидва розділи один раз зберігають стан «до CyrFlip» і вміють його повернути.
Буфер обміну	Увімкнення історії, пауза захоплення, чи показувати вікно менеджера під час запуску, його прозорість, пошук по всій історії та повне очищення.
Переклад	Вимикач перекладу виділеного тексту (типово вимкнений), адреса сервера Ollama та модель, кнопки «Встановити Ollama», «Запустити Ollama», «Перевірити зв'язок» і «Завантажити модель», таблиця напрямків перекладу — кожен рядок зі своїм сполученням — і що робити з результатом: покласти в буфер обміну чи одразу вставити замість виділення.
Швидкий запуск	Необов'язковий лаунчер сценаріїв — див. розділ нижче.
Про програму	Посилання, звіт діагностики положення каретки та Надіслати логи автору.. - збирає логи CyrFlip в один архів і відкриває лист, який надсилаєте ви самі.

Зміна в «Мовах Windows» зазвичай діє одразу, але іноді Windows остаточно приймає її лише після виходу та повторного входу. Версія з Microsoft Store працює в контейнері, тому Windows може перенаправити такі записи в реєстр усередину пакета - вкладка попереджає про це й дає посилання на налаштування Windows.

Швидкий запуск (лаунчер сценаріїв, необов'язково)

Необов'язковий модуль, що увібрав у себе OneClickRunner, — один процес у треї замість двох. За замовчуванням вимкнений: доки не ввімкнете його в «Налаштування → Швидкий запуск», CyrFlip поводиться точно як раніше — ні зайвого пункту в треї, ні завдань у Jump List.

Сценарії двох типів: програма/скрипт (шлях, аргументи, робоча папка, необов'язковий запуск від адміністратора) та завантаження yt-dlp (папка завантаження + дод. параметри; посилання запитується під час кожного запуску, а зовнішня утиліта yt-dlp має бути в PATH). У таблиці налаштувань їх можна додавати, змінювати, клонувати, сортувати, шукати, експортувати та імпортувати.
Чотири способи запуску: підменю Швидкий запуск у треї, таблиця налаштувань (подвійний клік або Enter), необов'язкова глобальна комбінація на сценарій та Jump List панелі завдань — правий клік по значку CyrFlip на панелі завдань. Закріпіть CyrFlip на панелі завдань — і список буде під рукою, навіть коли програма не запущена: клік по завданню тоді виконує разовий запуск без старту трея.
Зберігання: по одному XML на сценарій у %APPDATA%\CyrFlip\Scenarios, формат сумісний з OneClickRunner. Вимкнення модуля очищає трей і Jump List, але файли залишаються до наступного ввімкнення.
Перенесення: під час першого ввімкнення CyrFlip запропонує скопіювати наявні сценарії OneClickRunner (%APPDATA%\OneClickRunner\Scenarios); вихідні файли ніколи не змінюються, а кнопка «Імпорт з OneClickRunner...» повторює перенесення будь-коли. .ps1 запускаються через PowerShell з разовим -ExecutionPolicy Bypass, .bat/.cmd — через cmd.exe; права адміністратора запитуються лише у сценаріїв з відповідною позначкою.

Переклад виділеного тексту (необов'язково)

Виділіть текст у будь-якому застосунку Windows, натисніть своє сполучення — і переклад з'явиться в невеликому вікні біля вказівника миші, дописуючись у міру того, як модель його пише. Працює через Ollama — безкоштовну програму, яку ви один раз встановлюєте на власний комп'ютер; CyrFlip її не містить, не має ні облікового запису, ні ключа. За замовчуванням модуль вимкнений: доки ви не ввімкнете його в «Налаштування → Переклад», жодне сполучення не зайняте, у треї нічого не додається, і CyrFlip не відкриває жодного мережевого з'єднання.

Напрямки — відкрита таблиця, як і перетворення розкладок: рядок це «перекладати цією мовою» плюс власне глобальне сполучення. У списку — усі мови, які знає Windows, а замість конкретної мови рядок може вказувати на «мову інтерфейсу» або «мову розкладки, активної у вікні призначення» — обидві визначаються в момент натискання. Які з цих мов подужає ваша модель, CyrFlip не обіцяє: охоплення мов — властивість моделі, а не наша, тому редактор рядка дає посилання на її опис. Ми надсилаємо текст, перекладає модель. Стартовий рядок отримує Ctrl+Shift+F9 (F12 — перетворення розкладок, F11 — виправлення регістру, F10 — менеджер буфера).
Результат можна класти в буфер обміну — і тоді необов'язкова історія буфера CyrFlip запише його, як і будь-яке інше копіювання, — або одразу вставляти замість виділення. Обидві опції типово вимкнені.
Куди йде текст. На адресу Ollama з налаштувань. Типово це http://localhost:11434, тобто ваш власний комп'ютер, і текст його не залишає; вкладка прямо попереджає, що інша адреса означає надсилання виділеного тексту на той комп'ютер. Розробникові чи в якусь хмарну службу не надсилається нічого.
Помічники на вкладці — по одній кнопці на дію: встановити Ollama, запустити його, перевірити зв'язок і завантажити модель. Рекомендовані моделі: aya-expanse:8b (~4,7 ГБ, типова - найкращий переклад із перевірених) та gemma2:9b (~5 ГБ). Моделі менші за 4 ГБ перевірки українською та російською не пройшли, тож gemma2:2b (~1,5 ГБ) лишається лише для машин, де мало місця, і помилятиметься. Пам'ять під модель тримає процес Ollama, а не CyrFlip — сам застосунок лишається в межах свого бюджету 50 МБ. У версії з Microsoft Store кнопка встановлення лише відкриває ollama.com: застосунок зі Store не має завантажувати й запускати сторонній інсталятор.

Чесно про обмеження: якість перекладу - це якість локальної моделі; перший переклад після холодного старту триває довше, бо модель спершу має завантажитися в пам'ять; сама Ollama разом із моделлю - це кілька гігабайтів, які ви завантажуєте один раз. З довгого виділення перекладаються перші 4000 символів, і вікно про це повідомляє.

Власне контекстне меню CyrFlip (необов'язково)

Усе, що CyrFlip уміє робити з виділенням, живе за гарячою клавішею. Цей модуль кладе ті самі команди на мишу: утримуйте Ctrl і клацніть правою кнопкою по виділенню — біля вказівника відкриється власне меню CyrFlip: «Копіювати / Вирізати / Вставити», далі ваші перетворення розкладок, виправлення регістру та рядки перекладу, далі «Швидкий запуск» і історія буфера, далі налаштування. Типово модуль вимкнений, і доки він вимкнений, мишачий хук узагалі не встановлюється: хук, що стоїть на шляху кожного руху миші в системі, не має існувати заради функції, якої ніхто не вмикав.

У сполученні завжди є модифікатор. Ви обираєте з фіксованого списку із шести варіантів — Ctrl, Shift або Alt із правою чи середньою кнопкою, — а не призначаєте будь-яке сполучення. Гола права кнопка відхиляється навмисно: інакше CyrFlip з'їдав би геть усі контекстні меню у Windows. Ctrl із правою кнопкою стоїть типово тому, що у Windows це сполучення нічим не зайняте: Shift із правою відібрав би у вас розширене меню Провідника, а середня кнопка — автопрокручування й відкриття посилання в новій вкладці.
Виділення не зникає. Меню ніколи не забирає фокус клавіатури, тож текст лишається виділеним під ним, і команда діє саме на те, що ви позначили.
Сірим, а не прихованим. Коли CyrFlip бачить, що нічого не виділено, команди, яким потрібне виділення, гаснуть. Коли визначити не вдається — а в деяких програмах це справді неможливо, — вони лишаються доступними: сіра команда поруч із живим виділенням гірша, а команда, що відпрацювала намарно, просто нічого не робить, як і всюди в CyrFlip.
Чому власне меню, а не пункт у чужому: сучасна програма — Electron, WinUI, WPF, Qt — малює меню сама, і додавати там нічого, а щоб дописати класичне, довелося б впроваджувати бібліотеку в кожен запущений процес. Це кінець «одного exe без залежностей» і автоматична відмова в Microsoft Store.

Модуль не читає текст і нічого не зберігає. Він стежить за своїм сполученням і, доки меню відкрите, за клацанням повз нього: меню, що належить фоновому процесу, не отримує клацання, яке має його закрити, тому CyrFlip закриває його сам.

Мови інтерфейсу

Інтерфейс доступний англійською, російською, українською, а також Deutsch, Italiano, Español, Français, Português, العربية, हिन्दी, বাংলা, اردو та 中文. Під час першого запуску береться мова інтерфейсу Windows, інакше English; для арабської та урду інтерфейс дзеркалиться справа наліво. Переклади мовами, якими автор не володіє, зроблені моделлю й не вичитані - виправлення вітаються на GitHub.

Крок 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 - користуйтеся разом

Переконайтеся, що застосунок CyrFlip запущений (значок у треї показує код розкладки).
Клацніть у редактор коду у VS Code і почніть друкувати. Перемкніть розкладку - кольоровий маркер EN/RU/UK слідує за кареткою, а в рядку стану видно ⌨ EN, ⌨ DE, ⌨ ZH - залежно від активної.
Скрізь в інших місцях (інші застосунки, діалоги, робочий стіл) маркер їде на курсорі-«балці» миші та на значку в треї - усе від того самого застосунку.
Набрали пів повідомлення не в тій розкладці, перш ніж глянути на екран? Виділіть і натисніть Ctrl+Shift+F12 - CyrFlip транслітерує на місці (QWERTY ↔ ЙЦУКЕН, EN ↔ RU). Кожен символ перемикається за скриптом, тому навіть змішаний EN + RU шедевр обробляється коректно. Працює в будь-якому застосунку, включно з VS Code.
Потрібна інша мовна пара? Це Ctrl+Shift+F12 — просто рядок EN ⇄ RU, з якого починається таблиця Перетворення розкладок: усі такі сполучення зібрані в цій одній таблиці. У Налаштування → Мови Windows встановіть однією кнопкою 13 популярних мов або додайте будь-яку розкладку Windows, а потім додайте рядок для потрібної пари. Кожен рядок має власне сполучення й власний вимикач, перетворення йде за фізичними клавішами й працює в обидва боки (натисніть те саме сполучення, коли активна цільова розкладка пари, — і текст перетвориться назад).
Випадково лишили CapsLock і отримали ПРИВІТ замість «Привіт»? Виділіть і натисніть Ctrl+Shift+F11 - CyrFlip поміняє ВЕЛИКІ ↔ малі літери на місці. Ця функція має власну налаштовувану гарячу клавішу, а необов'язковий перемикач Flip CapsLock after the flip ще й вимкне CapsLock, щоб ви друкували далі як зазвичай.

Коли CapsLock увімкнено, навколо маркера EN/RU/UK з'являється тонка рамка - на курсорі миші, біля каретки та на значку в треї, щоб стан CapsLock було видно прямо там, де ви друкуєте.

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

Поверхня	Хто показує	Де
Текстовий курсор миші (I-beam)	Застосунок	Усюди, де можна друкувати
Маркер поруч із кареткою	Застосунок	Класичні Win32 / UI-Automation поля
Маркер біля каретки редактора	Розширення	Редактори коду VS Code (точно)
Індикатор у рядку стану	Розширення	VS Code, у всьому вікні
Значок у треї	Застосунок	Завжди, в області сповіщень

Усередині 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 (фліп) або Ctrl+Shift+F11 (зміна регістру) не перехоплює інший інструмент. Будь-яку з них можна змінити в Налаштуваннях; там само змінюється гаряча клавіша історії (типово Ctrl+Shift+F10).
Не з'являється вікно перекладу. Переклад типово вимкнений - увімкніть його на вкладці Переклад. Далі там само перевірте, що Ollama встановлено й запущено (кнопка «Перевірити зв'язок») і що потрібну модель завантажено; типове сполучення рядка перекладу - Ctrl+Shift+F9.
Ніщо з переліченого не допомогло - напишіть автору. Налаштування → Про програму → Надіслати логи автору.. збирає власні логи CyrFlip і звіт про конфігурацію в один ZIP і відкриває лист на sza@ukr.net з цим вкладенням. Спершу ви бачите список файлів, архів залишається у вас на диску, історії буфера обміну в ньому немає ніколи, і нічого не надсилається, доки ви самі не натиснете «Надіслати» у своїй поштовій програмі. Якщо поштовий клієнт не приймає вкладення з посилання - вебпошта та новий Outlook не приймають - CyrFlip усе одно відкриє лист і виділить архів у проводнику, щоб його можна було перетягнути.