HackMan3D Orbit Controller

An open-source, fully 3D-printable 6-DOF navigation controller built around an Arduino Pro Micro and four Hall-effect joysticks. Orbit provides native 3D-controller input for CAD applications and an optional mouse-emulation mode for slicers.

Start here

1. Download the ready-to-use package from the latest release.
2. Print the parts from Creality Cloud or MakerWorld.
3. Order the components listed in the Bill of Materials.
4. Follow the Assembly Guide and wiring diagram.
5. Install the NavCore 3D Controller board package in Arduino IDE.
6. Open Firmware/Hackman3D_Orbit_Controller/Hackman3D_Orbit_Controller.ino, select the Arduino Pro Micro target, and upload it.
7. Keep the controller untouched for one second after connecting it while the joysticks calibrate.

The complete assembly video is available on YouTube.

Features

• Six degrees of freedom: translation and rotation on three axes
• Four Hall-effect joysticks for contactless position sensing
• Three adjustable speed profiles
• Configurable dead zones, gain, smoothing, response curves, and axis inversion
• Multi-axis input with optional dominant-axis filtering
• Three configurable shortcut buttons
• Optional slicer mouse-emulation mode
• Native USB HID operation; no Orbit application is required
• Windows, macOS, and Linux support

Compatibility

Orbit works with applications that support 3Dconnexion-style HID controllers, including:

Category	Tested or commonly supported applications
CAD and 3D	Fusion 360, Blender, SolidWorks, FreeCAD, Onshape, Autodesk Inventor, Rhino
Slicers	Bambu Studio, Cura, PrusaSlicer
Operating systems	Windows, macOS, Linux

Application support can vary by version and operating system. Slicers without native 3D-mouse support can use Orbit's optional mouse-emulation mode.

Hardware

• 1× Arduino Pro Micro, ATmega32U4, 5 V / 16 MHz, USB-C
• 4× JH16 Hall-effect joystick modules
• 3× optional mechanical keyboard switches
• Female-to-female Dupont wires, approximately 15 cm
• USB-C data cable
• 3D-printed parts
• Fasteners:
  • 4× M2×10 countersunk
  • 6× M2×6 countersunk
  • 4× M3×6 socket head
  • 2× M3×8 socket head
  • 4× M3×10 socket head
  • 1× M3×12 socket head

Check the Bill of Materials before ordering.

Controls

CAD mode

• Move and twist the knob for translation and rotation.
• Press all three buttons together to cycle through the speed profiles.

Slicer mouse mode

Hold buttons 2 and 3 together to switch between CAD mode and slicer mouse mode.

Button	Short press	Long press
1	Tab	Command + Shift + G
2	N	L
3	Command + 0	A

The default shortcuts target macOS workflows and can be changed in the firmware. Pressing all three buttons still changes the speed profile.

Tuning and troubleshooting

The controller calibrates itself every time it starts. Place it on a stable surface, do not touch the knob, and wait about one second after connecting it.

If an axis drifts, feels too sensitive, moves in the wrong direction, or needs a different response curve, use the Tuning Guide. All user-adjustable values are grouped near the top of the firmware.

For problems:

1. Review the open issues.
2. Confirm that the USB cable supports data.
3. Confirm the selected Arduino board and port.
4. Open a bug report with the requested diagnostic information.

Repository contents

Path	Contents
Firmware/	Arduino source code
Documentation/	Assembly guide and Bill of Materials
Wiring/	Pinout and wiring diagrams
images/	Project media
TUNING_GUIDE.md	Calibration and response settings
CHANGELOG.md	Published version history

Contributing

Bug fixes, documentation improvements, hardware feedback, and tested enhancements are welcome. Read CONTRIBUTING.md before opening a pull request.

Please report security-sensitive problems according to SECURITY.md, rather than in a public issue.

License

The repository is licensed under the GNU Affero General Public License v3.0. Printable model platforms may provide their files under separate terms; check the license shown on the relevant model page before redistributing them.

Orbit is an independent community project and is not affiliated with or endorsed by 3Dconnexion.

Credits and support

Designed and maintained by HackMan3D.

Additional features, testing, and feedback by Kitek.

Special thanks to NavCore for the Arduino board package that enables native 3D-controller compatibility on the Pro Micro.

If Orbit is useful to you, star the repository, share your build, and help other makers by reporting your tested hardware and software combinations.