marlin-config
This is a help tool, intended for easy configuration of Marlin firmware
supported OS: Linux,Mac,Windows
Main features
- instant changing of Configuration*.h files
- quick help for Marlin options and Gcodes
- compilation and uploading your customized firmware
- console for access to serial ports
Features:
- automatically clone repository from github if you don't have it
- instant changing of Configuration*.h files
- allow to filter only changed options overall and for each section
- show help for all options
- show help for G-codes
- show allowed options/gcodes depend to your configuration
- reset configuration changes
- switch between releases and update git repository from github
- upload your old configuration over current
- compile and upload the firmware to your device via PlatformIO
- access to all serial ports using console manager (Linux/Mac with auto ports changing detection)
- simple 3D tool for positioning printer head in console manager
- snippets allow compose the BootScreen, calculate a step values for various stepper motors
- quick navigation with a right sided menu
- create an issue on Marlin github with your configuration
Snippets
- stepper motors calculators (belt driven, screw driven, extruder)
- startup bootscreen preview
- custom bootscreen editor
- sharing UPnP helper with QRcodes
- using your phone as webcam
in project used documentation from MarlinDocumentation
Installation files
(prebuilt with Electron versions) Releases (Mac versions has no console manager)
Dependencies
- git
- PlatformIO (optional)
Using
After run appears a File dialog and asks to open any empty folder (then will be cloning for last version of marlin from github) or folder with the Marlin git repository
Installation NPM
sudo npm -g i marlin-conf
some hints for Windows-Installation
Dependencies
- git
- node.js
- PlatformIO (optional)
Using
open terminal in an empty folder or in a folder with Marlin repository and type
mct
and confirm action
Preview
hints
- In clean/unchanged configuration you can change current release version
- You can drag in browser your Configuration*.h files
mct help
usage: mct help|git|tree|conf|clone
You need to run it in Marlin git repository
commands:
mct
asks to 'clone' if current folder has no repository then run 'conf'
mct conf
open browser for interactive configuration
mct clone
clone current Marlin repository to current working directory
mct git <git-tag> json|h|txt
json: compare [gitroot]/Marlin/Configuration*.h files
between git-tag files and files in folder then
create .json files with your personal setting
h: extend [gitroot]/Marlin/Configuration*.h files
from git-tag with .json files contained your personal setting
txt: like json but create txt files contained only changes
for publication
mct tree json|h|rm
Each of these traverse [gitroot]/Marlin/example_configurations directory
json: compare configurations with main files [gitroot]/Marlin/Configuration*.h
and generate .json file with its differences for each
and .not files for #defines which not present in base files
h: recreate .h files based on
main files [gitroot]/Marlin/Configuration*.h and .json
rm: remove .json and .not files
command interface:
-
creating file for issue publication
mct git 1.1.0-RC7 txt
(compare 1.1.0-RC7 release with your current files in folder and create readable text file) -
migrate configuration:
- with one command you can create .json files with your personal states/values/comments for each #define
- example:
mct git 1.1.0-RC7 json
(compare 1.1.0-RC7 release with your current files in folder and create .json)
-
than copy .json files to another folder or change git branch
-
recover your configuration
- example:
mct git 1.1.0-RC8 h
(use 1.1.0-RC8 release and add your stored in .json configuration)