This is an unofficial mod to run Moonraker, Klipper (with essential patches), Mainsail, and Fluidd on the Flashforge AD5M (Pro) 3D printers. The mod is based on ZMod, which itself is derived from Klipper-mod.
Caution
If you choose to install this mod on your AD5M (Pro), be aware that you risk voiding your warranty or damaging your printer. After installation or uninstallation, ensure that you check all printer parameters and perform a full recalibration. Failing to do so may result in damage to your printer. Proceed at your own risk!
Warning
This mod is currently in development. While it is functional, you may encounter bugs or print failures during use.
If you experience any issues, please report them by creating an issue.
The printer has Linux, but it’s not the Linux you’re used to.
It’s not like Ubuntu, Debian, Fedora, or other Linux distributions.
The printer isn’t a desktop. It uses firmware with a Linux core as its base. It’s more like a smart microwave.
So, read the documentation before doing anything. Because you risk completely bricking your printer.
It’s restorable, but it requires additional hardware or soldering in exceptional cases.
Don’t flash one firmware over another unless you clearly understand what you are doing.
Don’t delete installation, uninstallation, or recovery logs — it’s may help to restore your printer.
If nothing’s working and you don’t understand why or what you can do, you’re not an experienced user and not a professional.
—- It’s better to ask for help before you do anything that completely bricks your printer.
You don’t need that, it takes your time and mine. So better carefully read the docs first.
There’s also a tiny chance you’d have to buy a new motherboard — probability’s near zero, but it’s not impossible.
So don’t do anything if you not clearly understand what you are doing.
- Stock Screen with option to disable it completely and switch to feather screen version to reduce resource consumption
- Klipper with many patches/fixes/plugins specially adapted for AD5M
- Moonraker
- Fluidd & Mainsail
- OTA updates
- Root access (with zsh/.oh-my-zsh)
- Buzzer with ability to play monotonic melodies (midi / notes)
- Patched mjpg-streamer with dramatically reduced memory usage
- Timelapse support via Moonraker Telegram bot installed on external host
- Adaptive bed meshing with KAMP.
- Built-in MD5 checks for gcode files.
- Backup and Restore mechanizm for printer's configuration
- Fix for the E00017 error.
- Failsafe mechanism to prevent nozzle collisions.
- Better Clear Nozzle algorithm.
- Enhanced Shaper Calibration with automatic plot generation.
- Easy Bed Level Screw Tuning.
- Customized dedicated Linux environment based on Buildroot
- Entware package manager for additional software installation
- Dual boot with stock Flashforge software or Klipper Mod
To begin, follow the instructions on the Installation page. After the installation, you will need to update your slicer's starting and finishing G-code. Refer to the Slicing page for guidance.
Warning
Important: Make sure to review your printer settings and recalibrate the bed mesh and Z-offset. Some settings may change during installation, and failure to recalibrate could potentially damage your printer.
This modification also includes additional features. It is highly recommended that you thoroughly read the Printing and Configuration pages before getting started.
For additional help, check out the F.A.Q..
If you encounter issues:
- First, consult the documentation.
- If the issue persists, you can create an issue on GitHub or join the Telegram Support group for assistance.
This mod was created to address several critical limitations and challenges faced by users of the Flashforge AD5M (Pro) 3D printer. Here are the key reasons behind its development:
Instability and Resource Issues in Existing Klipper Mods: The previous Klipper mod for the AD5M has stopped development and is no really stable. It consumes excessive RAM, leading to issues such as "Timer too close" errors and other performance problems. And some of typical AD5M issues not fixed at all. This mod aims to resolve these issues by optimizing resource usage and ensuring a stable, reliable experience.
Closed and Inflexible Development in ZMOD: While ZMOD introduced significant improvements, it is not user-friendly for further enhancements or fixes. Its closed nature and unique development approach make it difficult to modify without deep knowledge of the entire system. This mod focuses on rewriting the foundation to provide advanced users with more control, making it easier to apply patches, additions, and customizations.
Lack of Essential Functionality in Stock Firmware: The stock firmware lacks many essential features that modern 3D printing enthusiasts expect. For example: The camera functionality is poorly optimized, consuming excessive RAM and delivering subpar performance. Users are unable to perform standard tasks that Klipper users typically rely on, such as advanced calibration, macros, and real-time monitoring. This mod addresses these shortcomings by integrating modern tools and features.
Outdated Klipper with Unresolved Bugs: The existing Klipper implementation for the AD5M is outdated and plagued with bugs. This mod focuses on fixing these long-standing issues, modifying Klipper plugins, and enhancing core functionality to better suit the specific requirements of the AD5M (Pro) printer. The goal is to provide a stable, feature-rich platform tailored to this printer's unique hardware and user needs.
- Installation
- Configuration
- Slicing
- Printing
- F.A.Q
- Alternative Screen
- Camera
- Telegram Bot and Timelapse
- Dual boot
- Uninstall
- Recovery guide
If you encounter any issues, feel free to join Telegram group for support: Join here.
Thanks Klipper Mod developers for their great work.
Thanks to the Klipper and Moonraker communities for their ongoing development.
Special thanks to the Russian FlashForge Adventurer 5M Telegram Community: @FF_5M_5M_Pro
This mod is based on ZMod by ghzserg.
Thanks for the great open-source fonts:
