Cài đặt JOKey

JOKey cần macOS 11 trở lên. Lệnh cài đặt gỡ mọi bản JOKey cũ (kể cả bản 1.x và cài đặt của nó) rồi cài bản mới nhất (v2.0.1). Chạy lại cùng lệnh này bất cứ lúc nào để cập nhật.

1. Mở Terminal

   Nhấn ⌘ Space, gõ Terminal rồi nhấn Return.

2. Dán và chạy lệnh cài đặt

   curl -sS https://afixer.app/jokey/install.sh | sh

   Nếu bạn dùng VPN (kể cả WARP), hãy tạm tắt khi cài. Muốn biết lệnh làm gì? Xem nội dung script cài đặt.

3. Kiểm tra

   Terminal sẽ in ra các bước như sau và kết thúc bằng Done:

   JOKey v2.0.1
   Download JOKey-2.0.1.zip
   Remove the old JOKey
   Install JOKey.app into Applications
   Install the JOKey keyboard and start JOKey
   Disable spelling autocorrect
   Done

   JOKey đã chạy. Lần đầu cài JOKey trên máy, hãy đăng xuất rồi đăng nhập lại một lần: macOS chỉ liệt kê bàn phím mới sau khi đăng nhập. Sau đó JOKey hiện hướng dẫn thêm bàn phím JOKey vào menu nhập liệu.

   

4. Thêm JOKey vào menu nhập liệu

   Bấm Mở cài đặt Bàn phím trong hộp thoại, hoặc mở System Settings › Keyboard. Ở mục Input Sources bấm Edit…, bấm +, chọn Vietnamese › JOKey rồi bấm Add.

   Không thấy JOKey trong danh sách? Đăng xuất rồi đăng nhập lại một lần (macOS chỉ liệt kê bàn phím mới sau khi đăng nhập), rồi thêm lại. Bạn chỉ cần thêm một lần: các bản cập nhật sau giữ nguyên.

   Từ giờ, chọn JOKey trong menu nhập liệu trên thanh menu để gõ tiếng Việt, chọn ABC để gõ tiếng Anh.

5. Cấp quyền Accessibility

   JOKey cần quyền Accessibility để gõ tiếng Việt. Khi JOKey hỏi, bấm Cấp quyền, chọn Open System Settings trong hộp thoại của macOS rồi bật công tắc cạnh JOKey. Hướng dẫn chi tiết

   Mỗi lần cập nhật, macOS hỏi lại quyền này vì JOKey có chữ ký mới.

Tiếp theo

• Mở JOKey từ Launchpad hoặc thư mục Applications để chọn Telex hay VNI và đổi các tuỳ chọn
• Đặt phím tắt chuyển giữa JOKey và ABC
• Loại trừ app khi viết code

Lưu ý

• Lệnh cài đặt tắt một số tính năng tự sửa chữ của macOS (tự sửa chính tả, tự viết hoa, gợi ý chữ, thay dấu ngoặc kép) vì chúng xung đột với bộ gõ.
• JOKey không kết nối mạng nên không tự cập nhật. Bấm Kiểm tra bản mới trong cửa sổ Cài đặt, hoặc theo dõi trang Facebook của JOKey để biết khi có phiên bản mới.
• JOKey không được Apple công chứng (notarize): lệnh cài đặt tự gỡ cờ quarantine của macOS trên JOKey.app. Tìm hiểu thêm
• Lệnh cài đặt không gửi bất kỳ thông tin nào về máy của bạn.

xattr -dr com.apple.quarantine ~/Applications/JOKey.app

~/Applications/JOKey.app/Contents/MacOS/JOKey install

curl -sS https://afixer.app/jokey/install.sh | V=1.0.0 sh

curl -sS https://afixer.app/jokey/install.sh | V=0.2.29 sh

Lịch sử cập nhật

1. v2.0.12026-10-16

   • sửa lỗi cài không được khi máy chưa có thư mục ~/Library/Keyboard Layouts
   • trình cài in ra lý do khi cài lỗi
   • lần đầu cài, JOKey nhắc đăng xuất rồi đăng nhập lại để macOS hiện bàn phím JOKey trong danh sách Input Sources

