Open Mainline Klipper for QIDI Printers
Transform your QIDI printer with FreeDi - built on open Armbian OS, official Klipper, custom display firmware, and cutting-edge features. Stay current, stay secure, unlock your printer's full potential.
The FreeDi Wiki has moved!
🌐 freedi-wiki.github.io — Installation guides, configuration, troubleshooting and more.
FreeDi is a complete firmware ecosystem for QIDI printers that replaces the outdated stock system with modern, open-source components:
- Open Foundation: Armbian OS + official mainline Klipper (unmodified)
- Custom Display: Lightning-fast LCD firmware built for production use
- Seamless Integration: Optimized communication layer between Klipper and display
- Latest Software: Klipper 0.13.0+, Moonraker 0.9.3+, Mainsail 2.14+, KIAUH support
- OTA Updates: Update everything in ~4 minutes - no USB drives, no hassle
- Full Klipper Ecosystem Access: Use modern plugins like Cartographer, Beacon, Shake&Tune, Spoolman without compatibility issues
- More Storage: ~2.6GB free space vs. stock's ~500MB - never run out of room for gcode files
- Security Compliant: Passes security tests that stock firmware fails - critical for professional environments
- Actually Updated: Stock systems run OS and Klipper versions up to 4 years old with no update path
- No More Stock Bugs: Eliminate nozzle crashes, bed slamming, missing thumbnails, and "SYSTEM STARTS ABNORMALLY" errors
- QIDI X-Max 3
- QIDI X-Plus 3
- QIDI X-Smart 3
- QIDI Q1 Pro
- QIDI Plus 4
If FreeDi has improved your printing experience, consider supporting development:
You can also help by giving this repo a ⭐, sharing it with other QIDI users, providing feedback, or contributing improvements!
FreeDi thrives on community input. Have ideas, feature requests, or improvements? Open an issue or submit a pull request. Help spread the word so every QIDI user can make an informed choice about their firmware.
This is a hobby project - use at your own risk. I've tested extensively (1,000+ LCD flashes), but I can't cover every scenario. Please report issues on GitHub, not to QIDI support - modifications may void your warranty. You can always revert to stock using QIDI's recovery image and official .tft firmware.
Regarding Sharing & Attribution: Please don't copy or redistribute parts of this project without permission. In the past, modified/incorrect versions of my guides caused confusion and extra support work. Feel free to share the project with proper credit - the more users benefit, the better! I welcome contributions submitted directly here so we can maintain accuracy and make this the go-to resource for QIDI improvements. Thank you for respecting this and building a supportive community.
Together, let's unlock the full potential of your printer! 🎉
For complete documentation, visit the FreeDi Wiki.