Releases: viethoavnm/LibreKey
Release list
LibreKey 1.2.0 — Loại trừ ứng dụng trên Windows
Đưa tính năng Loại trừ ứng dụng sang bản Windows.
Tải về
| Nền tảng | File | Cách dùng |
|---|---|---|
| macOS 10.13+ | LibreKey-1.2.0-macOS.zip |
Giải nén, kéo LibreKey.app vào /Applications |
| Windows | LibreKey-1.2.0-windows.zip |
Giải nén, chạy LibreKey64.exe (hoặc LibreKey32.exe cho máy 32-bit) |
⚠️ macOS: ký ad-hoc, chưa notarize. Lần mở đầu bị cảnh báo — chuột phải vào app → Open → Open lần nữa.
⚠️ Windows: build sạch trên GitHub Actions và đã kiểm tra chuỗi trực tiếp trong binary, nhưng chưa ai chạy thử trên máy Windows thật. Gặp lỗi xin mở issue.
Có gì mới
Loại trừ ứng dụng trên Windows
Tab thứ tư, nằm giữa "Hệ thống" và "Thông tin" — cùng vị trí với bản macOS. Danh sách tên file thực thi, nút Thêm ứng dụng... mở hộp thoại chọn .exe, nút Bỏ khỏi danh sách chỉ bật khi có dòng được chọn.
Trong ứng dụng bị loại trừ, phím đi thẳng qua — engine không đụng vào. Riêng phím tắt chuyển ngôn ngữ và chuyển mã vẫn dùng được vì đó là phím tắt toàn cục.
Nhận diện theo tên file .exe, không phân biệt hoa thường vì tên file Windows vốn vậy. Danh sách lưu trong registry, sửa xong có hiệu lực ngay không cần khởi động lại.
Sửa lỗi
- Thiếu
<commdlg.h>khiến hộp thoại chọn file không biên dịch được - Thông báo khởi động lại với quyền Admin còn sót tên OpenKey
Bản macOS
Không đổi so với 1.1.0, chỉ nâng số phiên bản cho khớp.
Lưu ý kỹ thuật
AppExclusionList bên Windows chưa có unit test — win32 không có test target, khác với bản macOS nơi logic tương đương có 16 test. Phần logic thuần đã tách khỏi UI và registry để sau này thêm test được.
Chi tiết: CHANGELOG.md
Toàn bộ engine tiếng Việt là công của Mai Vũ Tuyên (OpenKey, GPL v3), giữ nguyên không sửa một dòng. Nếu thấy có ích, xin ủng hộ tác giả gốc tại tuyenvm.github.io/donate.html.
LibreKey 1.1.0 — thêm bản Windows
Bổ sung bản Windows. Số phiên bản đồng nhất giữa hai nền tảng.
Tải về
| Nền tảng | File | Cách dùng |
|---|---|---|
| macOS 10.13+ | LibreKey-1.1.0-macOS.zip |
Giải nén, kéo LibreKey.app vào /Applications |
| Windows | LibreKey-1.1.0-windows.zip |
Giải nén, chạy LibreKey64.exe (hoặc LibreKey32.exe cho máy 32-bit) |
⚠️ macOS: bản này ký ad-hoc, chưa được Apple notarize. Lần mở đầu sẽ bị cảnh báo — chuột phải vào app → Open → Open lần nữa.
⚠️ Windows: build sạch trên GitHub Actions và đã kiểm tra chuỗi thương hiệu trực tiếp trong binary, nhưng chưa ai chạy thử trên máy Windows thật. Gặp lỗi xin mở issue.
Bản Windows có gì
Mã nguồn win32/ trước đây giữ nguyên của OpenKey. Bản này đưa nó về đúng thương hiệu LibreKey và port các bản vá đã làm ở macOS.
- Gỡ bỏ hoàn toàn kênh cập nhật tự động. Nó đọc manifest từ repo OpenKey, nên một bản LibreKey sẽ báo người dùng có "OpenKey mới" rồi rủ họ thay ứng dụng bằng sản phẩm khác.
- Đổi ba định danh hệ thống — window class, khoá registry và tên giá trị run-at-startup. Nếu giữ nguyên thì LibreKey và OpenKey sẽ chặn lẫn nhau không cho chạy, đúng loại lỗi mà fork này sinh ra để sửa.
- Sửa lỗi đúp từ trên Chromium: luôn bật thay vì ô tích beta mặc định tắt; nhận thêm Chromium, Vivaldi, Opera/GX, Cốc Cốc, Arc; thêm guard
backspaceCount > 0mà bản Windows thiếu, không có nó thì khi không cần xoá gì Shift+Left vẫn bôi đen một ký tự rồi bị ghi đè. - Hết lệch
_syncKeykhi gõ VNI / Unicode tổ hợp.
Bản Windows chưa có tính năng Loại trừ ứng dụng, và không có các bản vá đa người dùng vì Windows không có cơ chế tương tự.
Bản macOS
Không đổi so với 1.0.0, chỉ nâng số phiên bản cho khớp.
Chi tiết: CHANGELOG.md
Toàn bộ engine tiếng Việt là công của Mai Vũ Tuyên (OpenKey, GPL v3), giữ nguyên không sửa một dòng. Nếu thấy có ích, xin ủng hộ tác giả gốc tại tuyenvm.github.io/donate.html.
LibreKey 1.0.0
Bản phát hành đầu tiên của LibreKey, fork của OpenKey do Mai Vũ Tuyên viết, phát hành theo GPL v3.
Cài đặt
Tải LibreKey-1.0.0-macOS.zip, giải nén, kéo LibreKey.app vào /Applications, rồi bật LibreKey trong System Settings → Privacy & Security → Accessibility.
⚠️ Bản này ký ad-hoc, chưa được Apple notarize. Lần mở đầu tiên macOS sẽ báo không kiểm tra được mã độc. Cách mở: chuột phải vào app → Open → Open lần nữa; hoặc vào System Settings → Privacy & Security bấm Open Anyway.
Vì sao có bản fork này
Trên máy macOS nhiều tài khoản, OpenKey chỉ chạy được cho một người dùng duy nhất trên toàn máy — người đăng nhập sau không mở được ứng dụng và không nhận thông báo lỗi nào. Nguyên nhân là LSMultipleInstancesProhibited = true, cổng này áp cho toàn máy chứ không theo từng phiên đăng nhập.
Có gì trong bản này
Đa người dùng
- Thay cổng một-instance của LaunchServices bằng khoá
flock()riêng cho từng tài khoản - Khôi phục target login item đã bị xoá khỏi project, nên "khởi động cùng macOS" mới thật sự hoạt động
- Helper luôn tạo instance mới, không kích hoạt nhầm instance của tài khoản khác
- Sống sót qua Fast User Switching thay vì chết event tap vĩnh viễn
Tính năng mới
- Loại trừ ứng dụng — tab mới cho phép chọn những ứng dụng không gõ tiếng Việt. Phím đi thẳng qua, engine không đụng vào
Sửa lỗi đúp từ trên Chromium
- Nhận thêm Chromium, Chrome Beta/Dev/Canary, Vivaldi, Opera, Cốc Cốc, Arc
- Hết lệch
_syncKeykhi gõ VNI / Unicode tổ hợp
Khác
- Không tự thoát khi chưa được cấp quyền Accessibility
- Gỡ bỏ hoàn toàn kênh cập nhật tự động
- Thêm 38 unit test — kho gốc không có test nào
Chi tiết: CHANGELOG.md
Yêu cầu
macOS 10.13 trở lên · Universal (Apple Silicon + Intel)
Toàn bộ engine tiếng Việt là công của Mai Vũ Tuyên. Nếu thấy có ích, xin ủng hộ tác giả gốc.