{"id":50407238,"url":"https://github.com/filamind-app/filamind-flow","last_synced_at":"2026-07-05T06:01:38.774Z","repository":{"id":361499511,"uuid":"1254687820","full_name":"filamind-app/filamind-flow","owner":"filamind-app","description":"Extensible Neo-Brutalist control panel for Klipper / Moonraker — firmware flashing, input shaping, and TMC motor-driver tooling. Vue 3 + FastAPI, one widget at a time.","archived":false,"fork":false,"pushed_at":"2026-06-04T20:34:49.000Z","size":2075,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T07:33:37.964Z","etag":null,"topics":["3d-printer","3d-printing","control-panel","fastapi","fluidd","input-shaping","klipper","klipper-firmware","mainsail","moonraker","neobrutalism","python","stepper-motor","tailwindcss","tmc","tmc2209","typescript","vite","vue","vuejs"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/filamind-app.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T22:11:08.000Z","updated_at":"2026-06-04T20:34:46.000Z","dependencies_parsed_at":"2026-06-01T03:01:11.290Z","dependency_job_id":null,"html_url":"https://github.com/filamind-app/filamind-flow","commit_stats":null,"previous_names":["filamind-app/filamind-flow"],"tags_count":126,"template":false,"template_full_name":null,"purl":"pkg:github/filamind-app/filamind-flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filamind-app%2Ffilamind-flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filamind-app%2Ffilamind-flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filamind-app%2Ffilamind-flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filamind-app%2Ffilamind-flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filamind-app","download_url":"https://codeload.github.com/filamind-app/filamind-flow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filamind-app%2Ffilamind-flow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33973868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"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":["3d-printer","3d-printing","control-panel","fastapi","fluidd","input-shaping","klipper","klipper-firmware","mainsail","moonraker","neobrutalism","python","stepper-motor","tailwindcss","tmc","tmc2209","typescript","vite","vue","vuejs"],"created_at":"2026-05-31T02:04:16.598Z","updated_at":"2026-07-05T06:01:38.733Z","avatar_url":"https://github.com/filamind-app.png","language":"Python","funding_links":["https://ko-fi.com/I2I119XEIV"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# FilaMind Flow\n\nA control panel for Klipper and Moonraker that lives next to Mainsail and Fluidd,\nand grows one widget at a time.\n\n**Built by Egyptian makers, for world makers. Happy printing.** 🇪🇬\n\nA small-team hobby project, built and tested on real printers. The code is all here to read.\n\n[![Support on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/I2I119XEIV)\n\n[![CI](https://github.com/filamind-app/filamind-flow/actions/workflows/ci.yml/badge.svg)](https://github.com/filamind-app/filamind-flow/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/filamind-app/filamind-flow?color=111111\u0026label=release\u0026sort=semver)](https://github.com/filamind-app/filamind-flow/releases/latest)\n[![License: GPLv3](https://img.shields.io/badge/License-GPLv3-111111.svg)](LICENSE)\n[![Klipper](https://img.shields.io/badge/Klipper-compatible-111111)](https://www.klipper3d.org)\n[![Moonraker](https://img.shields.io/badge/Moonraker-API-111111)](https://moonraker.readthedocs.io)\n\n[Install](#install) · [Uninstall](#uninstall) · [Screenshots](#screenshots) · [Widgets](#widgets) · [Languages](#languages) · [Docs](#documentation) · [Support](#support)\n\n\u003c/div\u003e\n\nFilaMind Flow is a standalone single-page app that talks directly to Moonraker over REST and a WebSocket. It is a static frontend plus a small FastAPI backend, so it sits beside Mainsail and Fluidd rather than replacing them. The browser does most of the work, which keeps it light on the printer host, and the project grows one widget at a time.\n\n## Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/filamind-app/filamind-flow/main/scripts/install.sh | bash\n```\n\nThis installs the backend service, serves the prebuilt UI through nginx on port 8090, and registers with Moonraker so updates are one click away. It also adds a sidebar link, and you can re-run it any time to update or repair the install.\n\n## Uninstall\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/filamind-app/filamind-flow/main/scripts/install.sh | bash -s uninstall\n```\n\nThis removes the service, the nginx site, the sidebar entry, the Moonraker registration, and the sudo and udev rules, while leaving the app files in place. (If you cloned the repo, `cd ~/filamind-flow \u0026\u0026 bash scripts/install.sh uninstall` does the same thing.)\n\n## Screenshots\n\nReal screenshots from a Sovol SV08 (CoreXY), with live data from the printer.\n\n[![FilaMind Flow dashboard](docs/screenshots/dashboard.png)](docs/screenshots/)\n\nMore in the [screenshot gallery](docs/screenshots/), and at the top of each [widget page](docs/widgets/).\n\n## Widgets\n\n| Widget | What it does | Status |\n| ------ | ------------ | ------ |\n| [Machine Doctor](docs/widgets/machine-doctor.md) | One read-only health scan, graded A-F, each finding linking to its fix | ✅ Shipped |\n| [Firmware Manager](docs/widgets/firmware-manager.md) | Build and flash Klipper firmware on every MCU, guided and gated | ✅ Shipped |\n| [Input Shaping](docs/widgets/input-shaping.md) | Turn a resonance capture into a ready [input_shaper] config | ✅ Shipped |\n| [Config Editor](docs/widgets/config-editor.md) | Browse, edit, and safely save your printer's Klipper config with hardware-aware checks | ✅ Shipped |\n| [Max-Flow](docs/widgets/max-flow.md) | Ramp extrusion flow to find your hotend's safe max volumetric speed | ✅ Shipped |\n| [Board Topology](docs/widgets/board-topology.md) | Interactive map of your printer's control boards, linked to the hardware catalog | ✅ Shipped |\n| [Macro Designer](docs/widgets/macro-designer.md) | Offline G-code simulator: draw, explain, lint, and compare macros safely | ✅ Shipped |\n| [Hardware Browser](docs/widgets/hardware-browser.md) | Curated, deduped catalog of 2,600+ parts with copy-ready Klipper configs | ✅ Shipped |\n| [Config Templates](docs/widgets/config-templates.md) | Paste-ready Klipper config blocks and macros, filterable by category with one-click copy | ✅ Shipped |\n| [Motor Drivers](docs/widgets/motor-drivers.md) | Live TMC driver inventory with datasheet-based current tuning, homing, and register editing | ✅ Shipped |\n| [KlipperScreen Studio](docs/widgets/klipperscreen-studio.md) | Manage the printer's touchscreen: edit config, build themes and menus, or run Kiosk mode | ✅ Shipped |\n\nEvery widget has its own page under [docs/widgets/](docs/widgets/).\n\n## Tested on real printers\n\nFilaMind Flow is tested on two machines that disagree on almost everything that matters to a control panel. The first is a Sovol SV08: an STM32F103 mainboard, TMC2209 drivers over UART, a USB toolhead, and a BTT CB1 host. The second is a Voron-class CoreXY: an STM32H723 mainboard, six TMC5160 drivers on a shared software-SPI bus, a CAN toolhead, and a Raspberry Pi 4. Bringing the second printer online surfaced the \"works on my printer\" class of bug, and each one turned into a generic fix.\n\n## How it's built\n\nThe frontend is a Vue 3 and Vite single-page app, and a small FastAPI backend handles anything that has to run server-side. State flows through one reconnecting Moonraker WebSocket, mirrored into a shared store every widget reads from. Adding a feature means registering a widget; the core does not change. The UI ships in [19 languages](#languages), including right-to-left Arabic, with 7 switchable themes. For the full picture, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).\n\n## Languages\n\nThe whole interface is translated into **19 languages** - every widget, not just the chrome, all 2,352 strings each. Pick one from the 🌐 menu in the header; your choice is remembered, and on first run the app matches your browser's language.\n\n| | | | |\n| --- | --- | --- | --- |\n| English | Español | 简体中文 (Simplified Chinese) | 日本語 (Japanese) |\n| العربية (Arabic, RTL) | Français | 繁體中文 (Traditional Chinese) | 한국어 (Korean) |\n| Deutsch (German) | Русский (Russian) | Português (Brasil) | Tiếng Việt (Vietnamese) |\n| Italiano | Nederlands (Dutch) | Polski (Polish) | Bahasa Indonesia |\n| Türkçe (Turkish) | Українська (Ukrainian) | हिन्दी (Hindi) | |\n\nEach language is a drop-in catalog folder, so adding another needs no code changes - see [Internationalization](CONTRIBUTING.md#internationalization-strings--locales).\n\n## Develop\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, the dev workflow, and how to add a widget.\n\n## Documentation\n\n| Document | What's inside |\n| -------- | ------------- |\n| [ROADMAP.md](ROADMAP.md) | Phase-by-phase plan and status for every widget |\n| [CHANGELOG.md](CHANGELOG.md) | Release history |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | Dev workflow, conventions, and how to add a widget |\n| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Design and data-flow deep dive |\n| [backend/README.md](backend/README.md) | Backend service, `/api` endpoints, and `FILAMIND_*` settings |\n| [docs/widgets/](docs/widgets/) | One page per widget |\n\n## Support\n\nFilaMind Flow is free and open source, built and maintained in spare time. If it saved you a tuning session, or you just want to see it grow, a coffee helps keep the work going. Code, data, and ideas are just as welcome.\n\n\u003cdiv align=\"center\"\u003e\n\n[![Support on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/I2I119XEIV)\n\n\u003c/div\u003e\n\n## Credits\n\nBuilt and maintained by the DeltaFabs team:\n\n- Abdelmonem Awad - \u003ceg2@live.com\u003e\n- Ahmed Bebars - \u003cAhmedbebars1@gmail.com\u003e\n- Kareem Salama - \u003cGolden.kiko@gmail.com\u003e\n\n## License\n\n[GPL-3.0-or-later](LICENSE) © 2026 DeltaFabs team.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilamind-app%2Ffilamind-flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilamind-app%2Ffilamind-flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilamind-app%2Ffilamind-flow/lists"}