🚀 Горячий релизSwift

PhamHungTien /

PHTV

PHTV — точный гибридный метод ввода вьетнамского языка. Универсальная и корректная раскладка для macOS.

Открыть на GitHub

Форки

Звёзды

146

Issues

PHTV — это нативный метод ввода вьетнамского языка для macOS. Он заменяет стандартные раскладки, предлагая более точный и быстрый ввод текста.

Что делает

PHTV решает проблему кривого ввода вьетнамского языка на маках. Стандартные инструменты часто ошибаются в расстановке знаков препинания или конфликтуют с горячими клавишами в рабочих программах. Этот проект — альтернатива, которая корректно обрабатывает специфические символы и диакритические знаки.

Он работает как системный input method. Ты ставишь его один раз, выбираешь в настройках macOS, и он перехватывает ввод во всех приложениях. Это дает предсказуемый результат без лишних движений.

Как работает

Инструмент написан на Swift и интегрируется с системным API ввода macOS. Он анализирует нажатия клавиш в реальном времени, применяя правила раскладок Telex или VNI для формирования вьетнамских символов. Программа работает в фоне, потребляя минимум ресурсов процессора и оперативной памяти.

Кому подходит

Разработчикам, которые живут в macOS и пишут на вьетнамском.

Владельцам локальных SaaS, ориентированных на вьетнамский рынок.

Тем, кому стандартный метод ввода мешает работать в IDE или редакторах.

Основные возможности

Поддержка стандартов Telex и VNI для ввода текста.

Высокая точность обработки диакритических знаков.

Нативная интеграция с macOS без потери производительности.

Стабильная работа в любых системных приложениях.

Гибкая настройка правил ввода для пользователя.

Как установить

Скачиваешь архив с последним релизом из GitHub, переносишь приложение в папку Applications и запускаешь его. После первого запуска нужно дать права в системных настройках macOS: «Системные настройки» -> «Клавиатура» -> «Источники ввода».

# Установка через терминал (если доступен бинарный пакет)
open PHTV.app

После этого добавь его в список доступных методов ввода через плюс в настройках клавиатуры.

Как применить в своём продукте

Если ты делаешь локальный софт для вьетнамского рынка, встроенный метод ввода — критическая фича. Ты можешь рекомендовать PHTV пользователям своего приложения, чтобы они не сталкивались с проблемами кодировки или неправильной обработки символов. Это повышает лояльность аудитории.

Добавь инструкцию по настройке PHTV в раздел FAQ своего продукта.

Используй его для тестирования корректности отображения вьетнамского в формах ввода.

Интегрируй похожие механики обработки текста, если создаешь свой текстовый редактор.

Подводные камни

Главная проблема — права доступа. macOS очень строго относится к приложениям, которые перехватывают ввод с клавиатуры. Если ты не дашь приложению права «Универсального доступа», оно просто не заработает. Также возможны конфликты с другими расширениями клавиатуры, если у тебя их установлено несколько одновременно.

Частые вопросы

Нужно ли удалять стандартную раскладку macOS?

Нет, удалять не обязательно. Просто добавь PHTV в список источников ввода и переключайся между ними через стандартную комбинацию клавиш. Так ты сможешь быстро вернуться к обычному вводу, если возникнет конфликт с какой-то специфической программой.

В каких версиях macOS это работает?

PHTV ориентирован на современные версии macOS. Если у тебя стоит старая система, могут возникнуть проблемы с системными API. Всегда проверяй требования в релизных заметках на GitHub перед обновлением системы.

Безопасно ли использовать этот метод ввода?

Это открытый код. Ты можешь просмотреть исходники в репозитории, чтобы убедиться, что программа не отправляет твои нажатия клавиш на сторонние сервера. Это стандартная практика для инструментов ввода.

Топики

gotiengviet input-method macos macosinput phtv swift telex vietnamese vni