{"id":13821475,"url":"https://github.com/Frix-x/klippain","last_synced_at":"2025-05-16T12:33:40.578Z","repository":{"id":38354894,"uuid":"357818439","full_name":"Frix-x/klippain","owner":"Frix-x","description":"Generic Klipper configuration for 3D printers","archived":false,"fork":false,"pushed_at":"2024-04-30T19:20:14.000Z","size":17292,"stargazers_count":743,"open_issues_count":68,"forks_count":203,"subscribers_count":25,"default_branch":"main","last_synced_at":"2024-05-01T21:21:42.622Z","etag":null,"topics":["3d-printer","3d-printing","firmware","gcode","gcode-generation","generic-repository","klipper","klipper-configuration","klipper-macros"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/Frix-x.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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":"paypal.me/felixboisselier"}},"created_at":"2021-04-14T07:44:24.000Z","updated_at":"2024-05-03T09:06:44.371Z","dependencies_parsed_at":"2023-02-19T12:31:18.155Z","dependency_job_id":"b100495f-7079-48cc-aa22-9ab7941f144c","html_url":"https://github.com/Frix-x/klippain","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frix-x%2Fklippain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frix-x%2Fklippain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frix-x%2Fklippain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Frix-x%2Fklippain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Frix-x","download_url":"https://codeload.github.com/Frix-x/klippain/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254530757,"owners_count":22086673,"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","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","firmware","gcode","gcode-generation","generic-repository","klipper","klipper-configuration","klipper-macros"],"created_at":"2024-08-04T08:01:22.551Z","updated_at":"2025-05-16T12:33:35.568Z","avatar_url":"https://github.com/Frix-x.png","language":"Shell","funding_links":["paypal.me/felixboisselier"],"categories":["Shell"],"sub_categories":[],"readme":"# Klippain\n\n\u003e Klippain - The pain-free recipe for (french)bread and butter Klipper configuration!\n\nKlippain is a generic, modular, and highly customizable Klipper configuration for 3D printers. Designed for use on various machines such as Cartesian, CoreXY and CoreXZ, it has been reported working correctly on Voron V2.4, Voron Trident, Voron V0, Voron SwitchWire, TriZero, VZbot, Ender5, Ender3, Prusas, etc...\n\n![Klippain](./docs/klippain.png)\n\nKlippain is regularly updated with new features and merged PRs from users. You can reach me on the Voron Discord as **Frix_x#0161**.\n\nFun fact: \"pain\" \\pɛ̃\\ is the French word for bread, so there's no pain in this pain—only joy! Thanks to the French channel \"honhonhonbaguette-FR\" on the Voron Discord for the joke and name suggestion!\n\n\n## Features\n\nKlippain is designed for versatility. By selecting and enabling the desired hardware and software options, it can be used on a wide range of machines.\n\nCustom features available out of the box include a full featured set of standard macros, **adaptive bed mesh**, **custom printer calibrations**, **automated input shaper workflows**, and **vibration measurement** macros and scripts, ... Refer to the [features documentation](./docs/features.md) for a detailed list and usage instructions.\n\n\n## Installation\n\nTo install Klippain, first ensure you have already Klipper, Moonraker, and a WebUI installed on your printer. If not, you can use [KIAUH](https://github.com/th33xitus/kiauh).\n\nThen, run the installation script using the following command over SSH. This script will backup your old configuration, download this GitHub repository to your RaspberryPi home directory, and set up Klippain in `~/printer_data/config`. You will also be prompted to select and install MCU board_pins templates. This is recommended for faster `mcu.cfg` setup, but you can do it manually later if you prefer.\n\n```bash\nwget -O - https://raw.githubusercontent.com/Frix-x/klippain/main/install.sh | bash\n```\n\nFinally, Klippain requires a few simple steps to configure and customize it for your printer: please follow the [configuration guide](./docs/configuration.md).\n\n  \u003e **Warning**:\n  \u003e\n  \u003e General rule to keep the auto-update feature working: **never modify Klippain files directly**, but instead add overrides as per [the documentation](./docs/overrides.md)! To proceed, you can modify all the pre-installed templates in your config root folder (`printer.cfg`, `mcu.cfg`, `variables.cfg` and `overrides.cfg`) as they will be preserved on update.\n\n\n## Removing Klippain\n\nIn case Klippain doesn't suit your needs or if you installed it by mistake, you can easily remove Klippain and revert to your previous configuration by using the automated uninstall script. During the uninstallation process, the script will remove all specific Klippain files and configurations. Additionally, you will be given an option to restore your previously backed-up configuration, allowing your printer to return to its last working state (from before Klippain was installed).\n\nTo run the uninstall script, execute the following command over SSH:\n\n```bash\nwget -O - https://raw.githubusercontent.com/Frix-x/klippain/main/uninstall.sh | bash\n```\n\n  \u003e **Note**:\n  \u003e\n  \u003e All backups are preserved during the uninstallation process. So, you can easily revert back at any time if you wish to :stuck_out_tongue_winking_eye:\n\n\n## Support the Project\n\nI strive to accommodate user requests that align with this configuration's design. Feel free to open an issue or a PR for specific hardware device support or new features.\n\nAlternatively, consider buying me a coffee or contributing to new hardware purchases to support my work!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFrix-x%2Fklippain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFrix-x%2Fklippain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFrix-x%2Fklippain/lists"}