A free, open source, and extensible speech-to-text application that works completely offline.
docs: note that fn/Globe shortcuts only work on Apple keyboards (#1926)
Iaroslav Mazur8282c4001d61
diff --git a/README.md b/README.mdindex 271a58d7..c221a0a6 100644--- a/README.md+++ b/README.md@@ -119,6 +119,14 @@ This project is actively being developed and has some [known issues](https://gitUsing a Bluetooth headset microphone on macOS may temporarily reduce playback quality or volume while recording because Bluetooth switches to bidirectional audio. Keep your headphones as the output device and select your Mac's built-in or an external microphone in Handy to avoid this.+### fn and Globe Key Shortcuts (macOS)++Shortcuts that include the `fn` (Globe) key **only work on Apple keyboards** — your Mac's built-in keyboard or an Apple external keyboard. They will never trigger on a third-party keyboard, even while it is connected to the same Mac.++This is a hardware limitation rather than a Handy bug. `fn` is not part of the standard USB HID keyboard specification: Apple reports it through a vendor-specific usage that macOS honors only from Apple devices, while third-party keyboards handle their `Fn` key entirely in firmware and send nothing to the computer. There is no event for Handy to listen for.++If you switch between a MacBook keyboard and an external one, pick a shortcut built from standard modifiers (`ctrl`, `option`, `shift`, `command`) or a regular key instead.+### Major Issues (Help Wanted)**Whisper Model Crashes:**