🌶️ Cay — Bộ gõ Telex Siêu Nhỏ Gọn Cho Coder

Cay là bộ gõ Telex "nhỏ mà có võ", được viết bằng C++ thuần túy dành riêng cho các lập trình viên hệ tối giản. Không rườm rà, không giật lag, sinh ra là để tối ưu hóa hiệu suất gõ và coding mượt mà nhất có thể.

Mở Terminal/PowerShell và dán dòng lệnh tương ứng để tự động tải, cài đặt và cấu hình khởi động cùng hệ thống trong nháy mắt:

🪟 Windows (Bản Minimal):

irm https://raw.githubusercontent.com/tctvn/cay/main/scripts/install-windows.ps1 | iex

🍏 macOS (Bản Minimal):

curl -sL https://raw.githubusercontent.com/tctvn/cay/main/scripts/install-mac.sh | bash

💡 Khám phá thêm: Để xem toàn bộ hướng dẫn cài đặt cũng như gỡ cài đặt cho tất cả các phiên bản (Bao gồm bản Windows Full cấu hình phím tắt/macro và Linux Fcitx5), vui lòng xem chi tiết tại tab cài đặt riêng: 👉 HƯỚNG DẪN CÀI ĐẶT & GỠ CÀI ĐẶT (INSTALL.md).

Nếu bạn không thích dùng script tự động, bạn có thể tải trực tiếp file chạy độc lập dưới đây:

• Windows: Chạy file cay.exe. Phím tắt mặc định chuyển đổi Anh/Việt là Ctrl + Shift.
• macOS: Giải nén cay-mac.zip và kéo cay.app vào Applications. Cấp quyền Accessibility. Phím tắt mặc định là Cmd + Shift.
• Android: Tải file cay-android.apk và mở cài đặt bình thường. Mở ứng dụng Cay vừa cài trên màn hình để cấp quyền kích hoạt bàn phím.

• Nguyên âm có dấu mũ/móc: aa = â, oo = ô, ee = ê, dd = đ, w = ă/ư/ơ.
• Quy tắc bỏ dấu thanh: s = sắc, f = huyền, r = hỏi, x = ngã, j = nặng, z = xoá dấu.
• Gõ nhanh móc: Gõ w sau tổ hợp phím (ví dụ: luuw -> lưu, huouw -> hươu) vô cùng tự nhiên.

• 🚀 Siêu Nhẹ (Zero-CRT): Viết bằng C++ thuần túy, dung lượng siêu nhỏ (~20KB - 40KB), gần như không tốn RAM (< 1.5MB). Không chạy nền dịch vụ rác.
• 🛠️ Tạm biệt lỗi nuốt chữ: Giải quyết triệt để lỗi mất ký tự hay nhảy con trỏ trên Chrome, VS Code, IntelliJ, v.v.
• 🧠 Smart Bypass & Auto Restore: Tự động nhận diện cụm từ tiếng Anh (camelCase, snake_case) để ngưng bỏ dấu. Đặc biệt hỗ trợ khôi phục lại từ tiếng Anh khi lỡ gõ sai (nhấn Space), bao trọn mọi kiểu gõ từ văn bản hành chính chuẩn mực cho đến teencode (ví dụ: trờiiiiiiiiiiiiiiii) mà không bị cản trở.
• 🚫 Direct Input (Không Preedit): Văn bản xuất hiện trực tiếp (không có nét gạch chân hay vùng nháp), không gây chớp giật màn hình khi gõ.
• ⚙️ Zero-Config: Tải về bật lên là sử dụng ngay. Bản mini tích hợp sẵn toàn bộ cấu hình tối ưu nhất.
• 🌐 Đa Nền Tảng: Hỗ trợ mượt mà Windows (10/11), macOS (Intel/Apple Silicon), Linux (Fcitx5) và Android.

Yêu cầu máy đã cài đặt CMake và compiler C++ (Visual Studio Build Tools / Xcode Command Line Tools).

# 1. Clone repo về máy
git clone https://github.com/tctvn/cay.git
cd cay

# 2. Tạo thư mục build và cấu hình dự án
cmake -B build

# 3. Tiến hành compile
cmake --build build --config Release

• Kết quả đầu ra:
  • Windows: File thực thi tối ưu nằm tại build/Release/cay.exe.
  • macOS: App bundle cực gọn nhẹ nằm tại build/cay.app.

⚠️ Lưu ý quan trọng về cảnh báo chống Virus giả (False Positive):
Do Cay hoạt động bằng cách chèn Keyboard Hook (bắt phím cấp hệ thống) để xử lý ký tự Telex theo thời gian thực, một số trình diệt virus có thể hiểu lầm đây là phần mềm keylogger độc hại.

Chúng tôi cam kết: Mã nguồn của Cay hoàn toàn mở 100%, cam đoan cực kỳ sạch sẽ, không lưu log bàn phím, không kết nối internet, không telemetry. Bạn hoàn toàn có thể tự kiểm tra source code và tự build nếu cần sự an tâm tuyệt đối.

Phát triển bởi tctvn.
Phân phối dưới giấy phép GPL-3.0 License. Mọi đóng góp PR hoặc Issue từ cộng đồng đều được chào đón nồng nhiệt! 🚀