hoverDocsGetting started
Install
Download and install Hover on Windows (installer) or Linux (.deb or tarball), and what works on each system, Mac included.
Hover runs on Windows, Linux and macOS. Download the newest build from release v3.9.0 on GitHub, where every file is attached. For the Mac, see Hover on macOS.
| Platform | File to download |
|---|---|
| Windows 10 / 11 (x64) | Hover-Setup-3.9.0.exe |
| Ubuntu 22.04+ and Debian-based (x64) | hover_3.9.0_amd64.deb |
| Any other Linux (x64) | hover-3.9.0-linux-x86_64.tar.gz |
| macOS 14+ (guide) | Hover-3.9.0-macos-arm64.dmg (Apple silicon) or Hover-3.9.0-macos-x64.dmg (Intel) |
Windows
- Download
Hover-Setup-3.9.0.exefrom the release page. - Run the installer. If you already have Hover 2.x, it installs over it in place and keeps your data.
- Hover starts in the tray, and the island appears at the top centre of your main display.
Linux
On Debian or Ubuntu, install the .deb you downloaded:
sudo apt install ./hover_3.9.0_amd64.debOn any other distro, unpack the tarball; it holds usr/bin/hover, its icon and a desktop entry:
sudo tar -xzf hover-3.9.0-linux-x86_64.tar.gz -C /The binary carries its own fonts, icon and music. It needs only common system libraries (ALSA, fontconfig, FreeType, xkbcommon-x11, and OpenGL or Vulkan). zenity or kdialog is recommended.
What works on which system
| Windows 10/11 x64 | Linux x64 (X11) | Linux on Wayland | macOS 14+ | |
|---|---|---|---|---|
| Notch, office, Settings | Yes | Yes | Through XWayland | Around the camera notch |
| Quotas | On the notch | On the notch | On the notch | In the menu bar |
| Global shortcuts | Alt+N, Ctrl+Alt+Space | Same | Only while an XWayland window has focus | Option-N, Control-Option-Space |
| Local speech (Phonon) | Yes | Yes (arm64 not tested yet) | Yes | No: Apple’s recognizer instead |
| Sandbox | No | Yes | Yes | Yes |
| Agent browser, agent setup, computer use, agent desktops | No | No | No | Yes |
| Desk card, helpers, pull requests, checkpoints | Yes | Yes | Yes | Yes |
| Release package | Installer | .deb, tarball | .deb, tarball | Disk image (.dmg) |
macOS
Download the .dmg for your Mac from the release page, as described in Hover on macOS. You can also build Hover.app from source.
The agents
Hover drives the agent tools you have installed and signed in. Install at least one; see Agents for what Hover looks for.