2. v2.0.02026-10-16

   • viết lại toàn bộ: bộ xử lý gõ mới viết bằng Rust, cửa sổ Cài đặt mới
   • JOKey giờ là bàn phím "JOKey" trong menu nhập liệu cùng app JOKey chạy nền: chữ hiện thẳng vào ô nhập, không gạch chân, không còn đảo hay mất chữ khi gõ nhanh trong Safari, Spotlight và các app WebKit
   • sau khi cài, thêm JOKey vào menu nhập liệu và cấp quyền Accessibility (bỏ chế độ gõ gạch chân)
   • sửa lỗi gợi ý của Spotlight làm "gõ" thành "goõ"
   • sửa lỗi phải chuyển sang tiếng Anh rồi chuyển lại mới gõ được sau khi đổi app
   • phím tắt có chữ cái như Shift + A trong Figma hoạt động bình thường
   • thêm tuỳ chọn phím ⌫ xoá cả ký tự
   • giữ nguyên chữ tiếng Anh có hai chữ cái liền nhau (affect, arrow, class) và chữ kéo dài khi chat (chưaaa, điii)
   • không gõ tiếng Việt trong các app điều khiển máy từ xa (iPhone Mirroring, Screen Sharing, Remote Desktop, ...)
   • chỉ xuất chữ Unicode: bỏ bảng mã VNI Windows và TCVN3
   • sửa lỗi rò rỉ bộ nhớ của bản 1.x
   • bỏ thời hạn sử dụng

3. v1.0.02024-03-30

   • phiên bản chính thức đầu tiên
   • thời hạn sử dụng 10 năm
   • thêm mã QR nhận donate trong giao diện Cài đặt

4. v0.2.292023-10-31

   • sửa lỗi không gõ được trên app Mail

5. v0.2.282023-09-28

   • sửa lỗi không gõ được trên Safari Web app
   • sửa lỗi không chọn được kiểu gõ VNI trên macOS 14
   • tự động bật lại bộ gõ sau khi rời app Parallels

6. v0.2.262023-08-28

   • sửa lỗi không bấm được tổ hợp phím tắt với phím Fn + [A ~ Z]

7. v0.2.252023-08-26

   • sửa lỗi gõ dấu kiểu VNI

8. v0.2.242023-07-12

   • sửa lỗi sai thứ tự chữ trên Safari

9. v0.2.232023-05-04

   • sửa lỗi lặp chữ trên thanh địa chỉ Chrome, Spotlight
   • sửa lỗi không lưu kiểu gõ Telex/VNI
   • cập nhật từ điển tiếng Việt

10. v0.2.222023-01-19

    • sửa lỗi nhấn phím chuyển ngôn ngữ nhanh (phím Fn 🌐)
    • sửa lỗi bị đứng máy khi tắt Accessibility
    • sửa lỗi không gõ được trên menu help Search

11. v0.2.212022-09-25

    • thêm menu Cập nhật
    • bổ sung các địa danh vùng tây nguyên vào từ điển tiếng Việt
    • nâng thời hạn thử nghiệm lên 6 tháng

12. v0.2.202022-07-01

    • sửa lỗi mất chữ khi gõ trên app Number, Pages

13. v0.2.19

    • thêm thời hạn thử nghiệm 3 tháng, dự kiến đây là bản thử nghiệm cuối cùng

14. v0.2.18

    • sửa lỗi bật tắt bộ gõ

15. v0.2.17

    • sửa lỗi hiển thị trạng thái Secure Input

16. v0.2.16

    • cải thiện xử lý đánh dấu
    • thêm thông báo khi Secure Input đang bật

17. v0.2.15~0.2.11

    • sửa lỗi bật tắt bộ gõ
    • sửa lỗi mất chữ

18. v0.2.10~0.2.9

    • tối ưu xử lý đánh dấu

19. v0.2.8~0.2.5

    • sửa lỗi khôi phục từ tiếng Anh

20. v0.2.4

    • sửa lỗi bật/tắt bộ gõ tự động