A project aiming to use QIDIs X3 series printers with the stock display with latest klipper and OTA update support.
Lets unlock the full potential of your printer together!

FreeDi is a whole package, containing:

• A custom display firmware built from scratch for maximum usability
• A display software to enable seamless and fast communication between the printer and the stock display
• OTA Updates instead of updating with an USB thumb drive (takes ~4min for a full update instead of ~40min)
• Config and macro optimizations
• Based on the latest OS and software versions:
  • Armbian OS Bookworm (instead of Buster)
  • Klipper 0.12.0+ (latest and unmodified, replacing 0.10.0)
  • Moonraker v0.9.3+ (latest and unmodified)
  • Mainsail v2.13+ (latest and unmodified)
  • Python 3.12 (instead of 2.7)
  • KIAUH
  • Latest LTS Linux Kernel (6.6.x)

---

• X-Max 3
• X-Plus 3
• X-Smart 3

• Q1 Pro (Estimated firmware release: April 2025)

• Plus 4 (Klipper/Python experts needed—please contact me if interested)

---

If you appreciate my work and it has been beneficial to you,
I would be grateful if you consider supporting my efforts with a ko-fi:

This also helps me to justify puting more time to maintain this project for the future :)

But you can also help with contributing by share this project, share your thoughts and help improvind. I would really love to share this project (and need your help for this) so that every X3 user becomes aware of its existence and can make an informed decision for themselves.

---

• I dont want to convince anyone. If you're satisfied with the stock system, please to stick with it :)
• If you are having hardware issues. FreeDi can't do magic - even if it sometimes still feels magical for me ;)

• You want an open and up-to-date system without compromises
• You want to use current software projects and plugins for
  • Additional features
  • Tune and adjust your printer precisely using accurate software measurements (eg. Shake&Tune)
• You want to get rid of the stock software bugs that frequently causes
  • Scraping the nozzle into the print bed
  • Bed slamming into the printer bottom
  • Print head crashing into parts due to the lack of an emergency stop in the screen menu
  • No (or ugly) thumbnails displayed on screen
  • "SYSTEM STARTS ABNORMALLY"-error message on display

---

Head over to the Wiki for the Installation Guide to use it.
But I invite you to read the other parts as well!

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. (I am not sure, because Qidi really has a great after sale support).

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.