xmannv /
xkey
Ввод вьетнамского языка для macOS — open source решение для набора текста на macOS.
Форки
54
Звёзды
455
Issues
0
xkey — open source инструмент для ввода вьетнамского языка на macOS. Помогает внедрить поддержку локализации в приложения для вьетнамского рынка.
Что делает
xkey берет на себя рутину с раскладками клавиатуры для вьетнамского языка. Это нативный метод ввода, который работает прямо в системе macOS. Он избавляет пользователя от необходимости устанавливать закрытый проприетарный софт для корректного отображения символов.
Ты получаешь стабильный инструмент, который интегрируется в системные настройки ввода. Он работает прозрачно для других приложений. Это чистый open source, который можно изучить или доработать под свои нужды.
Как работает
Проект написан на Swift. Он использует системные API macOS для обработки ввода с клавиатуры и преобразования символов в нужные вьетнамские знаки. Инструмент перехватывает нажатия клавиш и применяет правила вьетнамской типографики до того, как текст попадет в текстовое поле.
Кому подходит
Разработчикам SaaS, которые планируют экспансию на вьетнамский рынок и хотят добавить поддержку локального языка.
Вайб-кодерам, которые собирают кастомные сборки macOS для локальных задач.
Пользователям, которым не хватает стандартных методов ввода в системе.
Энтузиастам, внедряющим open source решения вместо платных аналогов.
Основные возможности
Поддержка стандартов вьетнамского ввода на macOS.
Нативная интеграция с системными настройками клавиатуры.
Открытый исходный код для аудита и правок.
Минимальное потребление ресурсов системы.
Стабильная работа в актуальных версиях macOS.
Как установить
Для установки используй стандартные методы сборки Swift-проектов. Убедись, что на машине установлен Xcode или инструменты командной строки.
git clone https://github.com/xmannv/xkey
cd xkey
# Сборка проекта через Xcode или swift buildПосле сборки нужно добавить полученный bundle в системные настройки клавиатуры в разделе «Источники ввода».
Как применить в своём продукте
Если ты делаешь продукт для вьетнамского пользователя, xkey — отличный пример реализации нативного ввода. Ты можешь использовать его как референс для создания собственных методов ввода или локализации.
Интегрировать как часть кастомного дистрибутива системы для локального бизнеса.
Изучить реализацию на Swift для понимания работы с системными событиями клавиатуры.
Рекомендовать пользователям своего SaaS как проверенное open source решение.
Использовать код для создания плагинов к своим продуктам.
Внедрить поддержку языка без зависимости от платных проприетарных драйверов.
Подводные камни
Главная сложность — настройка системных прав доступа. macOS строго охраняет методы ввода, поэтому при установке нужно вручную разрешить использование стороннего источника в разделе «Конфиденциальность и безопасность». Также проект требует пересборки при значительных обновлениях macOS, если Apple меняет API ввода.
Частые вопросы
Нужно ли отключать стандартную клавиатуру?
Нет, xkey работает как дополнительный источник ввода. Ты можешь переключаться между ним и системной раскладкой через стандартное меню macOS или комбинацию клавиш.
Работает ли это на старых версиях macOS?
Зависит от версии Swift и системных API. Лучше проверять совместимость на конкретной версии системы, так как Apple часто меняет правила работы для методов ввода.
Можно ли изменить правила преобразования символов?
Да, так как это open source, ты можешь форкнуть репозиторий и изменить логику обработки нажатий клавиш в исходном коде на Swift.
Похожие репозитории
iinaIINA — это мощный видеоплеер для macOS на базе MPV. Идеальное решение, если нужно встроить качественный медиа-движок в свой проект или просто заменить стандартные плееры.
statsStats — это open source монитор ресурсов для macOS, который живет в строке меню. Показывает всё: от нагрузки на CPU до температуры датчиков и скорости сети.
UTMUTM запускает Windows, Linux и другие ОС на macOS и iOS. Это эмулятор для запуска полноценных виртуальных машин без необходимости джейлбрейка.
MonitorControlMonitorControl превращает любой сторонний монитор в нативный Apple Display. Управляй яркостью и звуком через клавиатуру Mac или шорткаты.
Данные обновлены: 3 июня 2026 г.