# Handy: gõ chữ bằng giọng nói, chạy offline, miễn phí — hướng dẫn cài đặt và dùng

> Handy là ứng dụng chuyển giọng nói thành văn bản chạy ngay trên máy bạn, không gửi âm thanh lên đám mây. Bạn nhấn một phím tắt, nói, rồi chữ được dán vào bất kỳ ô nhập liệu nào. Cài đặt khá dễ vì có sẵn bản cài cho Windows, macOS và Linux, không cần biết lập trình.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-25 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/handy-nhap-van-ban-bang-giong-noi-offline-mien-phi-2

Handy là ứng dụng máy tính miễn phí, mã nguồn mở, giúp bạn gõ chữ bằng giọng nói và chạy hoàn toàn offline. Bạn nhấn một phím tắt, nói, rồi lời nói được chuyển thành chữ và dán thẳng vào ứng dụng đang mở: Word, trình duyệt, ô chat, email, trình soạn code… Toàn bộ xử lý diễn ra trên máy bạn, âm thanh không bị gửi lên đám mây.

Repo này hợp với người hay phải gõ nhiều: chủ shop trả lời khách, nhân viên văn phòng soạn email, người viết nội dung, lập trình viên mới muốn ghi chú nhanh. Cũng hợp với người gõ phím khó khăn, vì tác giả định hướng đây là công cụ hỗ trợ tiếp cận cho mọi người. Hiện repo có khoảng 38.600 sao và 3.637 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất là sự đơn giản: một công cụ, một việc. Không tài khoản, không thuê bao, không phải hiểu AI. Bạn cài như cài phần mềm thông thường rồi dùng. Xem video ngắn bên dưới để thấy nó chạy thực tế trước khi cài.

```repo
- repo | cjpais/Handy
- kind | Ứng dụng
- desc | Handy là ứng dụng máy tính miễn phí, mã nguồn mở: nhấn phím tắt, nói, chữ hiện vào ô nhập liệu. Chạy hoàn toàn offline trên Windows, macOS, Linux.
- stars | 39k
- lang | Rust
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/w_qheLCJTMU
- facebook | https://www.facebook.com/reel/1941098703715792
- title | Video giới thiệu Handy
```

## Handy làm được gì

Dưới đây là những tính năng chính, kèm lợi ích bạn nhận được trong công việc hằng ngày.

- **Chuyển giọng nói thành chữ ngay trên máy.** Âm thanh được xử lý cục bộ, nên bạn đọc nội dung nhạy cảm (hợp đồng, thông tin khách hàng) mà không lo bị gửi đi đâu.
- **Dán chữ vào bất kỳ ô nhập liệu nào.** Bạn không cần mở một cửa sổ riêng rồi copy qua lại. Con trỏ đang ở đâu, chữ vào đó.
- **Phím tắt tuỳ chỉnh với nhiều kiểu bấm.** Bạn có thể giữ phím để ghi âm rồi thả ra để dừng, hoặc bấm một lần để bật và bấm lần nữa để tắt. README cũng nói có chế độ chỉ-giữ và chế độ chỉ-bật-tắt.
- **Lọc khoảng lặng.** Handy dùng VAD (nhận diện có tiếng nói hay không) với Silero, nên những đoạn im lặng không bị xử lý vô ích.
- **Chọn mô hình nhận diện.** Có các mô hình Whisper (Small, Medium, Turbo, Large), tận dụng GPU nếu máy có. Ngoài ra có Parakeet V3, mô hình tối ưu cho CPU, tự nhận diện ngôn ngữ. Máy yếu không có card đồ hoạ vẫn có lựa chọn.
- **Lịch sử bản ghi.** README nhắc đến mục History, nơi xem lại các đoạn đã chuyển thành chữ. Hữu ích khi chữ dán sai chỗ mà bạn muốn lấy lại.
- **Điều khiển bằng dòng lệnh.** Bạn có thể bật/tắt ghi âm từ bên ngoài bằng cờ lệnh, rất tiện để gán vào phím tắt của hệ điều hành hoặc công cụ khác. README tự ghi mục này phần lớn còn ở giai đoạn thử nghiệm (beta).
- **Hook xử lý chữ trước khi dán.** Người dùng nâng cao trên macOS và Linux có thể gắn một script để sửa chữ ngay trước khi dán, ví dụ thêm tiền tố hay đổi chữ theo ứng dụng đang mở.
- **Tích hợp Raycast.** README liệt kê một tiện ích Raycast do người ngoài làm, để bật/tắt ghi âm, xem lịch sử, quản lý từ điển, đổi mô hình và ngôn ngữ.

