Skip to content
Bryal52Public

About

Text expander like Espanso, with global variables shared by all snippets (macOS + Windows, C++/Qt6)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Typix

Typix

Замена текста по триггерам для macOS и Windows — как Espanso, но с глобальными переменными
набрали :sig — получили подпись · одно значение в globals.yml — во всех шаблонах сразу

macOS 13+ Windows 10 / 11 C++20 Qt 6 Конфиг YAML как в Espanso Версия 1.0.0

Скачать для macOS   Скачать для Windows

Windows без установки (zip) · English

Поиск по шаблонам


✨ О программе

Typix живёт в строке меню (на Windows — в трее) и следит за тем, что вы печатаете. Набрали триггер — например :sig — и он тут же превращается в нужный текст: подпись, адрес, шаблон баг-репорта, сегодняшнюю дату. Работает в любой программе: в браузере, мессенджере, Jira, почте, редакторе кода.

Формат конфига — тот же, что у Espanso, поэтому переезд занимает минуту. Но есть то, чего Espanso не умеет.

🌍 Глобальные переменные — главное отличие

В Espanso одно и то же значение (версия приложения, телефон, модель устройства) приходится вписывать в каждый шаблон. Вышла новая версия — правите весь файл и обязательно что-нибудь пропускаете.

В Typix значение пишется один раз в globals.yml:

# globals.yml
version: "2.5.0 (100)"
device: "iPhone 16 Pro"
name: "Иван Петров"
signature: "{{name}}, QA"        # переменные могут ссылаться друг на друга

today:
  type: date
  params:
    format: "%d.%m.%Y"

…и подставляется во все шаблоны через {{имя}}:

# match/base.yml
matches:
  - trigger: ":bug"
    replace: |
      Версия приложения: {{version}}
      Устройство: {{device}}
      Дата: {{today}}
      {{signature}}

Поменяли version и сохранили файл — Typix сам перечитал конфиг, и все шаблоны уже с новой версией.

🚀 Возможности

⌨️ Триггеры как в Espanso

trigger и triggers, word (срабатывает только целым словом), propagate_case (:Sig → «С уважением», :SIG → «С УВАЖЕНИЕМ»), регулярные выражения с именованными группами, $|$ — где оставить курсор после вставки.

🧩 Один триггер — несколько вариантов

Несколько шаблонов с одинаковым триггером показывают аккуратный список: стрелками выбрали, Enter — вставили.

Выбор варианта для :bug

🔎 Поиск по всем шаблонам — ⌥Space / Alt+Space

Забыли триггер — откройте поиск и найдите шаблон по тексту.

🧮 Переменные всех типов Espanso

Тип Что подставляет
echo текст (в globals.yml достаточно имя: значение)
date дату и время в любом формате, со сдвигом и языком
shell / script вывод команды или скрипта
clipboard содержимое буфера обмена
random случайный вариант из списка
choice вариант, выбранный в списке
match результат другого шаблона

📋 Бережно с буфером обмена

Короткие тексты печатаются, длинные вставляются через буфер обмена — а ваше содержимое буфера потом возвращается на место. На Windows вставленный текст ещё и не попадает в историю буфера (Win+V).

↩️ Backspace отменяет

Нажали Backspace сразу после замены — вернётся набранный триггер.

🔄 Конфиг перечитывается сам

Сохранили файл — изменения уже работают. Если в YAML ошибка, Typix покажет файл и строку в меню, а всё остальное продолжит работать.

🪟 Настройки под программы

config/<имя>.yml с filter_class, filter_exec или filter_title — свои настройки для отдельной программы, например вставка только через буфер в терминале.

📁 Где лежит конфиг

macOS ~/Library/Application Support/Typix/
Windows %APPDATA%\Typix\
Файл Что в нём
globals.yml глобальные переменные
match/*.yml шаблоны (matches, imports, global_vars)
config/default.yml настройки: backend, clipboard_threshold, search_shortcut, toggle_key, undo_backspace …

Все пункты — в меню Typix: «Глобальные переменные…», «Шаблоны…», «Настройки…».

🔁 Переезд с Espanso

Скопируйте папки config и match из конфига Espanso в папку Typix — и всё заработает как было. Затем вынесите повторяющиеся значения в globals.yml и замените их в шаблонах на {{имя}}.

Отличия: global_vars из любого файла видны во всех файлах (в Espanso — только в своём), а form пока не поддерживается — вместо неё есть choice.

📥 Установка

macOS — откройте Typix-1.0.0.dmg и перетащите Typix в «Программы». При первом запуске macOS попросит доступ: Системные настройки → Конфиденциальность и безопасность → Универсальный доступ → Typix. Без него Typix не видит набранные триггеры. Перезапуск после выдачи доступа не нужен.

Windows — запустите Typix-1.0.0-Setup.exe (права администратора не нужны) или распакуйте portable zip.

Typix сам добавляется в автозапуск; выключить можно в меню — «Запускать при входе».

🛠 Сборка из исходников

./build.sh      # macOS: тесты, Typix.app в /Applications и dist/Typix-<версия>.dmg

Windows собирается в GitHub Actions: MSYS2, Qt 6, Inno Setup (.github/workflows/windows.yml).

Проверить конфиг без запуска:

Typix --check                  # ошибки и сколько шаблонов и переменных прочитано
Typix --render :sig            # что вставит триггер

C++20 · Qt 6 · yaml-cpp. Ядро (конфиг, триггеры, переменные) общее для обеих систем, отдельно только работа с клавиатурой.

☕ Поддержать автора

Котик

Typix бесплатный и таким останется. Если хочется угостить автора кофе — в меню Typix есть пункт «Поддержать автора ☕». Спасибо!



🇬🇧 English

Typix is a text expander for macOS and Windows that reads Espanso's config format — plus global variables. Write a value once in globals.yml (version: "2.5.0") and every snippet in every file gets it through {{version}}. Change it once, save, done: Typix reloads by itself.

  • Espanso-style snippets: trigger/triggers, word, propagate_case, regex triggers, $|$ cursor, imports, app-specific configs (filter_class, filter_exec, filter_title).
  • All Espanso variable types: echo, date, shell, script, clipboard, random, choice, match. Globals may refer to each other.
  • Several snippets with one trigger open a small picker; Alt+Space searches all snippets.
  • Long texts are pasted through the clipboard, and your clipboard is restored afterwards; Backspace right after an expansion brings the trigger back.
  • Config: ~/Library/Application Support/Typix on macOS, %APPDATA%\Typix on Windows. Menu and messages in Russian and English.
  • macOS needs the Accessibility permission (System Settings → Privacy & Security → Accessibility → Typix).

Built with C++20, Qt 6 and yaml-cpp. Donations are completely optional — Typix is free and always will be.

About

Text expander like Espanso, with global variables shared by all snippets (macOS + Windows, C++/Qt6)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages