A Raspberry Pi OS based distribution designed specifically for the Ginger G1 3D Printer. It includes all the necessary software and optimizations to get started with Klipper Firmware and Mainsail for 3D printing with pellet extrusion technology.
This project is a fork of MainsailOS, tailored for the unique requirements of pellet-based 3D printing with the Ginger G1.
- Klipper4Pellet (Firmware for Pellet 3D Printing)
- Moonraker (API Web Server for Klipper)
- Mainsail (Web Interface for Klipper)
G1OS comes with the following pre-installed and configured software:
- Klipper4Pellet (Customized Klipper Firmware for Pellet 3D Printing)
- Moonraker (API for Klipper)
- Mainsail (Klipper Web Interface)
- Crowsnest (Webcam Streaming)
- Sonar (Keepalive Daemon)
- Nginx (Web Server & Proxy)
- Preconfigured Serial Connection for the Ginger G1 using Hardware UART (PL011).
- Preinstalled Dependencies for Klipper's Input Shaper. Simply build the klipper_mcu and install the service. See Klipper documentation for more info.
- Preinstalled Python3-serial package, required for CanBoot.
MainsailOS is a passion project developed and maintained by the Mainsail Crew. We dedicate a significant amount of our free time, almost daily, to keep the project alive and moving forward.
Your support directly fuels our development efforts. Donations help us cover essential costs for hardware, such as new SBCs and SD cards, which are crucial for testing, developing new features, and expanding board compatibility.
Q: How do I report a bug?
A: Please ensure it's not a configuration issue with:
- Klipper
- Moonraker
- Crowsnest
- Sonar
If the issue is specific to the G1OS setup or the Ginger G1 printer, report it via the G1OS GitHub Issues section. Provide detailed information to help us resolve the problem quickly.
Q: What is the philosophy behind G1OS?
A: We maintain a KISS principle—Keep It Simple and Straightforward. G1OS is built on the same foundation as MainsailOS, but optimized for pellet printing with the Ginger G1. We aim to keep things as close to the Raspberry Pi OS and MainsailOS documentation as possible, providing extra documentation only where needed.
Q: How can I contribute?
A: Contributions are always welcome! Please check out the CONTRIBUTING.md for ways to support the project or submit code.
To build your own version of G1OS, simply fork this repository, enable workflows, and each push will trigger an automated image build.
For more information on local builds, please refer to CustomPiOS and the guide "Build a Distro From within Raspbian/Debian/Ubuntu/CustomPiOS Distros".