## Cần chuẩn bị gì

Tư liệu của repo nói khá ít về yêu cầu phần cứng, nên mình chỉ nêu những gì có trong README:

- **Hệ điều hành:** Windows, macOS hoặc Linux.
- **Micro:** Bạn cần cho Handy quyền dùng micro khi mở lần đầu.
- **Quyền trợ năng (accessibility):** README cũng yêu cầu cấp quyền này để Handy dán chữ vào ứng dụng khác.
- **GPU:** Không bắt buộc. README nói các mô hình Whisper tận dụng GPU khi có, còn Parakeet V3 được tối ưu cho CPU.
- **Tài khoản / API key:** README không nhắc tới tài khoản hay key nào để dùng chức năng chính.
- **Linux:** nên cài thêm công cụ nhập chữ phù hợp (xdotool, wtype hoặc dotool), chi tiết ở phần cài đặt.

README không ghi dung lượng ổ đĩa, dung lượng RAM tối thiểu hay phiên bản hệ điều hành cụ thể. Nếu bạn cần các thông tin đó, hãy xem trang chủ handy.computer hoặc mục Issues của repo.

## Cài đặt từng bước

Bạn không cần Node, Rust hay biên dịch gì cả nếu chỉ muốn dùng. Chỉ người muốn tự build từ mã nguồn mới cần đọc BUILD.md.

```steps
- Tải bản cài | Vào trang releases hoặc handy.computer, tải bản cho hệ điều hành của bạn
- Cài ứng dụng | Chạy file vừa tải (hoặc dùng Homebrew, winget, apt)
- Mở Handy, cấp quyền | Cho phép micro và trợ năng
- Đặt phím tắt | Vào Settings chọn tổ hợp phím bạn thích
- Thử nói | Đặt con trỏ vào một ô chữ, nhấn phím tắt và nói
```

### Tải bản cài

Cách chắc chắn nhất: vào trang releases của repo (github.com/cjpais/Handy/releases) hoặc trang chủ handy.computer, tải bản mới nhất dành cho hệ điều hành của bạn. Sau đó chạy file vừa tải như mọi phần mềm khác.

### Cài bằng trình quản lý gói (tuỳ chọn)

Nếu quen dùng terminal, README có hai lối tắt. Lưu ý chính README ghi: gói Homebrew và winget **không do nhóm Handy duy trì**, nên nếu muốn chắc chắn thì hãy tải trực tiếp từ trang releases.

Trên macOS (mở ứng dụng Terminal):

```bash
brew install --cask handy
```

Trên Windows (mở PowerShell hoặc Terminal):

```powershell
winget install cjpais.Handy
```

### Cài trên Debian/Ubuntu

Với file `.deb` đã tải, README khuyên dùng APT để các thư viện cần thiết được cài theo. Hãy mở terminal ở thư mục chứa file đã tải rồi chạy:

```bash
sudo apt install ./Handy_*.deb
```

Đừng dùng `dpkg -i` trừ khi bạn đã có sẵn các thư viện phụ thuộc. Nếu lỡ dùng rồi và bị lỗi, README bảo chạy:

```bash
sudo apt --fix-broken install
```

### Công cụ nhập chữ trên Linux

Trên Linux, để chữ được dán ổn định, README khuyên cài thêm công cụ tuỳ theo màn hình bạn đang dùng:

```bash
sudo apt install xdotool   # X11
sudo apt install wtype     # Wayland
sudo apt install dotool    # Cả hai (cần thuộc nhóm input)
```

Nếu chọn dotool, bạn phải thêm tài khoản vào nhóm `input` rồi đăng xuất, đăng nhập lại:

```bash
sudo usermod -aG input $USER
```

Nếu không cài các công cụ trên, Handy dùng phương án dự phòng là enigo, nhưng README cảnh báo có thể kém tương thích, nhất là trên Wayland.

