Handy
Mã nguồn mở bởi cjpais
Handy là ứng dụng desktop chuyển giọng nói thành văn bản, chạy hoàn toàn trên máy tính cá nhân (Windows, macOS, Linux) mà không gửi âm thanh lên đám mây. Bạn bấm phím tắt, nói, và chữ được dán vào ô nhập liệu của bất kỳ ứng dụng nào đang mở. Đây là app cài trên máy cá nhân, không phải dịch vụ chạy trên máy chủ.
Handy dùng để làm gì?
- Đọc chính tả vào bất kỳ ô nhập liệu nào bằng một phím tắt
- Chuyển giọng nói thành chữ ngay trên máy, không cần Internet sau khi đã tải mô hình
- Chọn mô hình nhận dạng Whisper (Small, Medium, Turbo, Large) hoặc Parakeet
- Điều khiển ghi âm từ dòng lệnh hoặc phím tắt của hệ điều hành bằng handy --toggle-transcription
- Tự thêm mô hình Whisper dạng GGML đã tinh chỉnh vào danh sách mô hình
Giao diện
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Cần biết trước khi dùng
- Nghiêm trọng1 lỗ hổng đã biết trong dependency khai báo, trong đó mức Cao/Nghiêm trọng: GHSA-mrhx-c7xc-m3w5 (zod@3.25.76, HIGH). Phiên bản lấy từ file khai báo nên có thể khác bản thật khi cài.
- Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
- Lưu ýTino chưa kiểm thử dự án này.
Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
Handy là gì?
Nhiều công cụ đọc chính tả gửi giọng nói lên máy chủ để xử lý. Handy làm việc này ngay trên máy: âm thanh không rời khỏi máy tính. Ứng dụng viết bằng Tauri (Rust), giấy phép MIT, chỉ tập trung vào một việc: chuyển lời nói thành chữ trong ô nhập liệu.
Cách dùng gồm bốn bước: giữ phím tắt để ghi (hoặc bấm một lần để bật, tắt), nói, thả phím, rồi Handy dán chữ vào ứng dụng đang dùng. Khoảng lặng được lọc bằng Silero VAD. Phần nhận dạng dùng mô hình Whisper (có tăng tốc GPU khi máy hỗ trợ) hoặc Parakeet V3, mô hình README mô tả là tối ưu cho CPU và tự nhận ngôn ngữ.
Ứng dụng cần quyền micro và quyền trợ năng (accessibility) để gõ chữ vào ứng dụng khác. Cách dán mặc định đi qua clipboard: Handy chép chữ vào clipboard, gửi phím dán rồi trả lại nội dung clipboard cũ. Trên Linux cần thêm công cụ gõ phím như xdotool (X11) hoặc wtype, dotool (Wayland).
Tên, logo và nhận diện thương hiệu Handy không thuộc giấy phép mã nguồn mở: bản fork phải dùng tên riêng.
Nên dùng khi
- Bạn gõ nhiều văn bản và muốn đọc chính tả thay vì gõ phím
- Bạn không muốn giọng nói, nội dung đọc chính tả bị gửi lên dịch vụ đám mây
- Bạn cần công cụ hỗ trợ tiếp cận (accessibility) miễn phí cho người khó dùng bàn phím
Không nên dùng khi
- Bạn cần chạy trên VPS hoặc máy chủ: Handy là app desktop cần micro và màn hình
- Bạn không muốn cấp quyền trợ năng: quyền này cho Handy gửi phím và dán chữ vào mọi ứng dụng
- Bạn dùng Linux Wayland mà không cài được wtype, dotool hoặc ydotool: hỗ trợ Wayland còn hạn chế
- Bạn cần nhận dạng tiếng Việt chắc chắn chính xác: README không nêu danh sách ngôn ngữ hỗ trợ
Tính năng chính
- Chạy offline, xử lý trên máy, không gửi âm thanh lên đám mây
- Mô hình Whisper Small, Medium, Turbo, Large có tăng tốc GPU; Parakeet V3 tối ưu cho CPU
- Lọc khoảng lặng bằng Silero VAD
- Ba kiểu phím tắt: giữ để ghi, bấm để bật tắt, hoặc kết hợp
- Cờ dòng lệnh: --toggle-transcription, --toggle-post-process, --cancel, --start-hidden, --no-tray
- Lịch sử bản chép, chế độ debug (Ctrl+Shift+D hoặc Cmd+Shift+D)
- Tự nhận mô hình Whisper GGML tuỳ chỉnh đặt trong thư mục models
- Bản phát hành có chữ ký, kiểm tra được bằng minisign
Cách cài đặt Handy
-
macOS: cài qua Homebrew
README lưu ý gói Homebrew không do nhóm phát triển Handy duy trì.
brew install --cask handy -
Windows: cài qua winget
Gói winget cũng không do nhóm phát triển Handy duy trì.
winget install cjpais.Handy -
Debian, Ubuntu: cài file .deb đã tải
Dùng apt để tự cài các gói phụ thuộc. Không dùng dpkg -i trừ khi phụ thuộc đã có; lỡ dùng rồi thì chạy sudo apt --fix-broken install.
sudo apt install ./Handy_*.deb -
Linux: cài công cụ gõ chữ
Dành cho X11. Wayland dùng sudo apt install wtype. Nếu báo thiếu libgtk-layer-shell.so.0 thì chạy sudo apt install libgtk-layer-shell0.
sudo apt install xdotool
Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
Cấu hình quan trọng
| Mục | Ý nghĩa |
|---|---|
HANDY_NO_GTK_LAYER_SHELL | Linux: đặt 1 để bỏ qua gtk-layer-shell khi app khởi động lỗi; lớp phủ ghi âm chuyển thành cửa sổ luôn nằm trên |
WEBKIT_DISABLE_DMABUF_RENDERER | Linux: 1 để tắt renderer DMA-BUF của WebKit (mặc định Handy đã tắt), 0 để bật lại khi lớp phủ bị nháy |
HANDY_KEEP_VULKAN_IMPLICIT_LAYERS | Windows: đặt 1 để giữ các implicit layer của Vulkan (mặc định bị bỏ qua để tránh crash do phần mềm overlay) |
Cách tích hợp và sử dụng
- Đọc chính tảĐặt con trỏ vào ô nhập liệu, giữ phím tắt và nói, thả ra để Handy chép và dán chữ vào.
- Chọn mô hìnhMở Settings → Models để tải và chọn mô hình. Mạng chặn tải tự động thì tải file mô hình bằng trình duyệt và đặt vào thư mục models trong thư mục dữ liệu của app, giữ nguyên tên file.
- Gán phím tắt trên WaylandTrên GNOME, KDE, Sway, Hyprland, tạo phím tắt tuỳ chỉnh với lệnh handy --toggle-transcription.
- Tự khởi động ẩnChạy handy --start-hidden --no-tray để mở cùng hệ thống mà không hiện cửa sổ và biểu tượng khay.
- Khi dán ra chữ cũ trong clipboardMở Debug bằng Ctrl+Shift+D (Cmd+Shift+D trên macOS), thử Reliable Paste (Beta) hoặc tăng Paste Delay (After).
Cập nhật và sao lưu
README không nêu quy trình cập nhật riêng; bản phát hành dùng định dạng chữ ký của trình cập nhật Tauri. Gói Homebrew, winget cập nhật qua trình quản lý gói tương ứng.
Dữ liệu và mô hình nằm trong thư mục dữ liệu của app: macOS ~/Library/Application Support/com.pais.handy/, Windows C:\Users\{username}\AppData\Roaming\com.pais.handy\, Linux ~/.config/com.pais.handy/.
Câu hỏi thường gặp
Handy có nhận tiếng Việt không?
README không nêu danh sách ngôn ngữ. Handy dùng mô hình Whisper, vốn là mô hình đa ngôn ngữ, nhưng độ chính xác với tiếng Việt cần tự thử. File Parakeet Unified EN trong README là bản tiếng Anh.
Có cần mạng Internet không?
Việc nhận dạng chạy trên máy. Mạng chỉ cần để tải ứng dụng và tải mô hình lần đầu; nếu mạng chặn, có thể tải file mô hình thủ công rồi đặt vào thư mục models.
Vì sao Handy đòi quyền trợ năng (accessibility)?
Để gửi phím dán và đưa chữ vào ứng dụng khác. Quyền này cho phép app điều khiển bàn phím ảo, nên chỉ cài bản tải từ trang Releases chính thức hoặc kiểm tra chữ ký.
Handy có miễn phí không?
Có. Handy là phần mềm mã nguồn mở giấy phép MIT. Riêng tên và logo Handy không thuộc giấy phép này.
Ứng dụng liên quan
Miễn trừ trách nhiệm
Tino không phát triển, không sở hữu và không liên kết với Handy hay nhóm phát triển cjpais. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
Handy được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.
