FreeDi

A project to enhance QIDI's X3 printers with custom LCD firmware, cutting-edge software, and OTA updates.
Together, let's unlock the full potential of your printer! 🎉

🚀 Getting Started

If you want to start, head over to the
📖 Wiki and follow the complete installation guide.

📹 or Watch the full installation video

But I invite you to read the other parts as well! 😊

❤️ Support FreeDi

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 ;)

🔎 What Is FreeDi?

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.12.0+ (latest, unmodified)
  • Moonraker v0.9.3+ (latest, unmodified)
  • Mainsail v2.13+ (latest, unmodified)
  • Python 3.12 (upgraded from 2.7)
  • KIAUH integration
  • Latest LTS Linux Kernel (6.6.x)

🖨️ Supported Printers

Currently Supported:

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

Coming Soon:

• Q1 Pro (Estimated Release: April 2025)

Potential Future Support:

• Plus 4 (Looking for Klipper/Python experts—contact me if interested!)

❓ Is FreeDi Right for You?

Not for You If...

• 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 ;)

Perfect for You If...

• You want an open, up-to-date system with no compromises.
• 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

    

🛠️ Contribute to FreeDi

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.

⚠️ Disclaimer

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.

📢 Notice Regarding Guides, Contributions, and Sharing

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.