### Mở Handy và cấp quyền

Mở Handy lần đầu, hệ điều hành sẽ hỏi quyền micro và quyền trợ năng. Hãy bấm đồng ý. Nếu lỡ từ chối, bạn phải vào phần cài đặt quyền riêng tư của hệ điều hành để bật lại, nếu không Handy sẽ không nghe hoặc không dán được chữ.

### Đặt phím tắt

Vào Settings trong Handy, chọn phím tắt bạn thích. Chọn kiểu giữ-để-nói hoặc bấm-bật-bấm-tắt tuỳ thói quen.

```note
Nếu bạn dùng macOS và chọn phím tắt có phím fn (Globe), nó chỉ hoạt động với bàn phím của Apple. Bàn phím hãng khác sẽ không kích hoạt được. Hãy chọn tổ hợp ctrl, option, shift hoặc command nếu hay đổi bàn phím.
```

### Muốn tự build từ mã nguồn?

README chỉ ghi: xem BUILD.md trong repo để biết hướng dẫn chi tiết theo từng hệ điều hành. Phần này dành cho lập trình viên, người dùng bình thường không cần.

## Kiểm tra đã chạy được chưa

Cách thử đơn giản nhất làm theo đúng luồng README mô tả:

1. Mở Notepad, Word, ô tìm kiếm trình duyệt hoặc bất kỳ ô nhập chữ nào, đặt con trỏ vào đó.
2. Nhấn phím tắt bạn đã đặt, nói một câu ngắn, rồi thả phím (hoặc bấm lần nữa nếu dùng kiểu bật-tắt).
3. Chờ một chút. Nếu chữ hiện ra trong ô nhập liệu, bạn đã cài thành công.

Nếu chữ không hiện nhưng bạn thấy nó nằm trong mục **History** của Handy, nghĩa là nhận diện đã chạy được, chỉ có khâu dán chữ đang vướng. Xem phần lỗi thường gặp bên dưới.

Nếu muốn thử bằng dòng lệnh, README có lệnh bật/tắt ghi âm trên một Handy đang chạy:

```bash
handy --toggle-transcription
```

Lệnh `handy --help` sẽ liệt kê mọi cờ có sẵn.

## Dùng vào việc thật

### Chủ shop trả lời tin nhắn khách

Bạn bán hàng online, ngày nào cũng gõ hàng chục câu trả lời. Thay vì gõ, bạn đặt con trỏ vào ô chat, giữ phím tắt và đọc câu trả lời: “Dạ chị, mẫu này còn size M, em gửi trong hôm nay ạ”. Thả phím, chữ hiện vào ô chat để bạn đọc lại rồi gửi. Bạn nên đọc kỹ trước khi gửi vì chữ nhận diện có thể sai tên riêng hoặc từ chuyên ngành.

### Nhân viên văn phòng soạn email và biên bản

Bạn vừa họp xong và cần ghi lại ý chính. Mở email nháp hoặc Word, bật chế độ bấm-bật-bấm-tắt, nói liền mạch vài đoạn, bấm tắt. Chữ được dán vào văn bản để bạn chỉnh sửa. Vì mọi thứ chạy trên máy, bạn không phải lo nội dung họp bị tải lên dịch vụ bên ngoài. Muốn đổi mô hình cho chính xác hơn hay nhanh hơn, bạn thử các lựa chọn Whisper hoặc Parakeet V3 trong cài đặt.

> Một công cụ, một việc: nói xong là chữ nằm đúng chỗ con trỏ, không phải copy qua lại.
>
> — Ông T

### Lập trình viên dùng trên Linux hoặc kết hợp phím tắt hệ thống

Bạn dùng Linux với Wayland, nơi phím tắt toàn cục phải do môi trường desktop quản lý. README hướng dẫn gán lệnh `handy --toggle-transcription` vào phím tắt tuỳ chỉnh. Với Sway hoặc i3, thêm dòng này vào file cấu hình (`~/.config/sway/config` hoặc `~/.config/i3/config`):

```ini
bindsym $mod+o exec handy --toggle-transcription
```

