{"id":24429426,"url":"https://github.com/dra1ex/ff5m","last_synced_at":"2025-07-24T10:38:49.070Z","repository":{"id":271997986,"uuid":"914480168","full_name":"DrA1ex/ff5m","owner":"DrA1ex","description":"Forge-X: Flashforge Adventurer 5M (Pro) Firmware mod","archived":false,"fork":false,"pushed_at":"2025-07-16T08:09:12.000Z","size":13508,"stargazers_count":128,"open_issues_count":4,"forks_count":11,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-07-17T11:18:56.168Z","etag":null,"topics":["ad5m","adventurer5m","adventurer5mpro","firmware","flashforge","flashforge-adventurer","forge-x"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"ghzserg/ff5m","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DrA1ex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://www.donationalerts.com/r/dra1ex"}},"created_at":"2025-01-09T17:17:41.000Z","updated_at":"2025-07-17T07:40:39.000Z","dependencies_parsed_at":"2025-02-10T16:22:27.627Z","dependency_job_id":"09902917-3dbe-4dd3-92a5-367e4b3f5bf3","html_url":"https://github.com/DrA1ex/ff5m","commit_stats":null,"previous_names":["dra1ex/ff5m"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/DrA1ex/ff5m","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrA1ex%2Fff5m","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrA1ex%2Fff5m/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrA1ex%2Fff5m/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrA1ex%2Fff5m/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DrA1ex","download_url":"https://codeload.github.com/DrA1ex/ff5m/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DrA1ex%2Fff5m/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266828965,"owners_count":23991222,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ad5m","adventurer5m","adventurer5mpro","firmware","flashforge","flashforge-adventurer","forge-x"],"created_at":"2025-01-20T13:36:08.565Z","updated_at":"2025-07-24T10:38:49.059Z","avatar_url":"https://github.com/DrA1ex.png","language":"C","readme":"\u003cp align=\"center\"\u003e\n   \u003cimg width=\"600\" src=\"https://github.com/user-attachments/assets/1e1e0b03-a424-4da3-8285-d62dd74470de\" /\u003e\n\u003c/p\u003e\n\n# Flashforge Adventurer 5M (Pro) Firmware Mod\n\nThis is an _unofficial_ mod to run Moonraker, Klipper (with essential patches), Mainsail, and Fluidd on the Flashforge AD5M (Pro) 3D printers.\nThe mod is based on ZMod, which itself is derived from Klipper-mod.\n\n\u003e [!CAUTION]\n\u003e *If you choose to install this mod on your AD5M (Pro), be aware that you risk voiding your warranty or damaging your printer.*\n\u003e *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.*\n\u003e *Proceed at your own risk!*\n\n## DISCLAIMER\n\nThe printer has Linux, but it’s not the Linux you’re used to.  \n**It’s not** like Ubuntu, Debian, Fedora, or other Linux distributions.  \nThe printer **isn’t a desktop**. It uses firmware with a Linux core as its base. It’s more like a smart microwave.   \n\nSo, **read the documentation** before doing anything. Because you risk **completely bricking** your printer.   \nIt’s restorable, but **it requires additional hardware** or soldering in exceptional cases.\n\n**Don’t flash one firmware over another** unless you clearly understand what you are doing.   \n**Don’t delete** installation, uninstallation, or recovery **logs** — it’s may help to restore your printer.   \n\n**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.    \n—- **It’s better to ask for help** before you do anything that **completely bricks** your printer.    \n**You don’t need that**, it takes your time and mine. So better carefully **read the docs first**.\n\nThere’s also a tiny chance **you’d have to buy a new motherboard** — probability’s near zero, but it’s not impossible.  \nSo don’t do anything if you not clearly understand what you are doing.\n\n## Features\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"400\" src=\"https://github.com/user-attachments/assets/c7ff5d09-3786-4b69-b8d5-1f254c809de7\" /\u003e\n\u003cimg width=\"400\" src=\"https://github.com/user-attachments/assets/6f3b9343-d3d1-4f0e-b4cf-9ac1041502b2\" /\u003e\n\u003c/p\u003e\n\n- **Stock** Screen with option to disable it completely and switch to Feather screen version to reduce resource consumption\n- **Klipper** with many patches/fixes/plugins specially adapted for AD5M\n- **Moonraker**\n- **Fluidd** \u0026 **Mainsail**\n- **GuppyScreen** available as an [add-on](https://t.me/FF_ForgeX/2181)\n- **OTA** updates\n- **Root** access (with zsh/.oh-my-zsh)\n- **Buzzer** with ability to play monotonic melodies (midi / notes)\n- Patched **mjpg-streamer** with dramatically reduced memory usage\n- **Timelapse** support via [Moonraker Telegram bot](https://github.com/nlef/moonraker-telegram-bot) installed on external host\n- Adaptive bed meshing with **KAMP**.\n- Built-in **MD5** checks for gcode files.\n- **Backup** and **Restore** mechanism for printer's configuration\n- Fix for the **Move queue overflow (E0017)** error.\n- Fix for the **Communication Timeout (E0011)** error.\n- **Failsafe** mechanism to prevent nozzle collisions.\n- Better **Clear Nozzle** algorithm.\n- Enhanced **Shaper Calibration** with automatic plot generation.\n- Easy **Bed Level Screw Tuning**.\n- Customized dedicated Linux environment based on **Buildroot**\n- **Entware** package manager for additional software installation\n- **Dual boot** with stock Flashforge software or Klipper Mod\n\n## TL;DR\n\n1. Uninstall any other installed mods first (⚠️ make a backup!).   \n2. [Install](/docs/INSTALL.md#flashing-the-firmware-image) the mod.   \n3. Update slicer [Start and End G-code](/docs/SLICING.md#for-stock-screen).   \n4. Update slicer [Host Type](/docs/SLICING.md#configuring-moonraker--klipper-connection).\n5. Enable [LAN-mode](/docs/PRINTING.md#using-stock-firmware-with-mod)\n6. Enable [MD5 check](/docs/SLICING.md#enabling-md5-checksum-validation) for G-code files.\n7. Update the mod to new versions using [OTA](/docs/INSTALL.md#ota-updates).   \n8. **Recommended**: Enable [Klipper tuning](/docs/CONFIGURATION.md#configuration-macros) to avoid typical MCU errors: `SET_MOD PARAM=tune_klipper VALUE=1`\n9. **Recommended**: Enable [config tuning](/docs/CONFIGURATION.md#configuration-macros) for a better first layer: `SET_MOD PARAM=tune_config VALUE=1` (⚠️ requires recalibration afterward).   \n10. ⚠️ [Recalibrate](/docs/PRINTING.md#calibration) Bed Mesh, shaper, and Z-offset.\n11. **Optional**: Learn about [Z-Offset](/docs/PRINTING.md#z-offset)\n12. **Optional**: Enable the mod’s [Camera](/docs/CAMERA.md#step-3-enable-mods-camera) implementation.   \n13. **Optional**: Configure your [LED lighting](/docs/PRINTING.md#led-light-control)     \n14. **Optional**: Enable [Feather Screen](/docs/SCREEN.md#switching-to-feather-screen).   \n15. **Optional**: Enable [Bed Collision Protection](/docs/PRINTING.md#bed-collision-protection).   \n16. **Optional**: Enable [Bed Mesh Validation](/docs/PRINTING.md#bed-mesh-validation).   \n\n## Get Started\n\nTo begin, follow the instructions on the [Installation page](/docs/INSTALL.md). After the installation, you will need to update your slicer's starting and finishing G-code. Refer to the [Slicing page](/docs/SLICING.md) for guidance.\n\n\u003e [!WARNING]   \n\u003e **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.\n\nThis modification also includes additional features. It is highly recommended that you thoroughly read the [Printing](/docs/PRINTING.md) and [Configuration](/docs/CONFIGURATION.md) pages before getting started.\n\nThis article might also be useful: [Reducing resource usage](https://github.com/DrA1ex/ff5m/blob/dev/docs/PRINTING.md#reducing-resource-usage).   \nFor additional help, check out the [F.A.Q.](/docs/FAQ.md).\n\nYou can reach services using these addresses:  \n- **Moonraker**: `http://\u003cprinter_ip\u003e:7125/`  \n- **Fluidd**: `http://\u003cprinter_ip\u003e/fluidd/`  \n- **Mainsail**: `http://\u003cprinter_ip\u003e/mainsail/`\n- **SSH credentials**: `root` / `root`  \n\nIf you encounter issues:  \n1. First, consult the documentation.\n2. If the problem persists:\n   - Open a [GitHub issue](https://github.com/DrA1ex/ff5m/issues)\n   - Join the [Telegram Support](https://t.me/+ihE2Ry8kBNkwYzhi) group\n   - Visit the [Discord server](https://discord.gg/K7MH4hAfeX)    \n     → Navigate to: Forums → mods-and-projects → Forge-X\n\n## Why This Mod Was Developed\nThis 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:\n\n**Instability and Resource Issues in Existing Klipper Mods:**\nThe 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.\n\n**Closed and Inflexible Development in ZMOD:**\nWhile 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.\n\n**Lack of Essential Functionality in Stock Firmware:**\nThe stock firmware lacks many essential features that modern 3D printing enthusiasts expect. For example:\nThe camera functionality is poorly optimized, consuming excessive RAM and delivering subpar performance.\nUsers are unable to perform standard tasks that Klipper users typically rely on, such as advanced calibration, macros, and real-time monitoring.\nThis mod addresses these shortcomings by integrating modern tools and features.\n\n**Outdated Klipper with Unresolved Bugs:**\nThe 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.\n\n\n## Documentation\n- [Installation](/docs/INSTALL.md)\n- [Configuration](/docs/CONFIGURATION.md)\n- [Slicing](/docs/SLICING.md)\n- [Printing](/docs/PRINTING.md)\n- [Macros](/docs/MACROS.md)\n- [Calibration](/docs/CALIBRATION.md)\n- [F.A.Q](/docs/FAQ.md)\n- [Alternative Screen](/docs/SCREEN.md)\n- [Camera](/docs/CAMERA.md)\n- [Telegram Bot and Timelapse](/docs/TELEGRAM.md)\n- [Dual boot](/docs/DUAL_BOOT.md)\n- [Uninstall](/docs/UNINSTALL.md)\n- [Recovery guide](/docs/RECOVERY.md)\n\nIf you encounter any issues, feel free to join Telegram group for support: [Join here](https://t.me/+ihE2Ry8kBNkwYzhi).\nYou can also join FlashForge community in [Discord](https://discord.gg/K7MH4hAfeX) (Navigate to: Forums → mods-and-projects → Forge-X)\n\n## TODO\n\n- [x] Feather Screen: Ultra lightweight screen implementation with essential information\n- [x] Klipper bugfixes related to processing of G-Code containing Unicode symbols (specific for non-English symbols in object names)\n- [x] Mainsail OTA: Fixed and patched implementation to work correctly with navigation, with OTA updates\n- [ ] Power-loss recovery for non-Stock screens\n- [ ] Integration and adoption of GuppyScreen for AD5M\n\n## Support Forge-X\n\nForge-X is an open-source, free project built for the community, and everyone is welcome to use it without cost. However, developing new features, writing detailed documentation, and providing ongoing support through the community demands a significant amount of time and dedication. If you enjoy using Forge-X and appreciate the effort behind it, consider supporting the project with a donation. Your contributions help ensure the time needed to keep improving the mod, adding new features and maintaining active support.\n\n- **[Boosty (Donate)](https://boosty.to/dra1ex/donate)**\n\n- **[Boosty (Subscribe)](https://boosty.to/dra1ex)**\n\n- **Cryptocurrency Donations**:\n  - **BTC**: `17igL1Y1gHSK2FFsn8TQgVKkaVXXJ33Mu6`\n  - **TON**: `UQAa8-8q3GrZVVlZWbQgM80l9hol8OacOGfaQ68jVRU_uRbK`\n  - **USDT (TRC20)**: `TUmBppbp5vhhpwozzYzYmd9T3GefJsbX5K`\n\n## Credits\n\nThanks [Klipper Mod](https://github.com/xblax/flashforge_ad5m_klipper_mod) developers for their great work.\n\nThanks to the Klipper and Moonraker communities for their ongoing development.\n\nSpecial thanks to the Russian FlashForge Adventurer 5M Telegram Community: [@FF_5M_5M_Pro](https://t.me/FF_5M_5M_Pro)\n\nBig thanks [@Zero](https://www.youtube.com/@zerodotcmd) for the awesome logo! \n\nThis mod is based on ZMod by [ghzserg](https://github.com/ghzserg).\n\nThanks for the great open-source fonts:\n- [Roboto Font](https://fonts.google.com/specimen/Roboto)\n- [JetBrains Mono Font](https://www.jetbrains.com/lp/mono)\n- [Typicons Icons Font](https://www.s-ings.com/typicons/)\n","funding_links":["https://www.donationalerts.com/r/dra1ex"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdra1ex%2Fff5m","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdra1ex%2Fff5m","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdra1ex%2Fff5m/lists"}