Forge-X is a free, unofficial firmware mod for the Flashforge Adventurer 5M and 5M Pro (AD5M) 3D printers. It adds an adapted Klipper with Moonraker, Fluidd, and Mainsail on top of the stock firmware, together with a lightweight touchscreen (Feather), calibration tools, print-safety features, Power Loss Recovery, and recovery tools. The mod can be fully removed.
Caution
If you install this mod on your AD5M (Pro), you risk voiding your warranty or damaging your printer. After installation or uninstallation, check all printer parameters and perform a full recalibration. Skipping this step may damage your printer. Proceed at your own risk!
The printer runs vendor firmware on a Linux kernel. It is not a general-purpose computer and not Ubuntu, Debian, or any other desktop or server distribution.
Read the documentation before changing anything. A mistake can leave the printer unable to boot. It can be restored, but in rare cases that requires additional hardware or soldering.
- Do not flash another mod over Forge-X (or Forge-X over another mod).
- Do not install additional software on the printer unless you fully understand what you're doing.
- Do not delete installation, uninstallation, or recovery logs. They may be needed to restore the printer.
- Stock Screen with option to disable it completely and switch to one of alternative screen versions to reduce resource consumption
- Klipper with many patches/fixes/plugins specially adapted for AD5M
- Moonraker
- Fluidd & Mainsail
- Adapted Guppy and custom Feather screens
- Originally developed Power Loss Recovery specially for AD5M
- OTA updates for Firmware, Fluidd, Mainsall, Guppyscreen.
- Root access (with zsh/.oh-my-zsh)
- Buzzer with ability to play monotonic melodies (midi / notes)
- Patched video streamer with dramatically reduced memory usage
- Timelapse support via Moonraker Telegram bot installed on external host
- Adaptive bed meshing with KAMP with Smart Parking.
- Built-in MD5 checks for gcode files.
- Backup and Restore mechanism for printer's configuration
- Fix for the Move queue overflow (E0017) error.
- Fix for the Communication Timeout (E0011) 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 / Klipper Mod
Forge-X 1.4.2 is now available as a public beta. This is a major update with a fully interactive Feather touchscreen and a heavily reworked Forge-X experience — much closer to what I originally wanted Forge-X to be from the beginning.
The beta is already considered stable enough for regular use, but it is still a beta: some bugs, rough edges, or cosmetic issues may remain.
If you want to try the new Forge-X early, help find the remaining issues, and take part in shaping the upcoming release, check the Releases page for the latest 1.4.2 beta.
Full details, installation notes, and beta-specific warnings are included in the release notes.
Caution
Releases before 1.4.1-11 contain a Smart Park / MOVE_SAFE bug. Do not enable or use KAMP, or call MOVE_SAFE, while relative positioning (G91) is active. Upgrade to 1.4.1-11 or later first.
- Uninstall any other installed mods first (
⚠️ make a backup!). - Install the mod.
- Update slicer Start and End G-code.
- Update slicer Host Type.
- Enable LAN-mode
- Enable MD5 check for G-code files.
- Update the mod to new versions using OTA.
⚠️ Mandatory: Read about How bed meshing works- Recommended: Enable Klipper tuning to avoid typical MCU errors:
SET_MOD PARAM=tune_klipper VALUE=1 - Recommended: Enable config tuning for a better first layer:
SET_MOD PARAM=tune_config VALUE=1(⚠️ requires recalibration afterward). ⚠️ Recalibrate Bed Mesh, shaper, and Z-offset.- Optional: Learn about Z-Offset
- Optional: Enable the mod’s Camera implementation.
- Optional: Configure your LED lighting
- Optional: Enable Feather/Guppy Screen.
- Optional: Enable Bed Collision Protection.
- Optional: Enable Bed Mesh Validation.
- Optional: Enable Power Loss Recovery.
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.
This article might also be useful: Reducing resource usage.
For additional help, check out the F.A.Q..
You can reach services using these addresses:
- Moonraker:
http://<printer_ip>:7125/ - Fluidd:
http://<printer_ip>/fluidd/ - Mainsail:
http://<printer_ip>/mainsail/ - SSH credentials:
root/root
If you encounter issues:
- First, consult the documentation.
- If the problem persists:
- Join the Telegram Support group
- Or, Join the Discord server
→ Navigate to: Forums → mods-and-projects → Forge-X - Only open a GitHub issue if you're absolutely certain this is a bug.
The AD5M hardware can produce good prints, but its software limits it. The host has only 128 MiB of RAM, the bundled Klipper is from the older 0.11 generation, and the stock firmware exposes only a small part of what users expect from a Klipper-based printer.
Forge-X is built around these limits instead of assuming the resources of a newer printer. Memory, CPU load, background services, the screen, the camera, and Klipper timing are treated as one reliability problem: a service that takes too much memory or CPU can stop a print just as a Klipper bug can. Newer software is adapted to fit the hardware rather than added as it is.
Other problems are not about performance: missing Klipper workflows, long-standing AD5M-specific bugs, few ways to recover a printer that fails to boot, little diagnostic information, and no clean way to extend the system. Forge-X treats testing, failure handling, recovery, and documentation as part of the work itself. The goal is a system that can be maintained over time, where every change can be undone, and where others can add integrations or ports without relying on undocumented internals.
- Installation
- Configuration
- Slicing
- Printing
- Macros
- Calibration
- F.A.Q
- Alternative Screen
- Camera
- Telegram Bot and Timelapse
- Dual boot
- Uninstall
- Recovery guide
The OpenWiki provides a code-oriented guide for contributors and advanced users. It complements the operator documentation above; follow the operator guides for installation, calibration, and recovery procedures.
- Architecture overview
- Source map
- Chroot environment and web runtime
- Configuration and printing workflows
- Screen modes and Feather
- Built-in Klipper patching
- Forge-X Klipper extensions
- Operations and recovery
- Integrations
- Testing and change guide
If you encounter any issues, feel free to join Telegram group for support: Join here. You can also join FlashForge community in Discord (Navigate to: Forums → mods-and-projects → Forge-X)
- Feather Screen: Ultra lightweight screen implementation with essential information
- Klipper bugfixes related to processing of G-Code containing Unicode symbols (specific for non-English symbols in object names)
- Mainsail OTA: Fixed and patched implementation to work correctly with navigation, with OTA updates
- Power-loss recovery for non-Stock screens
- Integration and adaptation of GuppyScreen for AD5M
- Port Forge-X to FlashForge AD5X / Creator 5 (possible with your support)
Forge-X is free, and it is built for the community. Developing new features, writing documentation, testing on real hardware, and answering questions all take a lot of time. If Forge-X is useful to you, you can support the project with a donation. It helps keep the mod maintained and improving.
Forge-X builds on the work of many people and projects:
- Thanks to the Klipper Mod developers for their excellent work.
- The integration with the Stock screen is based on the implementation from ZMod by ghzserg.
- Thanks to the Klipper and Moonraker communities for their ongoing development.
Thanks to the authors of these open-source fonts:
Thank you to everyone who has supported this project with a donation. Your support gives the project time to grow, and every contribution, whatever its size, is appreciated.
Supporters: 906Prints, MattArmfield, Stormage, Spud, Luigisvc, slydog43, Никита (motionpix), CHaucke, Andrew Popow, K3D // Dmitry Sorkin, D T, Kurt LaRue, jollyroger1789, Jules Woods
Thank you also to everyone who supported the project anonymously with cryptocurrency.