Bộ gõ tiếng Việt nhanh, nhẹ và chính xác cho macOS, powered by engine uvie-rs.

• Telex & VNI: đầy đủ hai kiểu gõ phổ biến.
• Clipboard history: lưu lịch sử copy, tự động tách đoạn theo delimiter (newline, comma, semicolon), giới hạn 1–99 entries.
• Đặt dấu thanh theo chuẩn mới: hoas → hoá (tùy chọn).
• Tự động viết hoa đầu câu sau .!? (tùy chọn).
• Nhớ ngôn ngữ theo app: tự động bật/tắt tiếng Việt cho từng ứng dụng.
• Tự động tắt khi detect bàn phím không Latin (Nhật, Hàn, Trung, Nga...).
• Macro: gõ tắt, ví dụ mk → mình không.
• Fn tap toggle: nhấn nhanh Fn để chuyển Anh/Việt.
• AX mode: hoạt động trong Spotlight và secure text fields.
• Không Dock icon: chỉ hiện trên menu bar.
• Always on top: cho phép bật/tắt chế độ luôn hiển thị trên các ứng dụng khác khi copy.

• macOS 13 Ventura trở lên
• Apple Silicon hoặc Intel (universal binary)

1. Tải UVieKey-*-universal.dmg từ Releases.
2. Mở DMG, kéo UVieKey.app vào thư mục Applications.
3. Mở app, cấp quyền Accessibility trong System Settings → Privacy & Security → Accessibility.
4. Icon uvie sẽ xuất hiện trên menu bar.

Nếu macOS chặn vì Gatekeeper: vào System Settings → Privacy & Security và chọn Open Anyway.

• Chuyển tiếng Việt: click icon menu bar hoặc nhấn Fn.
• Chọn kiểu gõ: Telex / VNI trong Preferences.
• Tạm dừng / thoát: click icon menu bar.

Requirements: Rust toolchain, Swift 5.9+, macOS SDK.

# Build Swift app (lần đầu sẽ tự động fetch uvie-rs prebuilt library)
./build.sh

# Chạy
.build/debug/UVieKey

Build từ source Rust local: set UVIE_RS_DIR trước khi chạy build.sh:

UVIE_RS_DIR=/path/to/uvie-rs ./build.sh

Build release + package:

# Build Swift app (universal)
swift build --configuration release --arch arm64
swift build --configuration release --arch x86_64
lipo -create .build/arm64-apple-macosx/release/UVieKey .build/x86_64-apple-macosx/release/UVieKey -output .build/release/UVieKey

# Bundle .app
APP="UVieKey.app"
mkdir -p "$APP/Contents/MacOS" "$APP/Contents/Resources"
cp Info.plist "$APP/Contents/Info.plist"
cp .build/release/UVieKey "$APP/Contents/MacOS/UVieKey"
chmod +x "$APP/Contents/MacOS/UVieKey"
cp AppIcon.icns "$APP/Contents/Resources/AppIcon.icns"

Workflow .github/workflows/release.yml tự động build universal binary, sign, notarize, tạo DMG, và draft release.

Secrets cần thiết:

UVieKey sử dụng engine uvie-rs — Rust library, no_std/no-alloc compatible, zero deps.

Xem chi tiết kiến trúc và benchmark trong README của uvie-rs.

MIT OR Apache-2.0