update docs and app version

Author: ansonl

README.md

@@ -51,9 +51,9 @@ Set up your slicer and printer for MFM by following the steps on each page below
 
 1. [Slicer Setup](slicer-setup.md)
 
-2. [MFM Command Setup](terminal-setup.md) (not needed for GUI)
+2. [MFM Command Setup](terminal-setup.md) ***(Post Processing and Command Line only)***
 
-3. [Options](mfm-configuration-options-setup.md)
+3. [MFM Config Options](mfm-configuration-options-setup.md)
 
 4. [Minimal Toolchange G-code](minimal-toolchange-gcode.md)
 
@@ -89,6 +89,8 @@ Download the [latest GUI release of MFM](https://github.com/ansonl/mfm/releases)
 
 > If a release of MFM has not been built for your OS, you can launch the GUI by [downloading the code](https://github.com/ansonl/mfm/archive/refs/heads/master.zip), navigate to the code folder in the command line and run `python src/gui.py`.
 
+> ⚠️ **The first color change may be set to the wrong color.** If the first color change is incorrect, open the G-code in a text editor and search for `TX` (e.g. `T3`) where `X` is the wrong color index and **replace the first match of `T3` with `T0`** or desired base starting color index. This issue occurs about 50% of the time due to a known 10+ year old Windows Python [bug](https://stackoverflow.com/questions/15934950/python-file-tell-giving-strange-numbers).
+
 ### Printing the G-code file
 
 Put the G-code file exported by your Slicer or MFM on an SD card and put the SD card in your 3D printer or transfer the G-code file to your printer over the network. 

minimal-toolchange-gcode.md

@@ -14,12 +14,15 @@ Current premade printer toolchanges:
 
 - Generic (firmware managed tool change with `T`)
 - Generic Manual (manual filament swap, requires `M600` filament change support in firmware)
-- Bambu X1/P1 series *(Recommended: `bambu-x1-p1-series-long-retraction-107mm3-flush.gcode`)*
+- Bambu X1/P1 series
+  - ***Latest Recommended:***
+    - **Long retract on cut** enabled - `bambu-x1-p1-series-long-retraction-107mm3-flush.gcode`
+    - No long retract - `bambu-x1-p1-series-107mm3-flush.gcode`
 - Bambu A1
 - Bambu A1 mini
 - Prusa XL
 
-Every 3D printer is different and you should manually verify that the provided G-code is compatible with your printer.
+Every 3D printer is different and you should manually verify that the provided G-code is compatible with your printer. I recommend you create your own minimal toolchange G-code using the information in the below section and the premade G-code as a reference.
 
 ## Requirements to Create a Minimal Toolchange
 

slicer-setup.md

@@ -115,3 +115,13 @@ If you plan to do the processing through the standalone MFM GUI app, you can ski
 If you intend to add isolines and using Ironing on the top surface, the standard ironing inset will cover up the isoline color on the outer wall.
 
 Set Ironing inset to your line width (nozzle diameter) multiplied between 1 and 1.25 to not obscure the isolines.
+
+### Flushing Volumes
+
+Slicer generated toolchange flushing volumes are readily mixed between all tools when processed with MFM so it is recommended to **set all flushing volumes to the minimum amount** needed between all colors (e.g. 107mm³) for consistency.
+
+1. Determine the flushing volume between your 4 colors by running this [calibration](https://makerworld.com/en/models/69131).
+
+2. Find the minimum flushing volume needed for any color change. This should be ~107mm³.
+
+3. If any color requires extra flushing volume beyond the minimum flushing volume, add that color index to the comma separated array for the key `extraPurgePreviousColors` the [MFM Config Option JSON file](mfm-configuration-options-setup.md). This will add an additional 150mm³ of flushing volume which can be increased by modifying the hard-coded flushing G-code in `mfm/extra_purge.py`.

src/mfm/app_constants.py

@@ -1,3 +1,3 @@
 APP_NAME_ABBREVIATION = 'MFM'
 APP_NAME = f'3D G-code Map Feature Modifier ({APP_NAME_ABBREVIATION})'
-APP_VERSION = '1.6.3'
+APP_VERSION = '1.6.4'