A project to enhance QIDI printers with custom LCD firmware, cutting-edge software, and OTA updates.
Together, let's unlock the full potential of your printer! 🎉
There are currently a few reports on freezing systems mid print on the X3 series (so far on the Xplus and XMax3). So if you need to print something important, please avoid updating or installing FreeDi for the time this is unresolved.
More information see here #283 and here #290 I will investigate that as soon as I am back again (see #283)
If you want to start, head over to the
📖 Wiki and follow the complete installation guide for v2.xx.
For v1.xx the insall guide can be found here.
📹 and a full installation video for v1.xx can be found here:
Note: At the time, there is no install video for v2.xx out (yet)
But I invite you to read the other parts as well! 😊
If FreeDi has made your printing experience better, consider supporting this project:
Your contributions help me justify (to myself) spending even more time on this project to maintain and improve it ;)
You can also support FreeDi by:
- sharing it with others
- providing feedback
- giving it a star on GitHub
- or contributing with whatever you have to offer ;)
FreeDi is a comprehensive upgrade package designed to enhance your printing experience. Here's what it offers:
- Custom Display Firmware: Built from the ground up for maximum usability.
- Seamless Display Software: Ensures fast and reliable communication between the printer and the stock display.
- OTA Updates: Update your firmware in ~4 minutes -no more USB drives or 40-minute waits!
- Optimized Configuration and Macros: Streamlined for better performance and usability.
- Latest Software Stack:
- Armbian OS Bookworm (replacing Buster)
- Klipper 0.13.0+ (latest, unmodified)
- Moonraker v0.9.3+ (latest, unmodified)
- Mainsail v2.14+ (latest, unmodified)
- KIAUH integration
- Latest LTS Linux Kernel
- X-Max 3
- X-Plus 3
- X-Smart 3
- Q1 Pro
- Plus 4
- You're satisfied with the stock system. FreeDi is here to enhance, not persuade.
- You're facing hardware issues. FreeDi is software and can't do magic - even if it sometimes still feels magical for me ;)
- You want an open, up-to-date system with no compromises.
- Want to have more space for your gcode files (FreeDi v2.00 has 2.6GB free space, stock had around 500MB for me)
- You need access to advanced software features and plugins:
- Additional features (Spoolman, Shake&Tune, etc.)
- Tune and adjust your printer precisely using accurate software measurements (eg. Shake&Tune)
- You're tired of stock software bugs causing:
-
Nozzle crashes into the print bed.
-
Bed slamming into the printer bottom.
-
Print head collisions without emergency stop options.
-
Missing or poor-quality thumbnails on-screen.
-
Annoying "SYSTEM STARTS ABNORMALLY" errors.
-
You want to have nice looking thumbnails
-
FreeDi is a project inspired and shaped by the community. Your ideas, feature requests, and suggestions play an essential role in its ongoing development. Help spread the word so that every QIDI user knows about this project and can make an informed decision for themselves.
Before you start, please understand that this is a hobby project and using my firmware is at your own risk.
I have spent many hours testing and flashed the LCD more than 1,000 times to ensure it provides
the best possible experience, but I can't test every possible scenario. If you encounter any issues,
please report them here on GitHub.
Please do not contact Qidi support if you have any problems. By making these modifications,
you may void your warranty in this regard.
If you ever want or need to revert to the stock system after flashing my firmware, don't worry – it's possible.
You can use a "recovery" image provided by Qidi and flash the official *.tft firmware back to the LCD.
I kindly ask that you do not copy or redistribute any parts of my guide and software without explicit permission.
In the past, sections of my work have been used without proper credit and claimed as their work.
Incorrect parts have been added to other guides and resulted in additional effort on my part.
This resulted in me being contacted for support related to these guides which had errors.
I hope you do understand that I dont like to spend extra time to fix other faults :).
However, feel free to share the guide with others as long as proper credit is given!
The more users can benefit from it, the happier I get ;)
I invite everyone to share and collaborate to make this the "go-to" place for X3-Series improvements.
If you have suggestions or improvements, I warmly invite you to submit your contributions directly to me.
I will gladly consider integrating them to improve the guide and firmwares for everyone.
This not only improves the usability for everyone, but also helps to ensure accuracy and reduces unnecessary support issues.
Thank you for respecting this request and for helping to foster a supportive and fair community.