Với GNOME, vào Settings > Keyboard > Keyboard Shortcuts > Custom Shortcuts, bấm dấu **+**, đặt tên, điền lệnh `handy --toggle-transcription` và gán tổ hợp phím. KDE Plasma và Hyprland cũng có cách cấu hình tương tự trong README. Kết quả là bạn bấm phím tắt của hệ thống và Handy bắt đầu ghi âm.

### Người dùng macOS muốn tự động sửa chữ trước khi dán

Bạn là người dùng nâng cao, muốn khi đang ở Terminal thì chữ nói ra tự có tiền tố `#` (để làm ghi chú). README có ví dụ hook: đặt một file chạy được tên `transcription` vào thư mục `hooks` trong thư mục dữ liệu của Handy. Handy đưa chữ vào đầu vào chuẩn của script, rồi dán kết quả script in ra. Nếu script lỗi hoặc chạy quá 30 giây, chữ gốc vẫn được dán.

```bash
mkdir -p ~/Library/Application\ Support/com.pais.handy/hooks
cd ~/Library/Application\ Support/com.pais.handy/hooks
cat > transcription << 'EOF'
#!/bin/bash
app=$(osascript -e 'tell application "System Events" to get name of first application process whose frontmost is true')
if [ "$app" = "Terminal" ]; then echo "# $(cat)"; else cat; fi
EOF
chmod +x transcription
```

Các lệnh trên tạo thư mục hooks, tạo file script, rồi cấp quyền chạy cho nó. Lưu ý hook không nhận biến `PATH` của shell của bạn, nên nếu gọi chương trình khác phải ghi đường dẫn đầy đủ (ví dụ `/opt/homebrew/bin/opencc`). Trên Linux, thư mục dữ liệu là `~/.local/share/com.pais.handy/`.

## Lỗi hay gặp và cách xử lý

### Chữ dán ra là nội dung bạn copy trước đó

