dofscroll
Use your 3Dconnexion SpaceMouse as a scroll wheel and zoom control in any program. A SpaceMouse is made for 3D and CAD software; in a web browser, a PDF reader, a map or an office document it usually does nothing. dofscroll turns the six axes into smooth scrolling, zooming and keys for ordinary desktop programs, with per-program and per-device profiles, built-in joystick modes and button modes. Free software for Linux (tested), Windows and macOS (built by CI, never run with a real device, see Status and testing). Website: https://hoze-lukas.github.io/dofScroll/ (English, Deutsch). Wiki: Quick start, Built-in modes, Requirements.
Install in three lines (download the package from the latest release first; first-time setup in docs/installation.md):
- Linux (Fedora, RHEL family; RHEL, Rocky and Alma need EPEL first:
sudo dnf install epel-release): sudo dnf install ./dofscroll-*.rpm. Debian and Ubuntu: sudo apt install ./dofscroll_*.deb. Then open dofScroll from the application menu.
- Windows: run the unsigned
dofscroll-*-setup.exe (SmartScreen: More info, Run anyway) or unpack the portable ZIP. Then open dofscroll from the Start menu.
- macOS (Apple silicon): open the unsigned, not notarized DMG and drag the app to Applications (right-click, Open on first start). Then open dofscroll from Applications.
The first start is always just opening the program: it starts the daemon by itself and shows a short setup guide (daemon, SpaceMouse, start at login, on macOS the two permissions). No terminal commands, except one on Linux if the spacenavd driver service is off: the packages never enable it for you (the setup guide shows the command).
dofscroll is not affiliated with or endorsed by 3Dconnexion.
dofscroll turns a 3Dconnexion SpaceMouse into smooth scrolling, zooming, arrow keys and mouse
buttons for ordinary desktop programs. It reads the device through spacenavd/libspnav and
sends the events through X11 (XTest) or, for Wayland, through uinput.
On Windows and macOS the official 3Dconnexion driver can stay installed and running for your CAD
programs. dofscroll then reads the SpaceMouse through the driver's programming interface when the
driver is installed, and directly as raw HID otherwise (setting INPUT, default auto; the
interface shows which one is active). dofscroll contains nothing of the driver: it only loads the
installed driver's interface at run time. The driver, its interface and the names 3Dconnexion and
SpaceMouse belong to 3Dconnexion (a Logitech company); dofscroll is not affiliated with or endorsed
by them. Details: docs/legal-notes.md. Apart from the first tests on one
Windows machine, the driver path has only been run against a fake driver in CI (see Status and testing).
It consists of two programs. The Qt interface is the only tray and settings window on Linux, Windows and macOS (the old GTK tray dofscroll-tray was removed in 0.1.1, #43):
| Program | Task |
|---|
dofscroll | Background daemon. Reads the SpaceMouse, produces the input events. |
dofscroll-ui | Qt6 tray icon and settings window for Linux, Windows and macOS (pages Overview, Profiles (tabs General, Channels, Motions and buttons, Overrides), Editor and Joystick modes with a visual editor (a picture of the cap: click a motion or button and choose what it does), Button modes, User modes, Device, Axes, Settings). Writes the configuration files (dofscroll.conf and one file per profile in devices/ and apps/) and tells the daemon to reload. See docs/ui.md. |
What is new in 1.3.2
The driver cleanup on Windows is a step-by-step assistant with a real check box per program, a preview, a progress page and a restore of any backup; Restart the 3Dconnexion driver (Windows and macOS) closes the driver's settings window and starts its service again so that it reads the changed files; on X11 the output follows keyboard layout changes. Not verified: the macOS restart (never run on a Mac) and the assistant clicked through on real Windows: see docs/release-notes-1.3.2.md.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
