What is RatOS?
RatOS is a comprehensive 3D printer firmware solution that combines Klipper, Moonraker, Mainsail, and KlipperScreen into an easy-to-use, point-and-click configuration system. It is developed and maintained by Mikkel Schmidt (miklschmidt#2036 on the Rat Rig Unofficial Discord).
How does it work?
RatOS simplifies the complex world of Klipper-based 3D printing by providing:
- A pre-configured Raspberry Pi image with all necessary software components
- An intuitive web-based configurator that lets you:
- Select from 12+ supported printers and 45+ control and toolboards
- Configure toolhead hardware (supporting up to 2 toolheads per printer)
- Set up multiple toolboards
- Fine-tune motor and driver configurations
- Automatically apply tested driver tuning presets for known configurations
- Fully automated firmware and system updates
- Extensive collection of configurable macros for:
- Automated print start/end sequences
- Smart filament handling and sensor integration
- Chamber temperature control
- Adaptive bed meshing and nozzle priming
- Intelligent pause/resume functionality
- Temperature-aware probe operations
- Input shaper calibration tools
The system automatically generates and maintains your printer's configuration files, significantly reducing the need for manual editing or command-line interaction. When you make hardware changes, RatOS updates your configuration automatically and shows you the changes for review.
Advanced Features
Beyond basic configuration, RatOS includes:
- Realtime Analysis Tool (RAT) for live power spectral density analysis
- input shaper calibration
- belt tension tuning with peak detection and mechanical health estimation
- oscillator for resonance hunting
- Visually Assisted Offset Calibration (VAOC) for precise multi-toolhead calibration
- Advanced IDEX support with blazing fast toolshifting and multi-color printing
- Automated firmware and system updates
RatOS's main design principle is that users shouldn't need command-line knowledge to use Klipper on their 3D printer. However, for advanced users, RatOS remains fully compatible with standard Klipper configuration, allowing you to leverage its tools while maintaining full control over your setup.
What do I need?
To run RatOS on your printer you need a supported control board and a Raspberry Pi or BTT CB1 (experimental).
Currently supported host computers
- Raspberry Pi 3 (A+/B/B+)
- Raspberry Pi 4B
- Raspberry Pi 400
- Raspberry Pi Zero 2
- Raspberry Pi Compute Module 4 Lite for use with SD Cards
- Raspberry pi Compute Module 4 with at least 16gb eMMC (more complicated to set up)
Community supported host computers
- Big Tree Tech CB1 (experimental)
Currently Supported Printers
Official Support
These printers are officially supported by Rat Rig and the RatOS team.
- Rat Rig V-Core Pro v1.3
- Rat Rig V-Core 3
- Rat Rig V-Core 3 IDEX
- Rat Rig V-Core 4
- Rat Rig V-Core 4 Hybrid
- Rat Rig V-Core 4 IDEX
- Rat Rig V-Minion
- Rat Rig V-Chonk
- Rat Rig V-Chonk 3Z Mod
Community Support
These printers are supported through community contributions and may not be as well tested.
- Prusa Mini
- Pruse MK3S
- Voron Design V0.1
- Voron Design V2.4
Contribute
Join the discussion on discord!
Join the Unnofficial RatRig Discord Community
Software Credits
RatOS is based on Klipper, Moonraker, Mainsail, MainsailOS and KlipperScreen without these and the amazing people behind them, RatOS would not have been possible.
Disclaimer
The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.