Chữ đúng trong History nhưng ô nhập lại hiện nội dung clipboard cũ. README nói đây là vấn đề đã biết (issue #502): Handy khôi phục clipboard sau một khoảng trễ cố định, máy bận thì ứng dụng đích đọc clipboard sau khi đã bị khôi phục. Cách xử lý theo README:

1. Mở cửa sổ cài đặt Handy, nhấn `Cmd+Shift+D` (macOS) hoặc `Ctrl+Shift+D` (Windows/Linux) để hiện mục **Debug**.
2. Trên macOS và Windows, thử bật **Reliable Paste (Beta)** (cần chọn kiểu dán bằng clipboard). Đây vẫn là tính năng thử nghiệm, bạn nên kiểm tra trong chính ứng dụng đang gặp lỗi.
3. Nếu không dùng được, tăng **Paste Delay (After)** rồi thử lại.

### Linux: chữ không dán được hoặc dán sai cửa sổ

Trên Linux, nguyên nhân thường là thiếu công cụ nhập chữ hoặc do cửa sổ overlay ghi âm cướp mất tiêu điểm. Cài `xdotool` (X11) hoặc `wtype`/`dotool` (Wayland). Rồi vào **Settings > Advanced**, đặt **Overlay Position** thành **None**. Nếu vẫn muốn có báo hiệu, bật **Audio Feedback** trong cùng mục.

### Linux: mở ứng dụng bị báo thiếu thư viện

Nếu thấy lỗi `error while loading shared libraries: libgtk-layer-shell.so.0`, cài gói runtime tương ứng. Ubuntu/Debian:

```bash
sudo apt install libgtk-layer-shell0
```

Fedora/RHEL dùng `sudo dnf install gtk-layer-shell`, Arch Linux dùng `sudo pacman -S gtk-layer-shell`.

### Phím tắt có phím fn không phản hồi (macOS)

Đây không phải lỗi của Handy. Phím fn chỉ được macOS nhận từ bàn phím Apple. Hãy đổi sang tổ hợp dùng các phím chuẩn như ctrl, option, shift, command.

### Dùng tai nghe Bluetooth thì tiếng nhỏ đi khi ghi âm (macOS)

Tai nghe Bluetooth chuyển sang chế độ hai chiều khi ghi âm nên chất lượng phát có thể giảm. README khuyên giữ tai nghe làm thiết bị phát, nhưng chọn micro trong của Mac hoặc micro ngoài làm thiết bị thu trong Handy.

## Có nên dùng không

**Điểm mạnh:** miễn phí, mã nguồn mở (MIT), chạy offline nên riêng tư, dùng được trên ba hệ điều hành, cài như phần mềm thường, có nhiều lựa chọn mô hình cho cả máy có và không có GPU. Cộng đồng khá lớn nên lỗi thường được ghi nhận công khai trên trang Issues.

**Giới hạn:** chính README thừa nhận dự án đang phát triển tích cực và còn nhiều vấn đề đã biết. Linux, nhất là Wayland, hỗ trợ còn hạn chế và cần cài thêm công cụ. Việc dán chữ qua clipboard có thể trục trặc ở một số ứng dụng. Các cờ dòng lệnh phần lớn còn là beta. Hook chỉ dành cho macOS và Linux. README đoạn mình có không nêu độ chính xác theo từng ngôn ngữ, nên bạn nên tự thử bằng tiếng Việt với giọng của mình trước khi dựa vào nó cho công việc quan trọng.

**Khi nào chọn cách khác:** nếu bạn cần phiên âm file ghi âm dài hoặc tách người nói trong cuộc họp, Handy không được mô tả cho việc đó, vì nó thiết kế để gõ chữ vào ô nhập liệu. Nếu bạn chấp nhận gửi âm thanh lên đám mây để đổi lấy tính năng khác, hãy so sánh thêm các dịch vụ trực tuyến. Còn nếu bạn chỉ muốn nói và có chữ trên máy mình, riêng tư và không tốn tiền, Handy là lựa chọn đáng thử trước.

## Câu hỏi thường gặp

### Handy có miễn phí không?

Có. README ghi rõ Handy là ứng dụng miễn phí và mã nguồn mở, giấy phép MIT. Mục tiêu tác giả nêu là công cụ hỗ trợ tiếp cận không nên nằm sau một bức tường trả phí.

### Handy có cần internet và có gửi giọng nói của tôi lên đám mây không?

Theo README, quá trình xử lý diễn ra hoàn toàn trên máy bạn và không gửi âm thanh lên đám mây. README mô tả ứng dụng là chạy offline. Phần cách tải mô hình về lần đầu, README có nhắc mục cài mô hình thủ công cho người dùng proxy hoặc mạng hạn chế, nhưng đoạn đó bị cắt nên mình chưa có chi tiết.

### Máy tôi không có card đồ hoạ (GPU) thì dùng được không?

Được. README nói các mô hình Whisper tận dụng GPU khi có, còn Parakeet V3 là mô hình tối ưu cho CPU và tự nhận diện ngôn ngữ. Tư liệu chưa nêu yêu cầu cấu hình tối thiểu cụ thể.

### Handy chạy được trên Windows không?

Có. Handy chạy trên Windows, macOS và Linux. Trên Windows bạn có thể tải bản cài từ trang releases hoặc dùng lệnh winget install cjpais.Handy, nhưng gói winget không do nhóm Handy duy trì.

### Handy có nhận diện được tiếng Việt không?

Tư liệu mình có không nêu danh sách ngôn ngữ được hỗ trợ hay độ chính xác theo từng ngôn ngữ. README chỉ nói Parakeet V3 tự nhận diện ngôn ngữ và Raycast có thể đổi ngôn ngữ. Bạn nên tự thử với giọng của mình, hoặc xem trang chủ handy.computer.

### Tại sao Handy không dán được chữ vào ứng dụng của tôi?

Có vài nguyên nhân thường gặp: chưa cấp quyền trợ năng, dán qua clipboard bị khôi phục quá sớm, hoặc trên Linux thiếu xdotool/wtype/dotool hay bị overlay cướp tiêu điểm. README có mục xử lý từng trường hợp, như bật Reliable Paste hoặc tăng Paste Delay trong Debug, và đặt Overlay Position thành None trên Linux.

### Handy khác gì các dịch vụ gõ bằng giọng nói trực tuyến?

Điểm khác chính theo README là Handy chạy cục bộ, miễn phí và mã nguồn mở, trong khi dịch vụ trực tuyến thường xử lý âm thanh trên máy chủ. Tư liệu không so sánh trực tiếp về độ chính xác hay tính năng với từng sản phẩm cụ thể nên mình chưa có thông tin đó.
