diff --git a/.DS_Store b/.DS_Store
index 6e6adac..7f84dd0 100644
Binary files a/.DS_Store and b/.DS_Store differ
diff --git a/404.html b/404.html
index 899b968..5da6ae1 100644
--- a/404.html
+++ b/404.html
@@ -85,7 +85,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -137,7 +137,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -813,6 +813,8 @@ <h1>404 - Not found</h1>
       
         <footer class="md-footer">
   
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -823,6 +825,21 @@ <h1>404 - Not found</h1>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -835,7 +852,7 @@ <h1>404 - Not found</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "/DynamicMacros/", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "/DynamicMacros/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "/DynamicMacros/", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "/DynamicMacros/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="/DynamicMacros/assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/devstatus/index.html b/devstatus/index.html
index 9b6065f..abd5cd3 100644
--- a/devstatus/index.html
+++ b/devstatus/index.html
@@ -89,7 +89,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -146,7 +146,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1008,6 +1008,30 @@ <h2 id="planned-features">Planned Features</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../examples/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Example Macros">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Example Macros
+              </div>
+            </div>
+          </a>
+        
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1018,6 +1042,21 @@ <h2 id="planned-features">Planned Features</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1030,7 +1069,7 @@ <h2 id="planned-features">Planned Features</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/examples/index.html b/examples/index.html
index 60f9113..22034c2 100644
--- a/examples/index.html
+++ b/examples/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1139,6 +1139,46 @@ <h2 id="preserving-variables">Preserving Variables</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../extras/extras-ex3/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Example 3: KlipperMaintenance">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Example 3: KlipperMaintenance
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../devstatus/" class="md-footer__link md-footer__link--next" aria-label="Next: Development Status">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Development Status
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1149,6 +1189,21 @@ <h2 id="preserving-variables">Preserving Variables</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1161,7 +1216,7 @@ <h2 id="preserving-variables">Preserving Variables</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/extras/extras-ex1/index.html b/extras/extras-ex1/index.html
index 68d964f..bc70c97 100644
--- a/extras/extras-ex1/index.html
+++ b/extras/extras-ex1/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -953,10 +953,6 @@
 
 
 <h1 id="example-1-greeter-structure">Example 1: Greeter (Structure)</h1>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This page is under construction.</p>
-</div>
 <p>Before you start to write a Klippy extra, it is important to understand the structure of a Klippy extra. </p>
 <hr />
 <p>In Python, a Klippy extra is defined as a class, then referenced in a function at the end of the file. Example:</p>
@@ -1118,7 +1114,7 @@ <h2 id="other-things">Other Things</h2>
 </ul>
 <hr />
 <p>Next example:</p>
-<p><a class="md-button" href="../extras-ex2/">Example 2: BetterGreeter <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z"/></svg></span></a></p>
+<p><a class="md-button" href="../extras-ex2/">Example 2: BetterGreeter <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p>
 
 
 
@@ -1186,6 +1182,46 @@ <h2 id="other-things">Other Things</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../extras-start/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Start Writing Klippy Extras">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Start Writing Klippy Extras
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../extras-ex2/" class="md-footer__link md-footer__link--next" aria-label="Next: Example 2: BetterGreeter">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Example 2: BetterGreeter
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1196,6 +1232,21 @@ <h2 id="other-things">Other Things</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1208,7 +1259,7 @@ <h2 id="other-things">Other Things</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/extras/extras-ex2/index.html b/extras/extras-ex2/index.html
index 88ee314..6332b65 100644
--- a/extras/extras-ex2/index.html
+++ b/extras/extras-ex2/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -989,10 +989,6 @@
 
 
 <h1 id="example-2-bettergreeter">Example 2: BetterGreeter</h1>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This page is under construction.</p>
-</div>
 <p>For this tutorial, we are going to improve on the greeter code used in <a href="../extras-ex1/">Structure</a>. </p>
 <p>For reference, the entire original greeter code is below:</p>
 <details open="open">
@@ -1134,6 +1130,19 @@ <h2 id="reading-the-configuration">Reading the Configuration</h2>
 </span><a id="__codelineno-4-8" name="__codelineno-4-8"></a><span class="hll">        <span class="bp">self</span><span class="o">.</span><span class="n">message</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;message&#39;</span><span class="p">,</span> <span class="s1">&#39;Welcome to Klipper!&#39;</span><span class="p">)</span>
 </span><a id="__codelineno-4-9" name="__codelineno-4-9"></a><span class="hll">        <span class="bp">self</span><span class="o">.</span><span class="n">delay</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">getint</span><span class="p">(</span><span class="s1">&#39;delay&#39;</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
+<div class="admonition question inline end">
+<p class="admonition-title">Quiz</p>
+<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Question</label><label for="__tabbed_1_2">Answer</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
+<p>If there was a configuration option (int) named <code>repeats</code>, how would you get it in the initializer?</p>
+</div>
+<div class="tabbed-block">
+<p><code class="highlight"><span class="n">config</span><span class="o">.</span><span class="n">getint</span><span class="p">(</span><span class="s1">&#39;repeats&#39;</span><span class="p">)</span></code></p>
+</div>
+</div>
+</div>
+</div>
 <p>Here, the <code>printer</code>, <code>reactor</code>, <code>gcode</code>, and <code>message</code> variables are the same as in the previous Klippy extra. However, in this case, there are a couple new variables:</p>
 <ul>
 <li><code>name</code> is explained in <a href="../extras-ex1/#other-things">the last section of Structure</a>.</li>
@@ -1350,6 +1359,10 @@ <h2 id="functions">Functions</h2>
 <ol>
 <li>This is passed by Klippy when it calls <code>_greet()</code> after the timer occurs.</li>
 </ol>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>If you want the timer function to repeat, you can return the provided <code>eventtime</code> plus any number of seconds in the future, and it will repeat.</p>
+</div>
 <hr />
 <p>The final function in this class is the <code>cmd_GREETING</code> function:</p>
 <div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">greeting.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-9-1"> 1</a></span>
@@ -1494,7 +1507,7 @@ <h2 id="full-code">Full Code</h2>
 <p>You can install it following <a href="../extras-ex1/#install">these</a> instructions, replacing <code>greeter.py</code> with <code>greeting.py</code>.</p>
 <hr />
 <p>Last example (so far):</p>
-<p><a class="md-button" href="../extras-ex3/">Example 3: KlipperMaintenance <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 407 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="m372 232.5-3.7-6.5c.1-46.4-21.4-65.3-46.5-79.7 7.6-2 15.4-3.6 17.6-13.2 13.1-3.3 15.8-9.4 17.1-15.8 3.4-2.3 14.8-8.7 13.6-19.7 6.4-4.4 10-10.1 8.1-18.1 6.9-7.5 8.7-13.7 5.8-19.4 8.3-10.3 4.6-15.6 1.1-20.9 6.2-11.2.7-23.2-16.6-21.2-6.9-10.1-21.9-7.8-24.2-7.8-2.6-3.2-6-6-16.5-4.7-6.8-6.1-14.4-5-22.3-2.1-9.3-7.3-15.5-1.4-22.6.8C271.6.6 269 5.5 263.5 7.6c-12.3-2.6-16.1 3-22 8.9l-6.9-.1c-18.6 10.8-27.8 32.8-31.1 44.1-3.3-11.3-12.5-33.3-31.1-44.1l-6.9.1c-5.9-5.9-9.7-11.5-22-8.9-5.6-2-8.1-7-19.4-3.4-4.6-1.4-8.9-4.4-13.9-4.3-2.6.1-5.5 1-8.7 3.5-7.9-3-15.5-4-22.3 2.1-10.5-1.3-14 1.4-16.5 4.7-2.3 0-17.3-2.3-24.2 7.8C21.2 16 15.8 28 22 39.2c-3.5 5.4-7.2 10.7 1.1 20.9-2.9 5.7-1.1 11.9 5.8 19.4-1.8 8 1.8 13.7 8.1 18.1-1.2 11 10.2 17.4 13.6 19.7 1.3 6.4 4 12.4 17.1 15.8 2.2 9.5 10 11.2 17.6 13.2-25.1 14.4-46.6 33.3-46.5 79.7l-3.7 6.5c-28.8 17.2-54.7 72.7-14.2 117.7 2.6 14.1 7.1 24.2 11 35.4 5.9 45.2 44.5 66.3 54.6 68.8 14.9 11.2 30.8 21.8 52.2 29.2C159 504.2 181 512 203 512h1c22.1 0 44-7.8 64.2-28.4 21.5-7.4 37.3-18 52.2-29.2 10.2-2.5 48.7-23.6 54.6-68.8 3.9-11.2 8.4-21.3 11-35.4 40.6-45.1 14.7-100.5-14-117.7zm-22.2-8c-1.5 18.7-98.9-65.1-82.1-67.9 45.7-7.5 83.6 19.2 82.1 67.9zm-43 93.1c-24.5 15.8-59.8 5.6-78.8-22.8s-14.6-64.2 9.9-80c24.5-15.8 59.8-5.6 78.8 22.8s14.6 64.2-9.9 80zM238.9 29.3c.8 4.2 1.8 6.8 2.9 7.6 5.4-5.8 9.8-11.7 16.8-17.3 0 3.3-1.7 6.8 2.5 9.4 3.7-5 8.8-9.5 15.5-13.3-3.2 5.6-.6 7.3 1.2 9.6 5.1-4.4 10-8.8 19.4-12.3-2.6 3.1-6.2 6.2-2.4 9.8 5.3-3.3 10.6-6.6 23.1-8.9-2.8 3.1-8.7 6.3-5.1 9.4 6.6-2.5 14-4.4 22.1-5.4-3.9 3.2-7.1 6.3-3.9 8.8 7.1-2.2 16.9-5.1 26.4-2.6l-6 6.1c-.7.8 14.1.6 23.9.8-3.6 5-7.2 9.7-9.3 18.2 1 1 5.8.4 10.4 0-4.7 9.9-12.8 12.3-14.7 16.6 2.9 2.2 6.8 1.6 11.2.1-3.4 6.9-10.4 11.7-16 17.3 1.4 1 3.9 1.6 9.7.9-5.2 5.5-11.4 10.5-18.8 15 1.3 1.5 5.8 1.5 10 1.6-6.7 6.5-15.3 9.9-23.4 14.2 4 2.7 6.9 2.1 10 2.1-5.7 4.7-15.4 7.1-24.4 10 1.7 2.7 3.4 3.4 7.1 4.1-9.5 5.3-23.2 2.9-27 5.6.9 2.7 3.6 4.4 6.7 5.8-15.4.9-57.3-.6-65.4-32.3 15.7-17.3 44.4-37.5 93.7-62.6-38.4 12.8-73 30-102 53.5-34.3-15.9-10.8-55.9 5.8-71.8zm-34.4 114.6c24.2-.3 54.1 17.8 54 34.7-.1 15-21 27.1-53.8 26.9-32.1-.4-53.7-15.2-53.6-29.8 0-11.9 26.2-32.5 53.4-31.8zm-123-12.8c3.7-.7 5.4-1.5 7.1-4.1-9-2.8-18.7-5.3-24.4-10 3.1 0 6 .7 10-2.1-8.1-4.3-16.7-7.7-23.4-14.2 4.2-.1 8.7 0 10-1.6-7.4-4.5-13.6-9.5-18.8-15 5.8.7 8.3.1 9.7-.9-5.6-5.6-12.7-10.4-16-17.3 4.3 1.5 8.3 2 11.2-.1-1.9-4.2-10-6.7-14.7-16.6 4.6.4 9.4 1 10.4 0-2.1-8.5-5.8-13.3-9.3-18.2 9.8-.1 24.6 0 23.9-.8l-6-6.1c9.5-2.5 19.3.4 26.4 2.6 3.2-2.5-.1-5.6-3.9-8.8 8.1 1.1 15.4 2.9 22.1 5.4 3.5-3.1-2.3-6.3-5.1-9.4 12.5 2.3 17.8 5.6 23.1 8.9 3.8-3.6.2-6.7-2.4-9.8 9.4 3.4 14.3 7.9 19.4 12.3 1.7-2.3 4.4-4 1.2-9.6 6.7 3.8 11.8 8.3 15.5 13.3 4.1-2.6 2.5-6.2 2.5-9.4 7 5.6 11.4 11.5 16.8 17.3 1.1-.8 2-3.4 2.9-7.6 16.6 15.9 40.1 55.9 6 71.8-29-23.5-63.6-40.7-102-53.5 49.3 25 78 45.3 93.7 62.6-8 31.8-50 33.2-65.4 32.3 3.1-1.4 5.8-3.2 6.7-5.8-4-2.8-17.6-.4-27.2-5.6zm60.1 24.1c16.8 2.8-80.6 86.5-82.1 67.9-1.5-48.7 36.5-75.5 82.1-67.9zM38.2 342c-23.7-18.8-31.3-73.7 12.6-98.3 26.5-7 9 107.8-12.6 98.3zm91 98.2c-13.3 7.9-45.8 4.7-68.8-27.9-15.5-27.4-13.5-55.2-2.6-63.4 16.3-9.8 41.5 3.4 60.9 25.6 16.9 20 24.6 55.3 10.5 65.7zm-26.4-119.7c-24.5-15.8-28.9-51.6-9.9-80s54.3-38.6 78.8-22.8 28.9 51.6 9.9 80c-19.1 28.4-54.4 38.6-78.8 22.8zM205 496c-29.4 1.2-58.2-23.7-57.8-32.3-.4-12.7 35.8-22.6 59.3-22 23.7-1 55.6 7.5 55.7 18.9.5 11-28.8 35.9-57.2 35.4zm58.9-124.9c.2 29.7-26.2 53.8-58.8 54-32.6.2-59.2-23.8-59.4-53.4v-.6c-.2-29.7 26.2-53.8 58.8-54 32.6-.2 59.2 23.8 59.4 53.4v.6zm82.2 42.7c-25.3 34.6-59.6 35.9-72.3 26.3-13.3-12.4-3.2-50.9 15.1-72 20.9-23.3 43.3-38.5 58.9-26.6 10.5 10.3 16.7 49.1-1.7 72.3zm22.9-73.2c-21.5 9.4-39-105.3-12.6-98.3 43.9 24.7 36.3 79.6 12.6 98.3z"/></svg></span></a></p>
+<p><a class="md-button" href="../extras-ex3/">Example 3: KlipperMaintenance <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p>
 
 
 
@@ -1562,6 +1575,46 @@ <h2 id="full-code">Full Code</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../extras-ex1/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Example 1: Greeter (Structure)">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Example 1: Greeter (Structure)
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../extras-ex3/" class="md-footer__link md-footer__link--next" aria-label="Next: Example 3: KlipperMaintenance">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Example 3: KlipperMaintenance
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1572,6 +1625,21 @@ <h2 id="full-code">Full Code</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1584,7 +1652,7 @@ <h2 id="full-code">Full Code</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/extras/extras-ex3/index.html b/extras/extras-ex3/index.html
index e8552f8..3d152db 100644
--- a/extras/extras-ex3/index.html
+++ b/extras/extras-ex3/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1457,6 +1457,44 @@ <h3 id="initializer">Initializer</h3>
 <li><strong>Third highlighted section:</strong> Register GCode commands</li>
 </ul>
 <p>The line <code class="highlight"><span class="bp">self</span><span class="o">.</span><span class="n">init_db</span><span class="p">()</span></code> will be explained later in functions.</p>
+<div class="admonition question">
+<p class="admonition-title">Quiz</p>
+<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Question</label><label for="__tabbed_1_2">Answer</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
+<p>How would you add another trigger type (called <code class="highlight"><span class="s2">&quot;axes_distance&quot;</span></code> with units <code class="highlight"><span class="s2">&quot;m&quot;</span></code>)?</p>
+</div>
+<div class="tabbed-block">
+<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-3-1"> 1</a></span>
+<span class="normal"><a href="#__codelineno-3-2"> 2</a></span>
+<span class="normal"><a href="#__codelineno-3-3"> 3</a></span>
+<span class="normal"><a href="#__codelineno-3-4"> 4</a></span>
+<span class="normal"><a href="#__codelineno-3-5"> 5</a></span>
+<span class="normal"><a href="#__codelineno-3-6"> 6</a></span>
+<span class="normal"><a href="#__codelineno-3-7"> 7</a></span>
+<span class="normal"><a href="#__codelineno-3-8"> 8</a></span>
+<span class="normal"><a href="#__codelineno-3-9"> 9</a></span>
+<span class="normal"><a href="#__codelineno-3-10">10</a></span>
+<span class="normal"><a href="#__codelineno-3-11">11</a></span>
+<span class="normal"><a href="#__codelineno-3-12">12</a></span>
+<span class="normal"><a href="#__codelineno-3-13">13</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1"></a><span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">getchoice</span><span class="p">(</span><span class="s1">&#39;trigger&#39;</span><span class="p">,</span> <span class="p">[</span>
+<a id="__codelineno-3-2" name="__codelineno-3-2"></a>    <span class="s1">&#39;print_time&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-3" name="__codelineno-3-3"></a>    <span class="s1">&#39;filament&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-4" name="__codelineno-3-4"></a>    <span class="s1">&#39;time&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-5" name="__codelineno-3-5"></a><span class="hll">    <span class="s1">&#39;axes_distance&#39;</span><span class="p">])</span>
+</span><a id="__codelineno-3-6" name="__codelineno-3-6"></a><span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-3-7" name="__codelineno-3-7"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;h&#39;</span>
+<a id="__codelineno-3-8" name="__codelineno-3-8"></a><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span>
+<a id="__codelineno-3-9" name="__codelineno-3-9"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;m&#39;</span>
+<a id="__codelineno-3-10" name="__codelineno-3-10"></a><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span>
+<a id="__codelineno-3-11" name="__codelineno-3-11"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;h&#39;</span>
+<a id="__codelineno-3-12" name="__codelineno-3-12"></a><span class="hll"><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;axes_distance&#39;</span><span class="p">:</span>
+</span><a id="__codelineno-3-13" name="__codelineno-3-13"></a><span class="hll">    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;m&#39;</span>
+</span></code></pre></div></td></tr></table></div>
+</div>
+</div>
+</div>
+</div>
 <h3 id="functions">Functions</h3>
 <p>The next part of the <code>Maintain</code> class is its functions. The functions in this class are, broken down into two sections:</p>
 <p><strong>Database:</strong></p>
@@ -1473,101 +1511,101 @@ <h3 id="functions">Functions</h3>
 <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li>
 </ul>
 <p>First, the database functions (again, plus signs throughout the code explain in more detail what each part does):</p>
-<div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">maintain.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-3-1"> 1</a></span>
-<span class="normal"><a href="#__codelineno-3-2"> 2</a></span>
-<span class="normal"><a href="#__codelineno-3-3"> 3</a></span>
-<span class="normal"><a href="#__codelineno-3-4"> 4</a></span>
-<span class="normal"><a href="#__codelineno-3-5"> 5</a></span>
-<span class="normal"><a href="#__codelineno-3-6"> 6</a></span>
-<span class="normal"><a href="#__codelineno-3-7"> 7</a></span>
-<span class="normal"><a href="#__codelineno-3-8"> 8</a></span>
-<span class="normal"><a href="#__codelineno-3-9"> 9</a></span>
-<span class="normal"><a href="#__codelineno-3-10">10</a></span>
-<span class="normal"><a href="#__codelineno-3-11">11</a></span>
-<span class="normal"><a href="#__codelineno-3-12">12</a></span>
-<span class="normal"><a href="#__codelineno-3-13">13</a></span>
-<span class="normal"><a href="#__codelineno-3-14">14</a></span>
-<span class="normal"><a href="#__codelineno-3-15">15</a></span>
-<span class="normal"><a href="#__codelineno-3-16">16</a></span>
-<span class="normal"><a href="#__codelineno-3-17">17</a></span>
-<span class="normal"><a href="#__codelineno-3-18">18</a></span>
-<span class="normal"><a href="#__codelineno-3-19">19</a></span>
-<span class="normal"><a href="#__codelineno-3-20">20</a></span>
-<span class="normal"><a href="#__codelineno-3-21">21</a></span>
-<span class="normal"><a href="#__codelineno-3-22">22</a></span>
-<span class="normal"><a href="#__codelineno-3-23">23</a></span>
-<span class="normal"><a href="#__codelineno-3-24">24</a></span>
-<span class="normal"><a href="#__codelineno-3-25">25</a></span>
-<span class="normal"><a href="#__codelineno-3-26">26</a></span>
-<span class="normal"><a href="#__codelineno-3-27">27</a></span>
-<span class="normal"><a href="#__codelineno-3-28">28</a></span>
-<span class="normal"><a href="#__codelineno-3-29">29</a></span>
-<span class="normal"><a href="#__codelineno-3-30">30</a></span>
-<span class="normal"><a href="#__codelineno-3-31">31</a></span>
-<span class="normal"><a href="#__codelineno-3-32">32</a></span>
-<span class="normal"><a href="#__codelineno-3-33">33</a></span>
-<span class="normal"><a href="#__codelineno-3-34">34</a></span>
-<span class="normal"><a href="#__codelineno-3-35">35</a></span>
-<span class="normal"><a href="#__codelineno-3-36">36</a></span>
-<span class="normal"><a href="#__codelineno-3-37">37</a></span>
-<span class="normal"><a href="#__codelineno-3-38">38</a></span>
-<span class="normal"><a href="#__codelineno-3-39">39</a></span>
-<span class="normal"><a href="#__codelineno-3-40">40</a></span>
-<span class="normal"><a href="#__codelineno-3-41">41</a></span>
-<span class="normal"><a href="#__codelineno-3-42">42</a></span>
-<span class="normal"><a href="#__codelineno-3-43">43</a></span>
-<span class="normal"><a href="#__codelineno-3-44">44</a></span>
-<span class="normal"><a href="#__codelineno-3-45">45</a></span>
-<span class="normal"><a href="#__codelineno-3-46">46</a></span>
-<span class="normal"><a href="#__codelineno-3-47">47</a></span>
-<span class="normal"><a href="#__codelineno-3-48">48</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1"></a><span class="k">class</span> <span class="nc">Maintain</span><span class="p">:</span>
-<a id="__codelineno-3-2" name="__codelineno-3-2"></a>    <span class="o">...</span>
-<a id="__codelineno-3-3" name="__codelineno-3-3"></a>    <span class="k">def</span> <span class="nf">fetch_history</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-4" name="__codelineno-3-4"></a>        <span class="n">resp</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="n">API_URL</span><span class="p">)</span> <span class="c1"># fetch data from Moonraker History API</span>
-<a id="__codelineno-3-5" name="__codelineno-3-5"></a>        <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-6" name="__codelineno-3-6"></a>            <span class="n">json_data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">())</span> 
-<a id="__codelineno-3-7" name="__codelineno-3-7"></a>        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-<a id="__codelineno-3-8" name="__codelineno-3-8"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">gcode</span><span class="o">.</span><span class="n">respond_info</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Data </span><span class="si">{</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
-<a id="__codelineno-3-9" name="__codelineno-3-9"></a>            <span class="k">return</span> <span class="p">{</span>
-<a id="__codelineno-3-10" name="__codelineno-3-10"></a>                <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
-<a id="__codelineno-3-11" name="__codelineno-3-11"></a>                <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
-<a id="__codelineno-3-12" name="__codelineno-3-12"></a>                <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
-<a id="__codelineno-3-13" name="__codelineno-3-13"></a>            <span class="p">}</span> <span class="c1"># (1)!</span>
-<a id="__codelineno-3-14" name="__codelineno-3-14"></a>
-<a id="__codelineno-3-15" name="__codelineno-3-15"></a>        <span class="n">job_totals</span> <span class="o">=</span> <span class="n">json_data</span><span class="p">[</span><span class="s1">&#39;result&#39;</span><span class="p">][</span><span class="s1">&#39;job_totals&#39;</span><span class="p">]</span> <span class="c1"># get job totals from JSON response</span>
-<a id="__codelineno-3-16" name="__codelineno-3-16"></a>        <span class="k">return</span> <span class="p">{</span>
-<a id="__codelineno-3-17" name="__codelineno-3-17"></a>            <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_time&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">3600</span><span class="p">,</span>
-<a id="__codelineno-3-18" name="__codelineno-3-18"></a>            <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_filament_used&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">1000</span><span class="p">,</span>
-<a id="__codelineno-3-19" name="__codelineno-3-19"></a>            <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
-<a id="__codelineno-3-20" name="__codelineno-3-20"></a>        <span class="p">}</span> <span class="c1"># (2)!</span>
-<a id="__codelineno-3-21" name="__codelineno-3-21"></a>
-<a id="__codelineno-3-22" name="__codelineno-3-22"></a>    <span class="k">def</span> <span class="nf">init_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-23" name="__codelineno-3-23"></a>        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_db</span><span class="p">()</span> <span class="c1"># Load the database</span>
-<a id="__codelineno-3-24" name="__codelineno-3-24"></a>        <span class="k">if</span> <span class="n">data</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-<a id="__codelineno-3-25" name="__codelineno-3-25"></a>            <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_history</span><span class="p">()</span>
-<a id="__codelineno-3-26" name="__codelineno-3-26"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">update_db</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="c1"># Update the database with history data</span>
-<a id="__codelineno-3-27" name="__codelineno-3-27"></a>
-<a id="__codelineno-3-28" name="__codelineno-3-28"></a>    <span class="k">def</span> <span class="nf">fetch_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-29" name="__codelineno-3-29"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
-<a id="__codelineno-3-30" name="__codelineno-3-30"></a>        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">path</span><span class="p">):</span>
-<a id="__codelineno-3-31" name="__codelineno-3-31"></a>            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span>
-<a id="__codelineno-3-32" name="__codelineno-3-32"></a>                <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-33" name="__codelineno-3-33"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
-<a id="__codelineno-3-34" name="__codelineno-3-34"></a>                <span class="k">except</span><span class="p">:</span>
-<a id="__codelineno-3-35" name="__codelineno-3-35"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
-<a id="__codelineno-3-36" name="__codelineno-3-36"></a>                <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return parsed data</span>
-<a id="__codelineno-3-37" name="__codelineno-3-37"></a>
-<a id="__codelineno-3-38" name="__codelineno-3-38"></a>    <span class="k">def</span> <span class="nf">update_db</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span>
-<a id="__codelineno-3-39" name="__codelineno-3-39"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
-<a id="__codelineno-3-40" name="__codelineno-3-40"></a>        <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">path</span><span class="p">),</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="c1"># (4)!</span>
-<a id="__codelineno-3-41" name="__codelineno-3-41"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;w+&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span> <span class="c1"># The &quot;w+&quot; file operator allows reading and writing</span>
-<a id="__codelineno-3-42" name="__codelineno-3-42"></a>            <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-43" name="__codelineno-3-43"></a>                <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
-<a id="__codelineno-3-44" name="__codelineno-3-44"></a>            <span class="k">except</span><span class="p">:</span>
-<a id="__codelineno-3-45" name="__codelineno-3-45"></a>                <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
-<a id="__codelineno-3-46" name="__codelineno-3-46"></a>            <span class="n">data</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> <span class="c1"># Update the file contents with the new data</span>
-<a id="__codelineno-3-47" name="__codelineno-3-47"></a>            <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">file</span><span class="p">)</span> <span class="c1"># JSON write the new data to the file</span>
-<a id="__codelineno-3-48" name="__codelineno-3-48"></a>        <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return the new updated data</span>
+<div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">maintain.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-4-1"> 1</a></span>
+<span class="normal"><a href="#__codelineno-4-2"> 2</a></span>
+<span class="normal"><a href="#__codelineno-4-3"> 3</a></span>
+<span class="normal"><a href="#__codelineno-4-4"> 4</a></span>
+<span class="normal"><a href="#__codelineno-4-5"> 5</a></span>
+<span class="normal"><a href="#__codelineno-4-6"> 6</a></span>
+<span class="normal"><a href="#__codelineno-4-7"> 7</a></span>
+<span class="normal"><a href="#__codelineno-4-8"> 8</a></span>
+<span class="normal"><a href="#__codelineno-4-9"> 9</a></span>
+<span class="normal"><a href="#__codelineno-4-10">10</a></span>
+<span class="normal"><a href="#__codelineno-4-11">11</a></span>
+<span class="normal"><a href="#__codelineno-4-12">12</a></span>
+<span class="normal"><a href="#__codelineno-4-13">13</a></span>
+<span class="normal"><a href="#__codelineno-4-14">14</a></span>
+<span class="normal"><a href="#__codelineno-4-15">15</a></span>
+<span class="normal"><a href="#__codelineno-4-16">16</a></span>
+<span class="normal"><a href="#__codelineno-4-17">17</a></span>
+<span class="normal"><a href="#__codelineno-4-18">18</a></span>
+<span class="normal"><a href="#__codelineno-4-19">19</a></span>
+<span class="normal"><a href="#__codelineno-4-20">20</a></span>
+<span class="normal"><a href="#__codelineno-4-21">21</a></span>
+<span class="normal"><a href="#__codelineno-4-22">22</a></span>
+<span class="normal"><a href="#__codelineno-4-23">23</a></span>
+<span class="normal"><a href="#__codelineno-4-24">24</a></span>
+<span class="normal"><a href="#__codelineno-4-25">25</a></span>
+<span class="normal"><a href="#__codelineno-4-26">26</a></span>
+<span class="normal"><a href="#__codelineno-4-27">27</a></span>
+<span class="normal"><a href="#__codelineno-4-28">28</a></span>
+<span class="normal"><a href="#__codelineno-4-29">29</a></span>
+<span class="normal"><a href="#__codelineno-4-30">30</a></span>
+<span class="normal"><a href="#__codelineno-4-31">31</a></span>
+<span class="normal"><a href="#__codelineno-4-32">32</a></span>
+<span class="normal"><a href="#__codelineno-4-33">33</a></span>
+<span class="normal"><a href="#__codelineno-4-34">34</a></span>
+<span class="normal"><a href="#__codelineno-4-35">35</a></span>
+<span class="normal"><a href="#__codelineno-4-36">36</a></span>
+<span class="normal"><a href="#__codelineno-4-37">37</a></span>
+<span class="normal"><a href="#__codelineno-4-38">38</a></span>
+<span class="normal"><a href="#__codelineno-4-39">39</a></span>
+<span class="normal"><a href="#__codelineno-4-40">40</a></span>
+<span class="normal"><a href="#__codelineno-4-41">41</a></span>
+<span class="normal"><a href="#__codelineno-4-42">42</a></span>
+<span class="normal"><a href="#__codelineno-4-43">43</a></span>
+<span class="normal"><a href="#__codelineno-4-44">44</a></span>
+<span class="normal"><a href="#__codelineno-4-45">45</a></span>
+<span class="normal"><a href="#__codelineno-4-46">46</a></span>
+<span class="normal"><a href="#__codelineno-4-47">47</a></span>
+<span class="normal"><a href="#__codelineno-4-48">48</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1"></a><span class="k">class</span> <span class="nc">Maintain</span><span class="p">:</span>
+<a id="__codelineno-4-2" name="__codelineno-4-2"></a>    <span class="o">...</span>
+<a id="__codelineno-4-3" name="__codelineno-4-3"></a>    <span class="k">def</span> <span class="nf">fetch_history</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-4" name="__codelineno-4-4"></a>        <span class="n">resp</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="n">API_URL</span><span class="p">)</span> <span class="c1"># fetch data from Moonraker History API</span>
+<a id="__codelineno-4-5" name="__codelineno-4-5"></a>        <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-6" name="__codelineno-4-6"></a>            <span class="n">json_data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">())</span> 
+<a id="__codelineno-4-7" name="__codelineno-4-7"></a>        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+<a id="__codelineno-4-8" name="__codelineno-4-8"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">gcode</span><span class="o">.</span><span class="n">respond_info</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Data </span><span class="si">{</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
+<a id="__codelineno-4-9" name="__codelineno-4-9"></a>            <span class="k">return</span> <span class="p">{</span>
+<a id="__codelineno-4-10" name="__codelineno-4-10"></a>                <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+<a id="__codelineno-4-11" name="__codelineno-4-11"></a>                <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+<a id="__codelineno-4-12" name="__codelineno-4-12"></a>                <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
+<a id="__codelineno-4-13" name="__codelineno-4-13"></a>            <span class="p">}</span> <span class="c1"># (1)!</span>
+<a id="__codelineno-4-14" name="__codelineno-4-14"></a>
+<a id="__codelineno-4-15" name="__codelineno-4-15"></a>        <span class="n">job_totals</span> <span class="o">=</span> <span class="n">json_data</span><span class="p">[</span><span class="s1">&#39;result&#39;</span><span class="p">][</span><span class="s1">&#39;job_totals&#39;</span><span class="p">]</span> <span class="c1"># get job totals from JSON response</span>
+<a id="__codelineno-4-16" name="__codelineno-4-16"></a>        <span class="k">return</span> <span class="p">{</span>
+<a id="__codelineno-4-17" name="__codelineno-4-17"></a>            <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_time&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">3600</span><span class="p">,</span>
+<a id="__codelineno-4-18" name="__codelineno-4-18"></a>            <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_filament_used&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">1000</span><span class="p">,</span>
+<a id="__codelineno-4-19" name="__codelineno-4-19"></a>            <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
+<a id="__codelineno-4-20" name="__codelineno-4-20"></a>        <span class="p">}</span> <span class="c1"># (2)!</span>
+<a id="__codelineno-4-21" name="__codelineno-4-21"></a>
+<a id="__codelineno-4-22" name="__codelineno-4-22"></a>    <span class="k">def</span> <span class="nf">init_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-23" name="__codelineno-4-23"></a>        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_db</span><span class="p">()</span> <span class="c1"># Load the database</span>
+<a id="__codelineno-4-24" name="__codelineno-4-24"></a>        <span class="k">if</span> <span class="n">data</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+<a id="__codelineno-4-25" name="__codelineno-4-25"></a>            <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_history</span><span class="p">()</span>
+<a id="__codelineno-4-26" name="__codelineno-4-26"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">update_db</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="c1"># Update the database with history data</span>
+<a id="__codelineno-4-27" name="__codelineno-4-27"></a>
+<a id="__codelineno-4-28" name="__codelineno-4-28"></a>    <span class="k">def</span> <span class="nf">fetch_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-29" name="__codelineno-4-29"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-4-30" name="__codelineno-4-30"></a>        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">path</span><span class="p">):</span>
+<a id="__codelineno-4-31" name="__codelineno-4-31"></a>            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span>
+<a id="__codelineno-4-32" name="__codelineno-4-32"></a>                <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-33" name="__codelineno-4-33"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
+<a id="__codelineno-4-34" name="__codelineno-4-34"></a>                <span class="k">except</span><span class="p">:</span>
+<a id="__codelineno-4-35" name="__codelineno-4-35"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
+<a id="__codelineno-4-36" name="__codelineno-4-36"></a>                <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return parsed data</span>
+<a id="__codelineno-4-37" name="__codelineno-4-37"></a>
+<a id="__codelineno-4-38" name="__codelineno-4-38"></a>    <span class="k">def</span> <span class="nf">update_db</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span>
+<a id="__codelineno-4-39" name="__codelineno-4-39"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-4-40" name="__codelineno-4-40"></a>        <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">path</span><span class="p">),</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="c1"># (4)!</span>
+<a id="__codelineno-4-41" name="__codelineno-4-41"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;w+&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span> <span class="c1"># The &quot;w+&quot; file operator allows reading and writing</span>
+<a id="__codelineno-4-42" name="__codelineno-4-42"></a>            <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-43" name="__codelineno-4-43"></a>                <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
+<a id="__codelineno-4-44" name="__codelineno-4-44"></a>            <span class="k">except</span><span class="p">:</span>
+<a id="__codelineno-4-45" name="__codelineno-4-45"></a>                <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
+<a id="__codelineno-4-46" name="__codelineno-4-46"></a>            <span class="n">data</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> <span class="c1"># Update the file contents with the new data</span>
+<a id="__codelineno-4-47" name="__codelineno-4-47"></a>            <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">file</span><span class="p">)</span> <span class="c1"># JSON write the new data to the file</span>
+<a id="__codelineno-4-48" name="__codelineno-4-48"></a>        <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return the new updated data</span>
 </code></pre></div></td></tr></table></div>
 <ol>
 <li>In case of an error, empty placeholder data is returned.</li>
@@ -1660,6 +1698,46 @@ <h3 id="functions">Functions</h3>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../extras-ex2/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Example 2: BetterGreeter">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Example 2: BetterGreeter
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../../examples/" class="md-footer__link md-footer__link--next" aria-label="Next: Example Macros">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Example Macros
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1670,6 +1748,21 @@ <h3 id="functions">Functions</h3>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1682,7 +1775,7 @@ <h3 id="functions">Functions</h3>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/extras/extras-start/index.html b/extras/extras-start/index.html
index 69ccb81..cd84549 100644
--- a/extras/extras-start/index.html
+++ b/extras/extras-start/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -848,16 +848,12 @@ <h1 id="start-writing-klippy-extras">Start Writing Klippy Extras</h1>
 <p class="admonition-title">Info</p>
 <p>To write a Klipper extra, you should be <strong>fluent</strong> in Python.</p>
 </div>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This guide is still under construction</p>
-</div>
 <details class="info">
 <summary>Klipper vs Klippy</summary>
 <p>To limit confusion, I'm going to explain this here. "Klipper" is the name of the firmware running on your 3D printer. "Klippy" is the name of the software running on your Klipper Host (usually a Raspberry Pi). Klipper is written in C code, and Klippy is mostly written in Python.</p>
 </details>
 <p>Start writing your first Klippy extra:</p>
-<p><a class="md-button" href="../extras-ex1/">Start <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M5 3h2v2H5v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5h2v2H5c-1.07-.27-2-.9-2-2v-4a2 2 0 0 0-2-2H0v-2h1a2 2 0 0 0 2-2V5a2 2 0 0 1 2-2m14 0a2 2 0 0 1 2 2v4a2 2 0 0 0 2 2h1v2h-1a2 2 0 0 0-2 2v4a2 2 0 0 1-2 2h-2v-2h2v-5a2 2 0 0 1 2-2 2 2 0 0 1-2-2V5h-2V3h2m-7 12a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m-4 0a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m8 0a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1Z"/></svg></span></a></p>
+<p><a class="md-button" href="../extras-ex1/">Start <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p>
 
 
 
@@ -925,6 +921,46 @@ <h1 id="start-writing-klippy-extras">Start Writing Klippy Extras</h1>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../../features/delayed/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Delayed GCode">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Delayed GCode
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../extras-ex1/" class="md-footer__link md-footer__link--next" aria-label="Next: Example 1: Greeter (Structure)">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Example 1: Greeter (Structure)
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -935,6 +971,21 @@ <h1 id="start-writing-klippy-extras">Start Writing Klippy Extras</h1>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -947,7 +998,7 @@ <h1 id="start-writing-klippy-extras">Start Writing Klippy Extras</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/delayed/index.html b/features/delayed/index.html
index a8253d8..4f0d643 100644
--- a/features/delayed/index.html
+++ b/features/delayed/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1014,6 +1014,46 @@ <h2 id="parameters">Parameters</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../python/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Python">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Python
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../../extras/extras-start/" class="md-footer__link md-footer__link--next" aria-label="Next: Start Writing Klippy Extras">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Start Writing Klippy Extras
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1024,6 +1064,21 @@ <h2 id="parameters">Parameters</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1036,7 +1091,7 @@ <h2 id="parameters">Parameters</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/python/index.html b/features/python/index.html
index de8a454..ad6d506 100644
--- a/features/python/index.html
+++ b/features/python/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1066,6 +1066,46 @@ <h3 id="python-file-running-gcode">Python File Running GCode</h3>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../variables/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Variables">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Variables
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../delayed/" class="md-footer__link md-footer__link--next" aria-label="Next: Delayed GCode">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Delayed GCode
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1076,6 +1116,21 @@ <h3 id="python-file-running-gcode">Python File Running GCode</h3>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1088,7 +1143,7 @@ <h3 id="python-file-running-gcode">Python File Running GCode</h3>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/receivingvariables/index.html b/features/receivingvariables/index.html
index 9c9c5a2..d3063fb 100644
--- a/features/receivingvariables/index.html
+++ b/features/receivingvariables/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -991,6 +991,46 @@ <h1 id="receiving-variable-updates">Receiving Variable Updates</h1>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../recursion/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Recursion">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Recursion
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../utilities/" class="md-footer__link md-footer__link--next" aria-label="Next: Utility Functions">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Utility Functions
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1001,6 +1041,21 @@ <h1 id="receiving-variable-updates">Receiving Variable Updates</h1>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1013,7 +1068,7 @@ <h1 id="receiving-variable-updates">Receiving Variable Updates</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/recursion/index.html b/features/recursion/index.html
index ae972b5..ee8c34a 100644
--- a/features/recursion/index.html
+++ b/features/recursion/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -911,6 +911,46 @@ <h1 id="recursion">Recursion</h1>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../../tutorial/experimental/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Experimental Features">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Experimental Features
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../receivingvariables/" class="md-footer__link md-footer__link--next" aria-label="Next: Receiving Variable Updates">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Receiving Variable Updates
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -921,6 +961,21 @@ <h1 id="recursion">Recursion</h1>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -933,7 +988,7 @@ <h1 id="recursion">Recursion</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/utilities/index.html b/features/utilities/index.html
index 12adb30..d086760 100644
--- a/features/utilities/index.html
+++ b/features/utilities/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1079,6 +1079,46 @@ <h2 id="update_from_dict">update_from_dict()</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../receivingvariables/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Receiving Variable Updates">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Receiving Variable Updates
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../variables/" class="md-footer__link md-footer__link--next" aria-label="Next: Variables">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Variables
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1089,6 +1129,21 @@ <h2 id="update_from_dict">update_from_dict()</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1101,7 +1156,7 @@ <h2 id="update_from_dict">update_from_dict()</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/features/variables/index.html b/features/variables/index.html
index cf527ae..6697468 100644
--- a/features/variables/index.html
+++ b/features/variables/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -971,6 +971,46 @@ <h2 id="set_dynamic_variable">SET_DYNAMIC_VARIABLE</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../utilities/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Utility Functions">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Utility Functions
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../python/" class="md-footer__link md-footer__link--next" aria-label="Next: Python">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Python
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -981,6 +1021,21 @@ <h2 id="set_dynamic_variable">SET_DYNAMIC_VARIABLE</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -993,7 +1048,7 @@ <h2 id="set_dynamic_variable">SET_DYNAMIC_VARIABLE</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/index.html b/index.html
index 73c8f05..2ed5d0b 100644
--- a/index.html
+++ b/index.html
@@ -89,7 +89,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -146,7 +146,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -352,6 +352,15 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#klippy-extras-tutorial" class="md-nav__link">
+    <span class="md-ellipsis">
+      Klippy Extras Tutorial
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -935,6 +944,15 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#klippy-extras-tutorial" class="md-nav__link">
+    <span class="md-ellipsis">
+      Klippy Extras Tutorial
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1021,7 +1039,9 @@ <h2 id="features">Features</h2>
 <h2 id="how-normal-macros-work">How Normal Macros Work</h2>
 <p>Your macros are written in a <code>.cfg</code> file, then included into your <code>printer.cfg</code>. When Klipper restarts, it parses these files and saves the macros internally (you can't change them without restarting Klipper). When a macro is called, the cached code is interpreted and run.</p>
 <h2 id="how-dynamic-macros-work">How Dynamic Macros Work</h2>
-<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the macro, allowing you to update macros without restarting Klipper.</p>
+<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the <code>DYNAMIC_MACRO</code> command, allowing you to update macros without restarting Klipper.</p>
+<h2 id="klippy-extras-tutorial">Klippy Extras Tutorial</h2>
+<p>DynamicMacros also includes a <a href="extras/extras-start/">tutorial on writing Klippy extras</a>.</p>
 <h2 id="get-started">Get Started</h2>
 <p>Follow <a href="setup/">Setup</a> to get started with Dynamic Macros.</p>
 <h2 id="planned-features">Planned Features</h2>
@@ -1097,6 +1117,30 @@ <h2 id="more-projects">More Projects</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+        
+          
+          <a href="setup/" class="md-footer__link md-footer__link--next" aria-label="Next: Setup">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Setup
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1107,6 +1151,21 @@ <h2 id="more-projects">More Projects</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1119,7 +1178,7 @@ <h2 id="more-projects">More Projects</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": ".", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": ".", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/print_page/index.html b/print_page/index.html
index b7c2026..6ccb4a0 100644
--- a/print_page/index.html
+++ b/print_page/index.html
@@ -93,7 +93,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -150,7 +150,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1060,7 +1060,9 @@ <h2 id="index-features">Features</h2>
 <h2 id="index-how-normal-macros-work">How Normal Macros Work</h2>
 <p>Your macros are written in a <code>.cfg</code> file, then included into your <code>printer.cfg</code>. When Klipper restarts, it parses these files and saves the macros internally (you can't change them without restarting Klipper). When a macro is called, the cached code is interpreted and run.</p>
 <h2 id="index-how-dynamic-macros-work">How Dynamic Macros Work</h2>
-<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the macro, allowing you to update macros without restarting Klipper.</p>
+<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the <code>DYNAMIC_MACRO</code> command, allowing you to update macros without restarting Klipper.</p>
+<h2 id="index-klippy-extras-tutorial">Klippy Extras Tutorial</h2>
+<p>DynamicMacros also includes a <a href="#extras-extras-start">tutorial on writing Klippy extras</a>.</p>
 <h2 id="index-get-started">Get Started</h2>
 <p>Follow <a href="#setup">Setup</a> to get started with Dynamic Macros.</p>
 <h2 id="index-planned-features">Planned Features</h2>
@@ -1567,20 +1569,12 @@ <h1 class='nav-section-title' id='section-klippy-extras'>
 <p class="admonition-title">Info</p>
 <p>To write a Klipper extra, you should be <strong>fluent</strong> in Python.</p>
 </div>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This guide is still under construction</p>
-</div>
 <details class="info">
 <summary>Klipper vs Klippy</summary>
 <p>To limit confusion, I'm going to explain this here. "Klipper" is the name of the firmware running on your 3D printer. "Klippy" is the name of the software running on your Klipper Host (usually a Raspberry Pi). Klipper is written in C code, and Klippy is mostly written in Python.</p>
 </details>
 <p>Start writing your first Klippy extra:</p>
-<p><a class="md-button" href="#extras-extras-ex1">Start <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M5 3h2v2H5v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5h2v2H5c-1.07-.27-2-.9-2-2v-4a2 2 0 0 0-2-2H0v-2h1a2 2 0 0 0 2-2V5a2 2 0 0 1 2-2m14 0a2 2 0 0 1 2 2v4a2 2 0 0 0 2 2h1v2h-1a2 2 0 0 0-2 2v4a2 2 0 0 1-2 2h-2v-2h2v-5a2 2 0 0 1 2-2 2 2 0 0 1-2-2V5h-2V3h2m-7 12a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m-4 0a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m8 0a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1Z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex1"><h1 id="extras-extras-ex1-example-1-greeter-structure">Example 1: Greeter (Structure)</h1>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This page is under construction.</p>
-</div>
+<p><a class="md-button" href="#extras-extras-ex1">Start <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex1"><h1 id="extras-extras-ex1-example-1-greeter-structure">Example 1: Greeter (Structure)</h1>
 <p>Before you start to write a Klippy extra, it is important to understand the structure of a Klippy extra. </p>
 <hr />
 <p>In Python, a Klippy extra is defined as a class, then referenced in a function at the end of the file. Example:</p>
@@ -1742,11 +1736,7 @@ <h2 id="extras-extras-ex1-other-things">Other Things</h2>
 </ul>
 <hr />
 <p>Next example:</p>
-<p><a class="md-button" href="#extras-extras-ex2">Example 2: BetterGreeter <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex2"><h1 id="extras-extras-ex2-example-2-bettergreeter">Example 2: BetterGreeter</h1>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This page is under construction.</p>
-</div>
+<p><a class="md-button" href="#extras-extras-ex2">Example 2: BetterGreeter <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex2"><h1 id="extras-extras-ex2-example-2-bettergreeter">Example 2: BetterGreeter</h1>
 <p>For this tutorial, we are going to improve on the greeter code used in <a href="#extras-extras-ex1">Structure</a>. </p>
 <p>For reference, the entire original greeter code is below:</p>
 <details open="open">
@@ -1888,6 +1878,19 @@ <h2 id="extras-extras-ex2-reading-the-configuration">Reading the Configuration</
 </span><a id="__codelineno-4-8" name="__codelineno-4-8"></a><span class="hll">        <span class="bp">self</span><span class="o">.</span><span class="n">message</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;message&#39;</span><span class="p">,</span> <span class="s1">&#39;Welcome to Klipper!&#39;</span><span class="p">)</span>
 </span><a id="__codelineno-4-9" name="__codelineno-4-9"></a><span class="hll">        <span class="bp">self</span><span class="o">.</span><span class="n">delay</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">getint</span><span class="p">(</span><span class="s1">&#39;delay&#39;</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
+<div class="admonition question inline end">
+<p class="admonition-title">Quiz</p>
+<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="extras-extras-ex2-__tabbed_1_1" name="extras-extras-ex2-__tabbed_1" type="radio" /><input id="extras-extras-ex2-__tabbed_1_2" name="extras-extras-ex2-__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="extras-extras-ex2-__tabbed_1_1">Question</label><label for="extras-extras-ex2-__tabbed_1_2">Answer</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
+<p>If there was a configuration option (int) named <code>repeats</code>, how would you get it in the initializer?</p>
+</div>
+<div class="tabbed-block">
+<p><code class="highlight"><span class="n">config</span><span class="o">.</span><span class="n">getint</span><span class="p">(</span><span class="s1">&#39;repeats&#39;</span><span class="p">)</span></code></p>
+</div>
+</div>
+</div>
+</div>
 <p>Here, the <code>printer</code>, <code>reactor</code>, <code>gcode</code>, and <code>message</code> variables are the same as in the previous Klippy extra. However, in this case, there are a couple new variables:</p>
 <ul>
 <li><code>name</code> is explained in <a href="#extras-extras-ex1-other-things">the last section of Structure</a>.</li>
@@ -2104,6 +2107,10 @@ <h2 id="extras-extras-ex2-functions">Functions</h2>
 <ol>
 <li>This is passed by Klippy when it calls <code>_greet()</code> after the timer occurs.</li>
 </ol>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>If you want the timer function to repeat, you can return the provided <code>eventtime</code> plus any number of seconds in the future, and it will repeat.</p>
+</div>
 <hr />
 <p>The final function in this class is the <code>cmd_GREETING</code> function:</p>
 <div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">greeting.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#extras-extras-ex2-__codelineno-9-1"> 1</a></span>
@@ -2248,7 +2255,7 @@ <h2 id="extras-extras-ex2-full-code">Full Code</h2>
 <p>You can install it following <a href="#extras-extras-ex1-install">these</a> instructions, replacing <code>greeter.py</code> with <code>greeting.py</code>.</p>
 <hr />
 <p>Last example (so far):</p>
-<p><a class="md-button" href="#extras-extras-ex3">Example 3: KlipperMaintenance <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 407 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="m372 232.5-3.7-6.5c.1-46.4-21.4-65.3-46.5-79.7 7.6-2 15.4-3.6 17.6-13.2 13.1-3.3 15.8-9.4 17.1-15.8 3.4-2.3 14.8-8.7 13.6-19.7 6.4-4.4 10-10.1 8.1-18.1 6.9-7.5 8.7-13.7 5.8-19.4 8.3-10.3 4.6-15.6 1.1-20.9 6.2-11.2.7-23.2-16.6-21.2-6.9-10.1-21.9-7.8-24.2-7.8-2.6-3.2-6-6-16.5-4.7-6.8-6.1-14.4-5-22.3-2.1-9.3-7.3-15.5-1.4-22.6.8C271.6.6 269 5.5 263.5 7.6c-12.3-2.6-16.1 3-22 8.9l-6.9-.1c-18.6 10.8-27.8 32.8-31.1 44.1-3.3-11.3-12.5-33.3-31.1-44.1l-6.9.1c-5.9-5.9-9.7-11.5-22-8.9-5.6-2-8.1-7-19.4-3.4-4.6-1.4-8.9-4.4-13.9-4.3-2.6.1-5.5 1-8.7 3.5-7.9-3-15.5-4-22.3 2.1-10.5-1.3-14 1.4-16.5 4.7-2.3 0-17.3-2.3-24.2 7.8C21.2 16 15.8 28 22 39.2c-3.5 5.4-7.2 10.7 1.1 20.9-2.9 5.7-1.1 11.9 5.8 19.4-1.8 8 1.8 13.7 8.1 18.1-1.2 11 10.2 17.4 13.6 19.7 1.3 6.4 4 12.4 17.1 15.8 2.2 9.5 10 11.2 17.6 13.2-25.1 14.4-46.6 33.3-46.5 79.7l-3.7 6.5c-28.8 17.2-54.7 72.7-14.2 117.7 2.6 14.1 7.1 24.2 11 35.4 5.9 45.2 44.5 66.3 54.6 68.8 14.9 11.2 30.8 21.8 52.2 29.2C159 504.2 181 512 203 512h1c22.1 0 44-7.8 64.2-28.4 21.5-7.4 37.3-18 52.2-29.2 10.2-2.5 48.7-23.6 54.6-68.8 3.9-11.2 8.4-21.3 11-35.4 40.6-45.1 14.7-100.5-14-117.7zm-22.2-8c-1.5 18.7-98.9-65.1-82.1-67.9 45.7-7.5 83.6 19.2 82.1 67.9zm-43 93.1c-24.5 15.8-59.8 5.6-78.8-22.8s-14.6-64.2 9.9-80c24.5-15.8 59.8-5.6 78.8 22.8s14.6 64.2-9.9 80zM238.9 29.3c.8 4.2 1.8 6.8 2.9 7.6 5.4-5.8 9.8-11.7 16.8-17.3 0 3.3-1.7 6.8 2.5 9.4 3.7-5 8.8-9.5 15.5-13.3-3.2 5.6-.6 7.3 1.2 9.6 5.1-4.4 10-8.8 19.4-12.3-2.6 3.1-6.2 6.2-2.4 9.8 5.3-3.3 10.6-6.6 23.1-8.9-2.8 3.1-8.7 6.3-5.1 9.4 6.6-2.5 14-4.4 22.1-5.4-3.9 3.2-7.1 6.3-3.9 8.8 7.1-2.2 16.9-5.1 26.4-2.6l-6 6.1c-.7.8 14.1.6 23.9.8-3.6 5-7.2 9.7-9.3 18.2 1 1 5.8.4 10.4 0-4.7 9.9-12.8 12.3-14.7 16.6 2.9 2.2 6.8 1.6 11.2.1-3.4 6.9-10.4 11.7-16 17.3 1.4 1 3.9 1.6 9.7.9-5.2 5.5-11.4 10.5-18.8 15 1.3 1.5 5.8 1.5 10 1.6-6.7 6.5-15.3 9.9-23.4 14.2 4 2.7 6.9 2.1 10 2.1-5.7 4.7-15.4 7.1-24.4 10 1.7 2.7 3.4 3.4 7.1 4.1-9.5 5.3-23.2 2.9-27 5.6.9 2.7 3.6 4.4 6.7 5.8-15.4.9-57.3-.6-65.4-32.3 15.7-17.3 44.4-37.5 93.7-62.6-38.4 12.8-73 30-102 53.5-34.3-15.9-10.8-55.9 5.8-71.8zm-34.4 114.6c24.2-.3 54.1 17.8 54 34.7-.1 15-21 27.1-53.8 26.9-32.1-.4-53.7-15.2-53.6-29.8 0-11.9 26.2-32.5 53.4-31.8zm-123-12.8c3.7-.7 5.4-1.5 7.1-4.1-9-2.8-18.7-5.3-24.4-10 3.1 0 6 .7 10-2.1-8.1-4.3-16.7-7.7-23.4-14.2 4.2-.1 8.7 0 10-1.6-7.4-4.5-13.6-9.5-18.8-15 5.8.7 8.3.1 9.7-.9-5.6-5.6-12.7-10.4-16-17.3 4.3 1.5 8.3 2 11.2-.1-1.9-4.2-10-6.7-14.7-16.6 4.6.4 9.4 1 10.4 0-2.1-8.5-5.8-13.3-9.3-18.2 9.8-.1 24.6 0 23.9-.8l-6-6.1c9.5-2.5 19.3.4 26.4 2.6 3.2-2.5-.1-5.6-3.9-8.8 8.1 1.1 15.4 2.9 22.1 5.4 3.5-3.1-2.3-6.3-5.1-9.4 12.5 2.3 17.8 5.6 23.1 8.9 3.8-3.6.2-6.7-2.4-9.8 9.4 3.4 14.3 7.9 19.4 12.3 1.7-2.3 4.4-4 1.2-9.6 6.7 3.8 11.8 8.3 15.5 13.3 4.1-2.6 2.5-6.2 2.5-9.4 7 5.6 11.4 11.5 16.8 17.3 1.1-.8 2-3.4 2.9-7.6 16.6 15.9 40.1 55.9 6 71.8-29-23.5-63.6-40.7-102-53.5 49.3 25 78 45.3 93.7 62.6-8 31.8-50 33.2-65.4 32.3 3.1-1.4 5.8-3.2 6.7-5.8-4-2.8-17.6-.4-27.2-5.6zm60.1 24.1c16.8 2.8-80.6 86.5-82.1 67.9-1.5-48.7 36.5-75.5 82.1-67.9zM38.2 342c-23.7-18.8-31.3-73.7 12.6-98.3 26.5-7 9 107.8-12.6 98.3zm91 98.2c-13.3 7.9-45.8 4.7-68.8-27.9-15.5-27.4-13.5-55.2-2.6-63.4 16.3-9.8 41.5 3.4 60.9 25.6 16.9 20 24.6 55.3 10.5 65.7zm-26.4-119.7c-24.5-15.8-28.9-51.6-9.9-80s54.3-38.6 78.8-22.8 28.9 51.6 9.9 80c-19.1 28.4-54.4 38.6-78.8 22.8zM205 496c-29.4 1.2-58.2-23.7-57.8-32.3-.4-12.7 35.8-22.6 59.3-22 23.7-1 55.6 7.5 55.7 18.9.5 11-28.8 35.9-57.2 35.4zm58.9-124.9c.2 29.7-26.2 53.8-58.8 54-32.6.2-59.2-23.8-59.4-53.4v-.6c-.2-29.7 26.2-53.8 58.8-54 32.6-.2 59.2 23.8 59.4 53.4v.6zm82.2 42.7c-25.3 34.6-59.6 35.9-72.3 26.3-13.3-12.4-3.2-50.9 15.1-72 20.9-23.3 43.3-38.5 58.9-26.6 10.5 10.3 16.7 49.1-1.7 72.3zm22.9-73.2c-21.5 9.4-39-105.3-12.6-98.3 43.9 24.7 36.3 79.6 12.6 98.3z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex3"><h1 id="extras-extras-ex3-example-3-klippermaintenance">Example 3: KlipperMaintenance</h1>
+<p><a class="md-button" href="#extras-extras-ex3">Example 3: KlipperMaintenance <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M278.6 233.4c12.5 12.5 12.5 32.8 0 45.3l-160 160c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3L210.7 256 73.4 118.6c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0l160 160z"/></svg></span></a></p></section><section class="print-page" id="extras-extras-ex3"><h1 id="extras-extras-ex3-example-3-klippermaintenance">Example 3: KlipperMaintenance</h1>
 <p>This last example of the Klippy extra development tutorial is actually one of my other Klipper projects: <a href="https://github.com/3DCoded/KlipperMaintenance">KlipperMaintenance</a>, a maintenance reminder system for Klipper.</p>
 <p>This example will go through how the KlipperMaintenance code works to teach a few more important things about developing Klippy extras.</p>
 <h2 id="extras-extras-ex3-full-code">Full Code</h2>
@@ -2723,6 +2730,44 @@ <h3 id="extras-extras-ex3-initializer">Initializer</h3>
 <li><strong>Third highlighted section:</strong> Register GCode commands</li>
 </ul>
 <p>The line <code class="highlight"><span class="bp">self</span><span class="o">.</span><span class="n">init_db</span><span class="p">()</span></code> will be explained later in functions.</p>
+<div class="admonition question">
+<p class="admonition-title">Quiz</p>
+<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="extras-extras-ex3-__tabbed_1_1" name="extras-extras-ex3-__tabbed_1" type="radio" /><input id="extras-extras-ex3-__tabbed_1_2" name="extras-extras-ex3-__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="extras-extras-ex3-__tabbed_1_1">Question</label><label for="extras-extras-ex3-__tabbed_1_2">Answer</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
+<p>How would you add another trigger type (called <code class="highlight"><span class="s2">&quot;axes_distance&quot;</span></code> with units <code class="highlight"><span class="s2">&quot;m&quot;</span></code>)?</p>
+</div>
+<div class="tabbed-block">
+<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#extras-extras-ex3-__codelineno-3-1"> 1</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-2"> 2</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-3"> 3</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-4"> 4</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-5"> 5</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-6"> 6</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-7"> 7</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-8"> 8</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-9"> 9</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-10">10</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-11">11</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-12">12</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-13">13</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1"></a><span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">=</span> <span class="n">config</span><span class="o">.</span><span class="n">getchoice</span><span class="p">(</span><span class="s1">&#39;trigger&#39;</span><span class="p">,</span> <span class="p">[</span>
+<a id="__codelineno-3-2" name="__codelineno-3-2"></a>    <span class="s1">&#39;print_time&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-3" name="__codelineno-3-3"></a>    <span class="s1">&#39;filament&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-4" name="__codelineno-3-4"></a>    <span class="s1">&#39;time&#39;</span><span class="p">,</span>
+<a id="__codelineno-3-5" name="__codelineno-3-5"></a><span class="hll">    <span class="s1">&#39;axes_distance&#39;</span><span class="p">])</span>
+</span><a id="__codelineno-3-6" name="__codelineno-3-6"></a><span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-3-7" name="__codelineno-3-7"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;h&#39;</span>
+<a id="__codelineno-3-8" name="__codelineno-3-8"></a><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span>
+<a id="__codelineno-3-9" name="__codelineno-3-9"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;m&#39;</span>
+<a id="__codelineno-3-10" name="__codelineno-3-10"></a><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span>
+<a id="__codelineno-3-11" name="__codelineno-3-11"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;h&#39;</span>
+<a id="__codelineno-3-12" name="__codelineno-3-12"></a><span class="hll"><span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">trigger</span> <span class="o">==</span> <span class="s1">&#39;axes_distance&#39;</span><span class="p">:</span>
+</span><a id="__codelineno-3-13" name="__codelineno-3-13"></a><span class="hll">    <span class="bp">self</span><span class="o">.</span><span class="n">units</span> <span class="o">=</span> <span class="s1">&#39;m&#39;</span>
+</span></code></pre></div></td></tr></table></div>
+</div>
+</div>
+</div>
+</div>
 <h3 id="extras-extras-ex3-functions">Functions</h3>
 <p>The next part of the <code>Maintain</code> class is its functions. The functions in this class are, broken down into two sections:</p>
 <p><strong>Database:</strong></p>
@@ -2739,101 +2784,101 @@ <h3 id="extras-extras-ex3-functions">Functions</h3>
 <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li>
 </ul>
 <p>First, the database functions (again, plus signs throughout the code explain in more detail what each part does):</p>
-<div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">maintain.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#extras-extras-ex3-__codelineno-3-1"> 1</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-2"> 2</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-3"> 3</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-4"> 4</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-5"> 5</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-6"> 6</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-7"> 7</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-8"> 8</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-9"> 9</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-10">10</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-11">11</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-12">12</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-13">13</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-14">14</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-15">15</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-16">16</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-17">17</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-18">18</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-19">19</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-20">20</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-21">21</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-22">22</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-23">23</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-24">24</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-25">25</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-26">26</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-27">27</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-28">28</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-29">29</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-30">30</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-31">31</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-32">32</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-33">33</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-34">34</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-35">35</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-36">36</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-37">37</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-38">38</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-39">39</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-40">40</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-41">41</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-42">42</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-43">43</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-44">44</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-45">45</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-46">46</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-47">47</a></span>
-<span class="normal"><a href="#extras-extras-ex3-__codelineno-3-48">48</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1"></a><span class="k">class</span> <span class="nc">Maintain</span><span class="p">:</span>
-<a id="__codelineno-3-2" name="__codelineno-3-2"></a>    <span class="o">...</span>
-<a id="__codelineno-3-3" name="__codelineno-3-3"></a>    <span class="k">def</span> <span class="nf">fetch_history</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-4" name="__codelineno-3-4"></a>        <span class="n">resp</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="n">API_URL</span><span class="p">)</span> <span class="c1"># fetch data from Moonraker History API</span>
-<a id="__codelineno-3-5" name="__codelineno-3-5"></a>        <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-6" name="__codelineno-3-6"></a>            <span class="n">json_data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">())</span> 
-<a id="__codelineno-3-7" name="__codelineno-3-7"></a>        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-<a id="__codelineno-3-8" name="__codelineno-3-8"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">gcode</span><span class="o">.</span><span class="n">respond_info</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Data </span><span class="si">{</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
-<a id="__codelineno-3-9" name="__codelineno-3-9"></a>            <span class="k">return</span> <span class="p">{</span>
-<a id="__codelineno-3-10" name="__codelineno-3-10"></a>                <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
-<a id="__codelineno-3-11" name="__codelineno-3-11"></a>                <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
-<a id="__codelineno-3-12" name="__codelineno-3-12"></a>                <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
-<a id="__codelineno-3-13" name="__codelineno-3-13"></a>            <span class="p">}</span> <span class="c1"># (1)!</span>
-<a id="__codelineno-3-14" name="__codelineno-3-14"></a>
-<a id="__codelineno-3-15" name="__codelineno-3-15"></a>        <span class="n">job_totals</span> <span class="o">=</span> <span class="n">json_data</span><span class="p">[</span><span class="s1">&#39;result&#39;</span><span class="p">][</span><span class="s1">&#39;job_totals&#39;</span><span class="p">]</span> <span class="c1"># get job totals from JSON response</span>
-<a id="__codelineno-3-16" name="__codelineno-3-16"></a>        <span class="k">return</span> <span class="p">{</span>
-<a id="__codelineno-3-17" name="__codelineno-3-17"></a>            <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_time&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">3600</span><span class="p">,</span>
-<a id="__codelineno-3-18" name="__codelineno-3-18"></a>            <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_filament_used&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">1000</span><span class="p">,</span>
-<a id="__codelineno-3-19" name="__codelineno-3-19"></a>            <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
-<a id="__codelineno-3-20" name="__codelineno-3-20"></a>        <span class="p">}</span> <span class="c1"># (2)!</span>
-<a id="__codelineno-3-21" name="__codelineno-3-21"></a>
-<a id="__codelineno-3-22" name="__codelineno-3-22"></a>    <span class="k">def</span> <span class="nf">init_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-23" name="__codelineno-3-23"></a>        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_db</span><span class="p">()</span> <span class="c1"># Load the database</span>
-<a id="__codelineno-3-24" name="__codelineno-3-24"></a>        <span class="k">if</span> <span class="n">data</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-<a id="__codelineno-3-25" name="__codelineno-3-25"></a>            <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_history</span><span class="p">()</span>
-<a id="__codelineno-3-26" name="__codelineno-3-26"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">update_db</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="c1"># Update the database with history data</span>
-<a id="__codelineno-3-27" name="__codelineno-3-27"></a>
-<a id="__codelineno-3-28" name="__codelineno-3-28"></a>    <span class="k">def</span> <span class="nf">fetch_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-3-29" name="__codelineno-3-29"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
-<a id="__codelineno-3-30" name="__codelineno-3-30"></a>        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">path</span><span class="p">):</span>
-<a id="__codelineno-3-31" name="__codelineno-3-31"></a>            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span>
-<a id="__codelineno-3-32" name="__codelineno-3-32"></a>                <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-33" name="__codelineno-3-33"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
-<a id="__codelineno-3-34" name="__codelineno-3-34"></a>                <span class="k">except</span><span class="p">:</span>
-<a id="__codelineno-3-35" name="__codelineno-3-35"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
-<a id="__codelineno-3-36" name="__codelineno-3-36"></a>                <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return parsed data</span>
-<a id="__codelineno-3-37" name="__codelineno-3-37"></a>
-<a id="__codelineno-3-38" name="__codelineno-3-38"></a>    <span class="k">def</span> <span class="nf">update_db</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span>
-<a id="__codelineno-3-39" name="__codelineno-3-39"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
-<a id="__codelineno-3-40" name="__codelineno-3-40"></a>        <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">path</span><span class="p">),</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="c1"># (4)!</span>
-<a id="__codelineno-3-41" name="__codelineno-3-41"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;w+&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span> <span class="c1"># The &quot;w+&quot; file operator allows reading and writing</span>
-<a id="__codelineno-3-42" name="__codelineno-3-42"></a>            <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-3-43" name="__codelineno-3-43"></a>                <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
-<a id="__codelineno-3-44" name="__codelineno-3-44"></a>            <span class="k">except</span><span class="p">:</span>
-<a id="__codelineno-3-45" name="__codelineno-3-45"></a>                <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
-<a id="__codelineno-3-46" name="__codelineno-3-46"></a>            <span class="n">data</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> <span class="c1"># Update the file contents with the new data</span>
-<a id="__codelineno-3-47" name="__codelineno-3-47"></a>            <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">file</span><span class="p">)</span> <span class="c1"># JSON write the new data to the file</span>
-<a id="__codelineno-3-48" name="__codelineno-3-48"></a>        <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return the new updated data</span>
+<div class="highlight"><table class="highlighttable"><tr><th colspan="2" class="filename"><span class="filename">maintain.py</span></th></tr><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#extras-extras-ex3-__codelineno-4-1"> 1</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-2"> 2</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-3"> 3</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-4"> 4</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-5"> 5</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-6"> 6</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-7"> 7</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-8"> 8</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-9"> 9</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-10">10</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-11">11</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-12">12</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-13">13</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-14">14</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-15">15</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-16">16</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-17">17</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-18">18</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-19">19</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-20">20</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-21">21</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-22">22</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-23">23</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-24">24</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-25">25</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-26">26</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-27">27</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-28">28</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-29">29</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-30">30</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-31">31</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-32">32</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-33">33</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-34">34</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-35">35</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-36">36</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-37">37</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-38">38</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-39">39</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-40">40</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-41">41</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-42">42</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-43">43</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-44">44</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-45">45</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-46">46</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-47">47</a></span>
+<span class="normal"><a href="#extras-extras-ex3-__codelineno-4-48">48</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1"></a><span class="k">class</span> <span class="nc">Maintain</span><span class="p">:</span>
+<a id="__codelineno-4-2" name="__codelineno-4-2"></a>    <span class="o">...</span>
+<a id="__codelineno-4-3" name="__codelineno-4-3"></a>    <span class="k">def</span> <span class="nf">fetch_history</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-4" name="__codelineno-4-4"></a>        <span class="n">resp</span> <span class="o">=</span> <span class="n">requests</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="n">API_URL</span><span class="p">)</span> <span class="c1"># fetch data from Moonraker History API</span>
+<a id="__codelineno-4-5" name="__codelineno-4-5"></a>        <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-6" name="__codelineno-4-6"></a>            <span class="n">json_data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">())</span> 
+<a id="__codelineno-4-7" name="__codelineno-4-7"></a>        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+<a id="__codelineno-4-8" name="__codelineno-4-8"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">gcode</span><span class="o">.</span><span class="n">respond_info</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Data </span><span class="si">{</span><span class="n">resp</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
+<a id="__codelineno-4-9" name="__codelineno-4-9"></a>            <span class="k">return</span> <span class="p">{</span>
+<a id="__codelineno-4-10" name="__codelineno-4-10"></a>                <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+<a id="__codelineno-4-11" name="__codelineno-4-11"></a>                <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>
+<a id="__codelineno-4-12" name="__codelineno-4-12"></a>                <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
+<a id="__codelineno-4-13" name="__codelineno-4-13"></a>            <span class="p">}</span> <span class="c1"># (1)!</span>
+<a id="__codelineno-4-14" name="__codelineno-4-14"></a>
+<a id="__codelineno-4-15" name="__codelineno-4-15"></a>        <span class="n">job_totals</span> <span class="o">=</span> <span class="n">json_data</span><span class="p">[</span><span class="s1">&#39;result&#39;</span><span class="p">][</span><span class="s1">&#39;job_totals&#39;</span><span class="p">]</span> <span class="c1"># get job totals from JSON response</span>
+<a id="__codelineno-4-16" name="__codelineno-4-16"></a>        <span class="k">return</span> <span class="p">{</span>
+<a id="__codelineno-4-17" name="__codelineno-4-17"></a>            <span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_time&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">3600</span><span class="p">,</span>
+<a id="__codelineno-4-18" name="__codelineno-4-18"></a>            <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="n">job_totals</span><span class="p">[</span><span class="s1">&#39;total_filament_used&#39;</span><span class="p">]</span><span class="o">/</span><span class="mi">1000</span><span class="p">,</span>
+<a id="__codelineno-4-19" name="__codelineno-4-19"></a>            <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span>
+<a id="__codelineno-4-20" name="__codelineno-4-20"></a>        <span class="p">}</span> <span class="c1"># (2)!</span>
+<a id="__codelineno-4-21" name="__codelineno-4-21"></a>
+<a id="__codelineno-4-22" name="__codelineno-4-22"></a>    <span class="k">def</span> <span class="nf">init_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-23" name="__codelineno-4-23"></a>        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_db</span><span class="p">()</span> <span class="c1"># Load the database</span>
+<a id="__codelineno-4-24" name="__codelineno-4-24"></a>        <span class="k">if</span> <span class="n">data</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+<a id="__codelineno-4-25" name="__codelineno-4-25"></a>            <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_history</span><span class="p">()</span>
+<a id="__codelineno-4-26" name="__codelineno-4-26"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">update_db</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="c1"># Update the database with history data</span>
+<a id="__codelineno-4-27" name="__codelineno-4-27"></a>
+<a id="__codelineno-4-28" name="__codelineno-4-28"></a>    <span class="k">def</span> <span class="nf">fetch_db</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-4-29" name="__codelineno-4-29"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-4-30" name="__codelineno-4-30"></a>        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">path</span><span class="p">):</span>
+<a id="__codelineno-4-31" name="__codelineno-4-31"></a>            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span>
+<a id="__codelineno-4-32" name="__codelineno-4-32"></a>                <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-33" name="__codelineno-4-33"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
+<a id="__codelineno-4-34" name="__codelineno-4-34"></a>                <span class="k">except</span><span class="p">:</span>
+<a id="__codelineno-4-35" name="__codelineno-4-35"></a>                    <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
+<a id="__codelineno-4-36" name="__codelineno-4-36"></a>                <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return parsed data</span>
+<a id="__codelineno-4-37" name="__codelineno-4-37"></a>
+<a id="__codelineno-4-38" name="__codelineno-4-38"></a>    <span class="k">def</span> <span class="nf">update_db</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span>
+<a id="__codelineno-4-39" name="__codelineno-4-39"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">HOME_DIR</span><span class="p">,</span> <span class="sa">f</span><span class="s1">&#39;maintain-db/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span> <span class="c1"># (3)!</span>
+<a id="__codelineno-4-40" name="__codelineno-4-40"></a>        <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">path</span><span class="p">),</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="c1"># (4)!</span>
+<a id="__codelineno-4-41" name="__codelineno-4-41"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s1">&#39;w+&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">file</span><span class="p">:</span> <span class="c1"># The &quot;w+&quot; file operator allows reading and writing</span>
+<a id="__codelineno-4-42" name="__codelineno-4-42"></a>            <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-4-43" name="__codelineno-4-43"></a>                <span class="n">data</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="p">)</span> <span class="c1"># JSON parse the file contents</span>
+<a id="__codelineno-4-44" name="__codelineno-4-44"></a>            <span class="k">except</span><span class="p">:</span>
+<a id="__codelineno-4-45" name="__codelineno-4-45"></a>                <span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;print_time&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;filament&#39;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> <span class="s1">&#39;time&#39;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">/</span><span class="mi">3600</span><span class="p">}</span>
+<a id="__codelineno-4-46" name="__codelineno-4-46"></a>            <span class="n">data</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> <span class="c1"># Update the file contents with the new data</span>
+<a id="__codelineno-4-47" name="__codelineno-4-47"></a>            <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">file</span><span class="p">)</span> <span class="c1"># JSON write the new data to the file</span>
+<a id="__codelineno-4-48" name="__codelineno-4-48"></a>        <span class="k">return</span> <span class="n">data</span> <span class="c1"># Return the new updated data</span>
 </code></pre></div></td></tr></table></div>
 <ol>
 <li>In case of an error, empty placeholder data is returned.</li>
@@ -3071,6 +3116,8 @@ <h2 id="devstatus-planned-features">Planned Features</h2>
       
         <footer class="md-footer">
   
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -3081,6 +3128,21 @@ <h2 id="devstatus-planned-features">Planned Features</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -3093,7 +3155,7 @@ <h2 id="devstatus-planned-features">Planned Features</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "/DynamicMacros/", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "/DynamicMacros/", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/search/search_index.json b/search/search_index.json
index 3b74d38..63492d6 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Klipper Dynamic Macros","text":"<p>Never restart Klipper again for simple macros.</p> <p></p> <p>Klipper Dynamic Macros is an unofficial way to update macros without restarting Klipper, so you can update macros mid-print and see their results live. It also supports extra features that normal GCode Macros don't have.</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Recursion</li> <li>Receiving Variables</li> <li>Utility Functions</li> <li>Variables</li> <li>Python</li> <li>Delayed GCode</li> </ul>"},{"location":"#how-normal-macros-work","title":"How Normal Macros Work","text":"<p>Your macros are written in a <code>.cfg</code> file, then included into your <code>printer.cfg</code>. When Klipper restarts, it parses these files and saves the macros internally (you can't change them without restarting Klipper). When a macro is called, the cached code is interpreted and run.</p>"},{"location":"#how-dynamic-macros-work","title":"How Dynamic Macros Work","text":"<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the macro, allowing you to update macros without restarting Klipper.</p>"},{"location":"#get-started","title":"Get Started","text":"<p>Follow Setup to get started with Dynamic Macros.</p>"},{"location":"#planned-features","title":"Planned Features","text":"<p>See Development Status for the currently available features, and planned features.</p>"},{"location":"#examples","title":"Examples","text":"<p>See Example Macros for examples of Dynamic Macros.</p>"},{"location":"#more-projects","title":"More Projects","text":"<p>If you like this project, don't forget to give it a star! Also, check out the 3MS, a modular multimaterial system for Klipper!</p>"},{"location":"devstatus/","title":"Development Status","text":""},{"location":"devstatus/#features","title":"Features","text":"<ul> <li>Editing macros without restarting Klipper</li> <li>Accessing printer information from within Dynamic Macros</li> <li>Accessing parameters from within Dynamic Macros</li> <li>Adding new Dynamic Macros without restarting Klipper</li> <li>Removing existing Dynamic Macros without restarting Klipper</li> <li>Renaming Dynamic Macros without restarting Klipper</li> <li>Dynamic Macro descriptions</li> <li>Dynamic Macro variables</li> <li>Retrieving variables from other macros</li> <li>Support for <code>rename_existing</code></li> <li>Running Python from within a Dynamic Macro</li> <li>Dynamic <code>delayed_gcode</code> implementation</li> </ul>"},{"location":"devstatus/#planned-features","title":"Planned Features","text":"<p>A checkmark indicates a feature is experimental.</p> <ul> <li> Allow configuring multiple <code>dynamicmacros</code> config sections as clusters<ul> <li> Disable Python per-cluster</li> <li> Disable <code>printer</code> object per-cluster</li> </ul> </li> <li> Better error handling</li> <li> Klippy extras tutorial</li> </ul>"},{"location":"examples/","title":"Example Macros","text":"<p>This page will hold several different Dynamic Macro examples. Note that most of the examples here are specific to Dynamic Macros only.</p>"},{"location":"examples/#m900","title":"M900","text":"<p>Normal Macro</p> <p>In Marlin, M900 K is used to set pressure/linear advance. Now, you can use it in Klipper too:</p> <pre><code>[gcode_macro M900]\ndescription: Set Pressure Advance\ngcode:\n  {% set k = params.K|default(0)|float %}\n  {% if k &lt; 1 %}\n    SET_PRESSURE_ADVANCE ADVANCE={k}\n  {% endif %}\n</code></pre>"},{"location":"examples/#recursion","title":"Recursion","text":"<p>Dynamic Macro</p> <p>These are a few example Dynamic Macros to demonstrate the recursive functionality of Dynamic Macros.</p> Counting to 10<pre><code>[gcode_macro COUNT]\ngcode:\n    {% set num = params.NUM|default(1)|int %}\n    {% if num &lt;= 10 %}\n        RESPOND MSG={num}\n        COUNT NUM={num+1} # Count up 1\n    {% else %}\n        RESPOND MSG=\"Done Counting\"\n    {% endif %}\n</code></pre> Load to Filament Sensor<pre><code>[gcode_macro LOAD_TO_FSENSOR]\ngcode:\n    {% set val = printer[\"filament_sensor fsensor\"].filament_detected %}\n    {% if val == 0 %}\n        M83\n        G1 E50 F900 # Move filament 50mm forwards\n        RESPOND MSG=\"Waiting for fsensor\"\n        LOAD_TO_FSENSOR # Recursion\n    {% else %}\n        G1 E65 F900 # Move filament to nozzle\n        RESPOND MSG=\"Filament Loaded\"\n    {% endif %}\n</code></pre>"},{"location":"examples/#receiving-position-updates","title":"Receiving Position Updates","text":"<p>Dynamic Macro</p> <p>This is an example Dynamic Macro to demonstrate the ability to receive position updates from within the same macro.</p> <pre><code>[gcode_macro DYNAMIC_MOVE]\ngcode:\n  G28\n\n\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position after G28\n  G90\n  G1 Z20\n\n\n  M117 After: {printer.toolhead.position.z}\n  # Above displays position after G1\n</code></pre>"},{"location":"examples/#preserving-variables","title":"Preserving Variables","text":"<p>Dynamic Macro</p> <p>This is an example of how to preserve variables across triple-newlines in Dynamic Macros.</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = update(\"num\", 10) %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs 10\n</code></pre>"},{"location":"setup/","title":"Setup","text":"<p>Follow this guide to setup and confiure Dynamic Macros.</p>"},{"location":"setup/#install","title":"Install","text":"<p>Run in your terminal:</p> <pre><code>cd ~\ngit clone https://github.com/3DCoded/DynamicMacros\ncd DynamicMacros\nsh install.sh\nsudo service klipper restart\n</code></pre> <p>Add to your <code>moonraker.conf</code>:</p> moonraker.conf<pre><code># DynamicMacros Update Manager\n[update_manager DynamicMacros]\ntype: git_repo\npath: ~/DynamicMacros\norigin: https://github.com/3DCoded/DynamicMacros.git\nprimary_branch: main\nis_system_service: False\ninstall_script: install.sh\n</code></pre>"},{"location":"setup/#updating","title":"Updating","text":"<p>First, update via Moonraker's update manager. Then run in your terminal:</p> <pre><code>cd ~/DynamicMacros\nsh install.sh\nsudo service klipper restart\n</code></pre>"},{"location":"setup/#configuration","title":"Configuration","text":"<p>To configure Dynamic Macros, put in your <code>printer.cfg</code> (or a file included in it):</p> printer.cfg<pre><code>[dynamicmacros]\nconfig_path: ~/printer_data/config # If you left your printer configuration path as the default, you don't need to specify this\nconfigs: dynamic.cfg\n</code></pre> <p>Create a new file in the same folder as your <code>printer.cfg</code> called <code>dynamic.cfg</code>. In it, configure some macros like you normally would. Example:</p> dynamic.cfg<pre><code>[gcode_macro MYTEST]\ngcode:\n    M117 Hello world!\n\n[gcode_macro HEAT_HOTEND]\ngcode:\n    {% set temp = params.TEMP|int %}\n    M104 S{temp}\n</code></pre> <p>Restart Klipper.</p> <p>Info</p> <p>Updating the <code>[dynamicmacros]</code> config section requires a Klipper restart. The files listed in the <code>macros:</code> parameter must be present when Klipper restarts.</p>"},{"location":"setup/#testing","title":"Testing","text":"<p>If you run the command <code>MYTEST</code>, the output should be: <pre><code>Hello world!\n</code></pre></p> <p>If you runthe command <code>HEAT_HOTEND TEMP=200</code>, the hotend should start heating up. </p> <p>Next, edit the <code>MYTEST</code> macro to output something else, like <code>Test successful!</code></p> dynamic.cfg<pre><code>[gcode_macro MYTEST]\ngcode:\n    M117 Test successful!\n</code></pre> <p>Save the file, but do not restart Klipper.</p> <p>Run <code>MYTEST</code> again, and the output should be: <pre><code>Test successful!\n</code></pre></p>"},{"location":"setup/#features","title":"Features","text":"<ul> <li>Recursion</li> <li>Receiving Variable Updates</li> <li>Utility Functions</li> <li>Variables</li> </ul>"},{"location":"setup/#tutorial","title":"Tutorial","text":"<p>Follow the Tutorial.</p>"},{"location":"setup/#when-to-restart-klipper-or-reload-dynamic-macros","title":"When to Restart Klipper or Reload Dynamic Macros","text":"<p>Dynamic Macros provides a utility <code>DYNAMIC_MACRO</code> command to run macros manually, and to refresh the macros. Usage examples (assuming M900 is defined as a Dynamic Macro):</p> <pre><code>DYNAMIC_MACRO MACRO=M900 K=0.035\n</code></pre> <p>is the same as:</p> <pre><code>M900 K0.035\n</code></pre> <p>To refresh Dynamic Macros, just run <code>DYNAMIC_MACRO</code> with no parameters.</p> <p>A Klipper restart is required if:</p> <ul> <li>You changed the <code>description</code></li> <li>You changed the <code>initial_duration</code></li> <li>You changed the <code>repeat</code></li> </ul> <p>A <code>DYNAMIC_MACRO</code> refresh is required if:</p> <ul> <li>You created a new macro</li> <li>You renamed an existing macro</li> <li>You changed the contents of a macro</li> <li>You deleted an existing macro</li> </ul>"},{"location":"extras/extras-ex1/","title":"Example 1: Greeter (Structure)","text":"<p>Info</p> <p>This page is under construction.</p> <p>Before you start to write a Klippy extra, it is important to understand the structure of a Klippy extra. </p> <p>In Python, a Klippy extra is defined as a class, then referenced in a function at the end of the file. Example:</p> greeter.py<pre><code>class Greeter:\n...\n\ndef load_config(config):\n    return Greeter(config)\n</code></pre> <p>There are two functions that can be used at the end of a file:</p> <ul> <li><code>load_config_prefix</code>, allows for configurations like <code>[greeter mygreeter]</code></li> <li><code>load_config</code>, like in this example, allows for configurations like <code>[greeter]</code></li> </ul>"},{"location":"extras/extras-ex1/#initializer","title":"Initializer","text":"<p>In the last line of the above code block, you can see that a <code>config</code> object is passed as a parameter to the <code>Greeter</code> object. The initializer of the <code>Greeter</code> class is shown below in sections:</p> Get printer objects and configuration options<pre><code>    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n</code></pre> <p>This section gets the <code>printer</code> object with <code>config.get_printer()</code>.</p> <p>It then gets the <code>gcode</code> object with <code>self.printer.lookup_object('gcode')</code>.</p> <p>Then, it gets the <code>reactor</code> object with <code>self.printer.get_reactor()</code>.</p> <p>After that, it reads the configuration to get the <code>message</code> parameter, specifying <code>'Welcome to Klipper!'</code> as the default, using <code>config.get('message', 'Welcome to Klipper!')</code>.</p> <p>The next part of the initializer:</p> Register GCode command and event handler<pre><code>        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre> <p>The <code>self.gcode</code> object is used here to register the <code>GREET</code> command: </p> <p><code>self.gcode.register_command('GREET', self.cmd_GREET, desc=self.cmd_GRRET_help)</code></p> <p>The <code>self.printer</code> object is then used to register an event handler to run when Klippy starts:</p> <p><code>self.printer.register_event_handler('klippy:ready', self._ready_handler)</code></p> Event handlers <p>Klipper supports the following event handlers for extras to use:</p> <ul> <li><code>\"klippy:ready\"</code></li> <li><code>\"klippy:firmware_restart\"</code></li> <li><code>\"klippy:disconnect\"</code></li> </ul> <p>The combined initializer is: greeter.py<pre><code>    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n\n        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre></p>"},{"location":"extras/extras-ex1/#functions","title":"Functions","text":"<p>The next part of this Klippy extra is the class functions. This class has three functions aside from the initializer, two of which were mentioned in the <code>__init__</code> function:</p> <ul> <li><code>cmd_GREET</code></li> <li><code>_ready_handler</code></li> </ul> <p>This example will start with the <code>_ready_handler</code> function:</p> _ready_handler<pre><code>    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + 1\n        self.reactor.register_timer(self._greet, waketime)\n</code></pre> <p>This event handler sets a timer for one second after Klippy starts to run <code>_greet()</code>. <code>self.reactor.monotonic()</code> represents the current time, and <code>+ 1</code> adds one second. <code>self.reactor.register_timer</code> registers <code>_greet()</code> to run when <code>waketime</code> occurs.</p> _greet()<pre><code>    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n</code></pre> <p>This function uses the <code>self.gcode</code> object declared in the initializer. Here, the <code>respond_info</code> command is used (similar to running <code>RESPOND MSG=\"\"</code>) to display <code>self.message</code>.</p> What is <code>eventtime</code>? <p>You may have noticed that <code>eventtime</code> is passed to the <code>_greet()</code> function. This is because when Klippy runs <code>_greet()</code> from the previous <code>register_timer</code>, it passes <code>eventtime</code> as a parameter. This is useful if you want a function to repeat itself after a specified interval. In this case, we only want it to run once, so <code>eventtime</code> is unused.</p> The <code>self.gcode</code> object <p>The <code>self.gcode</code> object has a few useful functions:</p> <ul> <li><code>register_command</code> (used in the initializer)</li> <li><code>register_mux_command</code> (explained later)</li> <li><code>respond_info</code> (used here)</li> <li><code>run_script_from_command</code> (runs the provided string as GCode. The provided string can be multiple lines long)</li> </ul> <p>Finally, the <code>cmd_GREET</code> function:</p> cmd_GREET<pre><code>    cmd_GREET_help = \"Greet the user\"\n    def cmd_GREET(self, gcmd):\n        self._greet()\n</code></pre> <p>Here, you can see the <code>cmd_GREET_help</code> is set to a string. Next, the <code>cmd_GREET</code> function takes in a <code>gcmd</code> parameter (unused). Finally, the <code>cmd_GREET</code> function calls <code>_greet()</code>.</p> The <code>gcmd</code> parameter <p>The <code>gcmd</code> parameter allows functions to receive parameters. For example, if <code>GREET REPEAT=3</code> was called, the <code>REPEAT</code> parameter could be read as follows:</p> <pre><code>repeat = gcmd.get_int('REPEAT', 1)\n</code></pre> <p>There are a few <code>get_</code> functions that can be used with the <code>gcmd</code> parameter:</p> <ul> <li><code>get</code> returns a <code>str</code></li> <li><code>getint</code> returns an <code>int</code></li> <li><code>getfloat</code> returns a <code>float</code></li> </ul> <p><code>gcmd</code> also has a <code>respond_info</code> function, similar to the <code>self.gcode.respond_info</code> function.</p> <p>The <code>repeat</code> variable can then be used:</p> <pre><code>for _ in range(repeat):\n    self._greet()\n</code></pre>"},{"location":"extras/extras-ex1/#install","title":"Install","text":"<p>To install a Klippy extra, it has to be placed in the <code>~/klipper/klippy/extras/</code> folder. Here's a simple command to install <code>greeter.py</code>:</p> <pre><code>cp greeter.py ~/klipper/klippy/extras/greeter.py\n</code></pre> <p>You can also create an install script that uses the <code>ln</code> command to create a link to the file, rather than a copy:</p> install.sh<pre><code>ln -f greeter.py ~/klippy/klippy/extras/greeter.py\n</code></pre>"},{"location":"extras/extras-ex1/#other-things","title":"Other Things","text":"<p>A few things that are good to know before moving on:</p> <ul> <li>If your Klippy extra uses <code>load_config_prefix</code>, instead of <code>load_config</code>, you can get the name of the configuration section (e.g. <code>[greeter first]</code> is named <code>first</code>) by using:      <pre><code>config.get_name().split()[1]\n</code></pre></li> <li>If you want to learn more about additional capabilities of Klippy extras, check out the built-in Klippy extras.</li> <li>For further explanation of topics on this page, open the dropdowns.</li> </ul> <p>Next example:</p> <p>Example 2: BetterGreeter </p>"},{"location":"extras/extras-ex2/","title":"Example 2: BetterGreeter","text":"<p>Info</p> <p>This page is under construction.</p> <p>For this tutorial, we are going to improve on the greeter code used in Structure. </p> <p>For reference, the entire original greeter code is below:</p> Original Greeter <pre><code>class Greeter:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n\n        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + 1\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREET_help = \"Greet the user\"\n    def cmd_GREET(self, gcmd):\n        self._greet()\n\ndef load_config(config):\n    return Greeter(config)\n</code></pre>"},{"location":"extras/extras-ex2/#goals","title":"Goals","text":"<p>For the <code>BetterGreeter</code>, we want the following features:</p> <ul> <li>Ability to have multiple different greetings</li> <li>Allow the user to choose if they want their greeting to display after Klipper starts, and if so, to set the delay</li> <li>Allow the user to set the message of the greeting</li> </ul> <p>Here's an example configuration:</p> better_greeter.cfg<pre><code>[greeting welcome]\nmessage: Welcome to Klipper!\ndelay: 1\n\n[greeting gcode]\nmessage: Upload some GCode!\ndelay: 2\n\n[greeting print_done]\nmessage: Print completed!\n</code></pre> <p>Here's the desired behavior (anything on the line of a <code>&gt;</code> is a user-typed command):</p> <pre><code>&gt; RESTART\nWelcome to Klipper! # (1)!\nUpload some GCode! # (2)!\n&gt; GREETING NAME=print_done\nPrint completed!\n</code></pre> <ol> <li>One second after <code>RESTART</code></li> <li>Two seconds after <code>RESTART</code></li> </ol>"},{"location":"extras/extras-ex2/#creating-the-base-class","title":"Creating the Base Class","text":"<p>The first step of creating a Klippy extra is to make the base class and the config function: </p> <pre><code>class Greeting:\n    def __init__(self, config):\n        pass\n\n# (1)!\ndef load_config_prefix(config):\n    return Greeting(config)\n</code></pre> <ol> <li><code>load_config_prefix</code> is used here instead of <code>load_config</code> because there will be multiple <code>greeter</code> configuration sections.</li> </ol>"},{"location":"extras/extras-ex2/#reading-the-configuration","title":"Reading the Configuration","text":"<p>The next step of our Klippy extra is to setup the class variables and read the parameters:</p> <pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n</code></pre> <p>Here, the <code>printer</code>, <code>reactor</code>, <code>gcode</code>, and <code>message</code> variables are the same as in the previous Klippy extra. However, in this case, there are a couple new variables:</p> <ul> <li><code>name</code> is explained in the last section of Structure.</li> <li><code>delay</code> is read as an <code>int</code> from the <code>config</code> object, with default value <code>0</code>. The default value of <code>0</code> indicates it will not be run when Klippy starts.</li> </ul>"},{"location":"extras/extras-ex2/#gcode-commands-and-event-handler","title":"GCode Commands and Event Handler","text":"<p>After reading the configuration variables, we need to setup the GCode commands and event handler:</p> <pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n\n        #(1)!\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre> <ol> <li><code>register_mux_command</code> is used here because there are multiple <code>greeting</code> configuration sections, and each should be called separately.</li> </ol> <p>Here, a few parts are similar to the example in Structure, but not identical. Let's start with the GCode command.</p> <p>In the Structure example, the GCode command was registered with:</p> <p><code>self.gcode.register_command('GREET', self.cmd_GREET, desc=self.cmd_GREET_help)</code></p> <p>In this new example, the GCode command is registered with:</p> <pre><code>self.gcode.register_mux_command(\n    'GREETING',\n    'NAME',\n    self.name,\n    self.cmd_GREETING,\n    desc=self.cmd_GREETING_help\n)\n</code></pre> <p>The difference here is that there can be multiple <code>greeting</code> configuration sections, and as a result, multiple <code>Greeting</code> objects. To call each one separately, <code>register_mux_command</code> is used, passing the following parameters:</p> <ul> <li>Macro name: <code>\"GREETING\"</code></li> <li>Parameter name: <code>\"NAME\"</code></li> <li>Parameter value: <code>self.name</code></li> <li>Function: <code>self.cmd_GREETING</code></li> <li>Description <code>self.cmd_GREETING_help</code></li> </ul> <p>Next, the <code>register_event_handler</code> is nearly identical to the Structure example, except in this case, it is run only <code>if self.delay &gt; 0</code>.</p>"},{"location":"extras/extras-ex2/#functions","title":"Functions","text":"<p>The next part to creating this Klippy extra is the functions.</p> <p>There are three functions in the <code>Greeting</code> class:</p> <ul> <li><code>ready_handler</code></li> <li><code>_greet</code></li> <li><code>cmd_GREETING</code></li> </ul> Flowchart <pre><code>graph TD\nA[klippy:ready] --&gt; B[_ready_handler]\n    B --&gt; C[Wait self.delay seconds]\n    C --&gt; D[_greet]\n    D --&gt; E[Display self.message]\n    F[cmd_GREETING] --&gt; E</code></pre> <p>The first function, <code>_ready_handler</code>:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n</code></pre> <p>This function takes no parameters, and runs when Klippy reports <code>\"klippy:ready\"</code>.</p> <p>Inside, the <code>waketime</code> variable is declared as <code>self.reactor.monotonic() + self.delay</code>. Let's break this declaration down:</p> <ul> <li><code>self.reactor.monotonic()</code> This is the current Klippy time</li> <li><code>+ self.delay</code> This adds <code>self.delay</code> to the current time.</li> </ul> <p>The result is that <code>waketime</code> contains the Klippy time for <code>self.delay</code> seconds in the future. Finally, we use <code>self.reactor.register_timer</code> to register this time, telling it to run <code>self._greet()</code> when the time occurs.</p> <p>The next function, <code>_greet</code>:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n</code></pre> <p>This function takes an optional <code>eventtime</code> parameter (unused) (1), and prints out <code>self.message</code> to the Klipper console, using <code>self.gcode.respond_info</code>.</p> <ol> <li>This is passed by Klippy when it calls <code>_greet()</code> after the timer occurs.</li> </ol> <p>The final function in this class is the <code>cmd_GREETING</code> function:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREETING_help = \"Greet the user\"\n    def cmd_GREETING(self, gcmd):\n        self._greet()\n</code></pre> <p>This function simply calls <code>self._greet()</code>, which displays <code>self.message</code> to the Klipper terminal.</p>"},{"location":"extras/extras-ex2/#full-code","title":"Full Code","text":"<p>The full code of this Klippy extra is:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREETING_help = \"Greet the user\"\n    def cmd_GREETING(self, gcmd):\n        self._greet()\n\ndef load_config_prefix(config):\n    return Greeting(config)\n</code></pre> <p>You can install it following these instructions, replacing <code>greeter.py</code> with <code>greeting.py</code>.</p> <p>Last example (so far):</p> <p>Example 3: KlipperMaintenance </p>"},{"location":"extras/extras-ex3/","title":"Example 3: KlipperMaintenance","text":"<p>This last example of the Klippy extra development tutorial is actually one of my other Klipper projects: KlipperMaintenance, a maintenance reminder system for Klipper.</p> <p>This example will go through how the KlipperMaintenance code works to teach a few more important things about developing Klippy extras.</p>"},{"location":"extras/extras-ex3/#full-code","title":"Full Code","text":"<p>For this tutorial, we'll start with the full code, then break it down and explain what each section does. If you can learn to read existing Klippy extras, you can read the builtin Klippy extras when developing your own extras.</p> Full Code <pre><code>import json\nimport os\nimport time\nimport urllib.request as requests\n\nAPI_URL = 'http://localhost:7125/server/history/totals'\nHOME_DIR = os.path.expanduser('~')\n\nclass Maintenance:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.interval = config.getint('interval', 60)\n\n        self.timer_handler = None\n        self.inside_timer = self.repeat = False\n        self.printer.register_event_handler(\"klippy:ready\", self._handle_ready)\n\n        self.gcode.register_command('MAINTAIN_STATUS', self.cmd_MAINTAIN_STATUS, desc=self.cmd_MAINTAIN_STATUS_help)\n\n    def _handle_ready(self):\n        waketime = self.reactor.monotonic() + self.interval\n        self.timer_handler = self.reactor.register_timer(\n            self._gcode_timer_event, waketime)\n\n    def _gcode_timer_event(self, eventtime):\n        self.inside_timer = True\n        self.check_maintenance()\n        nextwake = eventtime + self.interval\n        self.inside_timer = self.repeat = False\n        return nextwake\n\n    def check_maintenance(self):\n        objs = self.printer.lookup_objects('maintain')\n        for obj in objs:\n            obj = obj[1]\n            if not isinstance(obj, Maintain):\n                continue\n            if obj.get_remaining() &lt; 0:\n                self.gcode.respond_info(f'Maintenance \"{obj.label}\" Expired!\\n{obj.message}')\n                self.gcode.run_script_from_command('M117 Maintenance Expired!')\n\n    cmd_MAINTAIN_STATUS_help = 'Check status of maintenance'\n    def cmd_MAINTAIN_STATUS(self, gcmd):\n        objs = self.printer.lookup_objects('maintain')\n        for obj in objs:\n            obj = obj[1]\n            if not isinstance(obj, Maintain):\n                continue\n            remain = obj.get_remaining()\n            if remain &lt; 0:\n                self.gcode.respond_info(f'Maintenance \"{obj.label}\" Expired!\\n{obj.message}')\n            self.gcode.respond_info(f'{obj.label}: {obj.get_remaining()}{obj.units} remaining')\n\nclass Maintain:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.label = config.get('label')\n\n        self.trigger = config.getchoice('trigger', ['print_time', 'filament', 'time'])\n        if self.trigger == 'print_time':\n            self.units = 'h'\n        elif self.trigger == 'filament':\n            self.units = 'm'\n        elif self.trigger == 'time':\n            self.units = 'h'\n\n        self.threshold = config.getint('threshold')\n        self.message = config.get('message')\n\n        self.init_db()\n\n        # register GCode commands\n        self.gcode.register_mux_command('CHECK_MAINTENANCE', 'NAME', self.name, self.cmd_CHECK_MAINTENANCE, desc=self.cmd_CHECK_MAINTENANCE_help)\n        self.gcode.register_mux_command('UPDATE_MAINTENANCE', 'NAME', self.name, self.cmd_UPDATE_MAINTENANCE, desc=self.cmd_UPDATE_MAINTENANCE_help)\n\n    def fetch_history(self):\n        resp = requests.urlopen(API_URL) # fetch data from Moonraker History API\n        try:\n            json_data = json.loads(resp.read())\n        except Exception:\n            self.gcode.respond_info(f'Data {resp.read()}')\n            return {\n                'print_time': 0,\n                'filament': 0,\n                'time': time.time()/3600\n            }\n\n        job_totals = json_data['result']['job_totals'] # get job totals from JSON response\n        return {\n            'print_time': job_totals['total_time']/3600,\n            'filament': job_totals['total_filament_used']/1000,\n            'time': time.time()/3600\n        }\n\n    def init_db(self):\n        data = self.fetch_db()\n        if data is None:\n            data = self.fetch_history()\n            self.update_db(data)\n\n    def fetch_db(self):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}')\n        if os.path.exists(path):\n            with open(path, 'r') as file:\n                try:\n                    data = json.load(file)\n                except:\n                    data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n                return data\n\n    def update_db(self, new):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}')\n        os.makedirs(os.path.dirname(path), exist_ok=True)\n        with open(path, 'w+') as file:\n            try:\n                data = json.load(file)\n            except:\n                data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n            data.update(new)\n            json.dump(data, file)\n        return data\n\n    def get_remaining(self):\n        last = self.fetch_db()[self.trigger]\n        now = self.fetch_history()[self.trigger]\n        return round(self.threshold - (now - last), 2)\n\n    cmd_CHECK_MAINTENANCE_help = 'Check maintenance'\n    def cmd_CHECK_MAINTENANCE(self, gcmd):\n        gcmd.respond_info(f'''\nMaintenance {self.label} Status:\nNext maintenance in {self.get_remaining()}{self.units}\nMaintenance message: {self.message}\n        '''.strip())\n\n    cmd_UPDATE_MAINTENANCE_help = 'Update maintenance'\n    def cmd_UPDATE_MAINTENANCE(self, gcmd):\n        self.update_db(self.fetch_history())\n\ndef load_config(config):\n    return Maintenance(config)\n\ndef load_config_prefix(config):\n    return Maintain(config)\n</code></pre>"},{"location":"extras/extras-ex3/#structure","title":"Structure","text":"<p>The class structure of this Klippy extra is shown in this flowchart:</p> <pre><code>classDiagram\n    class Maintain{\n        str name\n        str label\n        str trigger\n        int threshold\n        str message\n        fetch_history()\n        init_db()\n        fetch_db()\n        update_db(new)\n        get_remaining()\n        cmd_CHECK_MAINTENANCE(gcmd)\n        cmd_UPDATE_MAINTENANCE(gcmd)\n    }\n    note for Maintain \"trigger must be one of:\\n - print_time\\n - filament\\n - time\"\n\n    class Maintenance{\n        int interval\n        _handle_ready()\n        _gcode_timer_event()\n        check_maintenance()\n        cmd_MAINTAIN_STATUS(gcmd)\n    }\n\n    Maintenance &lt;|-- Maintain: Has-a</code></pre> <p>This diagram has a lot of information, but the key points are:</p> <ul> <li>Multiple <code>Maintain</code> objects are managed by one <code>Maintainence</code> object.</li> <li>The <code>Maintain</code> class handles maintenance reminders, the <code>CHECK_MAINTENANCE</code> command, and the <code>UPDATE_MAINTENANCE</code> command.</li> <li>The <code>Maintenance</code> class handles the <code>MAINTAIN_STATUS</code> command.</li> <li>A <code>[maintain name]</code> section corresponds to the <code>Maintain</code> class (multiple).</li> <li>A <code>[maintain]</code> section corresponds to the <code>Maintenance</code> class (one).</li> </ul> <p>The base code for this is:</p> maintain.py<pre><code>import json\nimport os\nimport time\nimport urllib.request as requests\n\nAPI_URL = 'http://localhost:7125/server/history/totals'\nHOME_DIR = os.path.expanduser('~')\n\nclass Maintenance:\n    pass\n\nclass Maintain:\n    pass\n\n# (1)!\ndef load_config(config):\n    return Maintenance(config)\n\n# (2)!\ndef load_config_prefix(config):\n    return Maintain(config)\n</code></pre> <ol> <li>This function corresponds to a <code>[maintain]</code> config section.</li> <li>This function corresponds to a <code>[maintain name]</code> config section.</li> </ol> <p>The highlighted section in the code contains the classes, and the configuration loading, the parts relevant to this first section. The code above the highlighted section includes the relevant module imports and constant declarations (both explained later).</p> <p>Much of the content in this example will be embedded in the code (usually the highlighted section) as a plus sign, like this: (1)</p> <ol> <li>Click some more plus marks in the code to learn more about the code.</li> </ol>"},{"location":"extras/extras-ex3/#maintain-class","title":"<code>Maintain</code> class","text":"<p>This next section of the example will focus on the <code>Maintain</code> class.</p>"},{"location":"extras/extras-ex3/#initializer","title":"Initializer","text":"<p>When <code>load_config_prefix</code> creates a <code>Maintain</code> object, it starts in the initializer. </p> <p>Here's the full initializer, with explanations embedded inside with plus signs. Below is a more general breakdown of the initializer for clarity.</p> maintain.py<pre><code>class Maintain:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1] # (1)!\n\n        self.label = config.get('label')\n\n        # (2)!\n        self.trigger = config.getchoice('trigger', ['print_time', 'filament', 'time']) \n        if self.trigger == 'print_time': # (3)!\n            self.units = 'h'\n        elif self.trigger == 'filament':\n            self.units = 'm'\n        elif self.trigger == 'time':\n            self.units = 'h'\n\n        self.threshold = config.getint('threshold')\n        self.message = config.get('message')\n\n        # (4)!\n        self.init_db()\n\n        self.gcode.register_mux_command('CHECK_MAINTENANCE', 'NAME', self.name, self.cmd_CHECK_MAINTENANCE, desc=self.cmd_CHECK_MAINTENANCE_help)\n        self.gcode.register_mux_command('UPDATE_MAINTENANCE', 'NAME', self.name, self.cmd_UPDATE_MAINTENANCE, desc=self.cmd_UPDATE_MAINTENANCE_help)\n</code></pre> <ol> <li><code>config.get_name()</code> returns the full config name, like <code>\"maintain name\"</code>. The <code>.split()[1]</code> splits the name by spaces and gets the last \"word\".</li> <li><code>config.getchoice()</code> allows you to only accept values in a certain list.</li> <li>This part of the initializer chooses the units based on the <code>trigger</code> type:<ul> <li><code>\"print_time\"</code>: <code>\"h\"</code></li> <li><code>\"filament\"</code>: <code>\"m\"</code></li> <li><code>\"time\"</code>: <code>\"h\"</code></li> </ul> </li> <li>This is explained later, in functions.</li> </ol> <p>The major breakdown of this initializer is:</p> <ul> <li>First highlighted section: Load basic objects</li> <li>Second highlighted section: Read configuration options</li> <li>Third highlighted section: Register GCode commands</li> </ul> <p>The line <code>self.init_db()</code> will be explained later in functions.</p>"},{"location":"extras/extras-ex3/#functions","title":"Functions","text":"<p>The next part of the <code>Maintain</code> class is its functions. The functions in this class are, broken down into two sections:</p> <p>Database:</p> <ul> <li><code>fetch_history()</code></li> <li><code>init_db()</code></li> <li><code>fetch_db()</code></li> <li><code>update_db(new)</code></li> </ul> <p>GCode:</p> <ul> <li><code>get_remaining()</code></li> <li><code>cmd_CHECK_MAINTENANCE(gcmd)</code></li> <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li> </ul> <p>First, the database functions (again, plus signs throughout the code explain in more detail what each part does):</p> maintain.py<pre><code>class Maintain:\n    ...\n    def fetch_history(self):\n        resp = requests.urlopen(API_URL) # fetch data from Moonraker History API\n        try:\n            json_data = json.loads(resp.read()) \n        except Exception:\n            self.gcode.respond_info(f'Data {resp.read()}')\n            return {\n                'print_time': 0,\n                'filament': 0,\n                'time': time.time()/3600\n            } # (1)!\n\n        job_totals = json_data['result']['job_totals'] # get job totals from JSON response\n        return {\n            'print_time': job_totals['total_time']/3600,\n            'filament': job_totals['total_filament_used']/1000,\n            'time': time.time()/3600\n        } # (2)!\n\n    def init_db(self):\n        data = self.fetch_db() # Load the database\n        if data is None:\n            data = self.fetch_history()\n            self.update_db(data) # Update the database with history data\n\n    def fetch_db(self):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}') # (3)!\n        if os.path.exists(path):\n            with open(path, 'r') as file:\n                try:\n                    data = json.load(file) # JSON parse the file contents\n                except:\n                    data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n                return data # Return parsed data\n\n    def update_db(self, new):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}') # (3)!\n        os.makedirs(os.path.dirname(path), exist_ok=True) # (4)!\n        with open(path, 'w+') as file: # The \"w+\" file operator allows reading and writing\n            try:\n                data = json.load(file) # JSON parse the file contents\n            except:\n                data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n            data.update(new) # Update the file contents with the new data\n            json.dump(data, file) # JSON write the new data to the file\n        return data # Return the new updated data\n</code></pre> <ol> <li>In case of an error, empty placeholder data is returned.</li> <li>If history fetch was successful, return the data read from the Moonraker History API.</li> <li>The <code>path</code> is (if the username is <code>pi</code> and <code>self.name</code> is <code>\"lubricate\"</code>) <code>\"/home/pi/maintain-db/lubricate\"</code>. Even though it has no file extension, it stores JSON data.</li> <li>The first time running this, the <code>maintain-db</code> folder won't exist. <code>os.makedirs</code> creates the folder, and <code>exist_ok=True</code> doesn't throw an error if it already exists.</li> </ol> <p>The flow of information in this Klippy extra is:</p> <ul> <li><code>init_db()</code> is called when Klippy starts</li> <li><code>fetch_db()</code> is called to read the stored database</li> <li>If the data returned by <code>fetch_db()</code> is <code>None</code> (database is empty)<ul> <li><code>fetch_history()</code> is called to fetch the history stored by Moonraker</li> <li><code>update_db()</code> is called to update the database with the newly fetched data.</li> </ul> </li> </ul> <p>Calling <code>update_db()</code> will erase the current maintenance state (resetting the timer/filament counter).</p> <p>The next section of functions in the <code>Maintain</code> class are the GCode commands. There are three functions in this section:</p> <ul> <li><code>get_remaining()</code></li> <li><code>cmd_CHECK_MAINTENANCE(gcmd)</code></li> <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li> </ul>"},{"location":"extras/extras-start/","title":"Start Writing Klippy Extras","text":"<p>While DynamicMacros makes Klipper macros much more powerful, sometimes a Klippy extra is required for more functionality. In this tutorial, you will learn how to develop a Klippy extra and test it using DynamicMacros.</p> <p>Info</p> <p>To write a Klipper extra, you should be fluent in Python.</p> <p>Info</p> <p>This guide is still under construction</p> Klipper vs Klippy <p>To limit confusion, I'm going to explain this here. \"Klipper\" is the name of the firmware running on your 3D printer. \"Klippy\" is the name of the software running on your Klipper Host (usually a Raspberry Pi). Klipper is written in C code, and Klippy is mostly written in Python.</p> <p>Start writing your first Klippy extra:</p> <p>Start </p>"},{"location":"features/delayed/","title":"Delayed GCode","text":"<p>Dynamic Macros supports a feature similar to <code>delayed_gcode</code>.</p>"},{"location":"features/delayed/#configuration","title":"Configuration","text":"<p>To configure a DynamicMacro to be run repeatedly/after a delay, update your macro as follows:</p> BeforeAfter <pre><code>[gcode_macro test]\ngcode:\n    RESPOND MSG=\"test\"\n</code></pre> <pre><code>[gcode_macro test]\ninitial_duration: 2 # Wait two seconds after Klipper starts to run this, and two seconds between repeats (if enabled)\nrepeat: true # true means repeat, false means don't repeat\ngcode:\n    RESPOND MSG=\"test\"\n</code></pre>"},{"location":"features/delayed/#parameters","title":"Parameters","text":"<p><code>initial_duration</code> specifies the delay after Klipper starts that the macro will be run, and the duration between repeats, if <code>repeat</code> is true.</p> <p><code>repeat</code> specifies whether or not to repeat the macro.</p>"},{"location":"features/python/","title":"Python","text":"<p>Dynamic Macros's most powerful feature allows you to run Python code directly from within a macro.</p>"},{"location":"features/python/#running-python-from-within-a-macro","title":"Running Python from within a Macro","text":"<p>Disclaimer</p> <p>This functionality allows Dynamic Macros to gain significant control over your printer and Klipper host. I am not responsible for whatever happens if you download a malicious macro.</p> <p>There are three main reasons why this could be helpful:</p> <ol> <li>Allowing for deeper control of Klipper and the Klipper host</li> <li>A learning bridge for creating Klipper plugins/extras</li> <li>A tool to help develop Klipper plugins/extras without restarting Klipper</li> </ol> <p>To run Python from within a Dynamic Macro, use either the <code>python()</code> utility function, or the <code>python_file()</code> utility function. The <code>python()</code> function accepts python code as a multiline string, and the <code>python_file()</code> function accepts a filename (relative to your <code>printer.cfg</code> folder).</p> <p>Tip</p> <p>When using the <code>python()</code> utiltiy function, Jinja2 (which converts the macro to GCode) may throw errors during parsing. If you are getting errors, it is recommended to switch to <code>python_file()</code>.</p> <p>Here are a few examples:</p>"},{"location":"features/python/#python-math","title":"Python Math","text":"macros.cfg<pre><code>[gcode_macro MATH]\ngcode:\n    {% set value = python(\"\"\"\n    a = kwargs['a']\n    b = kwargs['b']\n    c = a + b\n    output(c)\n    \"\"\", a=1, b=2) %}\n    RESPOND MSG={value}\n</code></pre>"},{"location":"features/python/#python-file-running-gcode","title":"Python File Running GCode","text":"macros.cfg<pre><code>[gcode_macro PYFILE]\ngcode:\n    {% set value = python_file(\"test.py\") %}\n    RESPOND MSG={value}\n</code></pre> test.py<pre><code>print(\"Hello from Python!\")\ngcode(\"G28\\nG1 X100 Y100 Z100 F1200\")\noutput(\"GCode Executed\")\n</code></pre>"},{"location":"features/receivingvariables/","title":"Receiving Variable Updates","text":"<p>Unlike normal <code>gcode_macro</code>s, Dynamic Macros supports receiving variable updates within the same macro. For example, the following macro will show the same output in both <code>M117</code>s:</p> <pre><code>[gcode_macro STATIC_MOVE]\ngcode:\n  G28\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position before macro run\n  G90\n  G1 Z20\n  M117 After: {printer.toolhead.position.z}\n  # Above displays same position\n</code></pre> <p>However, this macro will show different outputs based on the current Z position of the toolhead:</p> <pre><code>[gcode_macro DYNAMIC_MOVE]\ngcode:\n  G28\n\n\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position after G28\n  G90\n  G1 Z20\n\n\n  M117 After: {printer.toolhead.position.z}\n  # Above displays position after G1\n</code></pre> <p>Notice the large whitespaces. Three newline characters (two blank lines) between code segments denotes a variable update. However, some variables won't be preserevd across the whitespace.</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = 10 %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs nothing\n</code></pre> <p>You can use the <code>update()</code> function to preserve certain variables across the whitespaces:</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = update(\"num\", 10) %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs 10\n</code></pre> <p>See Examples for examples.</p>"},{"location":"features/recursion/","title":"Recursion","text":"<p>Unlike normal <code>gcode_macro</code>s, Dynamic Macros supports recursion (allowing a macro to call itself). For more examples, see Examples</p>"},{"location":"features/utilities/","title":"Utility Functions","text":"<p>Dynamic Macros provides a few utility functions to make Dynamic Macros easier to write.</p>"},{"location":"features/utilities/#update","title":"update()","text":"<p>The <code>update()</code> function allows to save variables across whitespaces (see Receiving Variables for more information). Example:</p> <pre><code>[gcode_macro MY_MACRO]\ngcode:\n    {% set a = 10 %}\n    {% set b = update(\"b\", 20) %}\n    RESPOND MSG=\"A: {a}\" # 10\n    RESPOND MSG=\"B: {b}\" # 20\n\n\n    RESPOND MSG=\"A: {a}\" # \"\"\n    RESPOND MSG=\"B: {b}\" # 20\n</code></pre>"},{"location":"features/utilities/#get_macro_variables","title":"get_macro_variables()","text":"<p>The <code>get_macro_variables()</code> function allows to retrieve all the variables from another macro in one line of code. Example:</p> <pre><code>[gcode_macro MY_SETTINGS]\nvariable_a: 10\nvariable_b: 20\ngcode:\n    RESPOND MSG=\"settings\"\n\n[gcode_macro GET_SETTINGS]\ngcode:\n    {% set settings = get_macro_variables(\"MY_SETTINGS\") %}\n    RESPOND MSG=\"Settings: {settings}\"\n    RESPOND MSG=\"A: {settings.a}\"\n</code></pre>"},{"location":"features/utilities/#update_from_dict","title":"update_from_dict()","text":"<p>The <code>update_from_dict()</code> function allows for saving the output of <code>get_macro_variables()</code> (or other dictionaries) across the whitespaces when Receiving Variables. Example:</p> <pre><code>[gcode_macro MY_SETTINGS]\nvariable_a: 10\nvariable_b: 20\ngcode:\n    RESPOND MSG=\"settings\"\n\n[gcode_macro GET_SETTINGS]\ngcode:\n    {% set settings = get_macro_variables(\"MY_SETTINGS\") %}\n    {% set settings = update_from_dict(settings) %}\n\n\n    RESPOND MSG=\"A: {a}\" # 10\n    RESPOND MSG=\"B: {b}\" # 20\n</code></pre>"},{"location":"features/variables/","title":"Variables","text":"<p>Dynamic Macro variables work nearly the same way as standard <code>gcode_macro</code> variables. This guide covers the differences.</p>"},{"location":"features/variables/#set_dynamic_variable","title":"SET_DYNAMIC_VARIABLE","text":"<p>Instead of using <code>SET_GCODE_VARIABLE</code>, Dynamic Macros use <code>SET_DYNAMIC_VARIABLE</code> to update Dynamic Macro variables. Example (assuming <code>VAR_TEST</code> is defined from Utilities):</p> <pre><code>SET_DYNAMIC_VARIABLE MACRO=var_test VARIABLE=a VALUE=15\n</code></pre>"},{"location":"tutorial/","title":"Table of Contents","text":"<p>Follow this tutorial to learn how to create Dynamic Macros and to use its powerful features.</p>"},{"location":"tutorial/#standard-macros","title":"Standard Macros","text":"<p>Before writing macros, it's a good idea to learn how to write standard <code>gcode_macro</code>s. Here is an amazing guide on how to write standard macros.</p>"},{"location":"tutorial/#table-of-contents_1","title":"Table of Contents","text":"<ol> <li>Converting to Dynamic Macros</li> <li>Using Dynamic Macros Features</li> <li>Experimental Features</li> </ol>"},{"location":"tutorial/converting/","title":"Converting to Dynamic Macros","text":"<p>Follow this tutorial to convert your standard <code>gcode_macro</code> to a Dynamic Macro. </p>"},{"location":"tutorial/converting/#printercfg","title":"printer.cfg","text":"<p>First, remove the <code>include</code> line in your <code>printer.cfg</code> referencing the file your macros are in. For example, if your macros are in <code>macros.cfg</code>, remove the line:</p> <pre><code>[include macros.cfg]\n</code></pre> <p>from your <code>printer.cfg</code>.</p>"},{"location":"tutorial/converting/#dynamic-macros-configuration","title":"Dynamic Macros Configuration","text":"<p>Next, if you don't already have one, create a <code>[dynamicmacros]</code> config section in your <code>printer.cfg</code> and add your macro configuration to it:</p> printer.cfg<pre><code>[dynamicmacros]\nconfig_path: ~/printer_data/config # If you left your printer configuration path as the default, you don't need to specify this\nconfigs: macros.cfg # You can add more files to this list, separated by commas.\n</code></pre> KlipperScreen <p>If you convert your <code>LOAD_FILAMENT</code> and <code>UNLOAD_FILAMENT</code> macros to be dynamic, KlipperScreen may not recognize them and report an error. To fix this, add blank macros to your <code>printer.cfg</code>, before your <code>[dynamicmacros]</code> section. Example: printer.cfg<pre><code>[gcode_macro LOAD_FILAMENT]\ngcode:\n    M117 LOAD\n[gcode_macro UNLOAD_FILAMENT]\ngcode:\n    M117 UNLOAD\n</code></pre></p> Unknown config object 'gcode_macro' <p>If you are getting a \"Unknown config object 'gcode_macro'\" error after converting your macros to Dynamic Macros, move your <code>[dynamicmacros]</code> section to be after your <code>[virtual_sdcard]</code> section.</p> Nacro Names <p>Klipper has certain macro names reserved for core functionality. If you are experiencing errors, don't name your Dynamic Macros any of the following:</p> <ul> <li><code>PAUSE</code></li> <li><code>RESUME</code></li> <li><code>CANCEL_PRINT</code></li> </ul> <p>If you want to make those macros dynamic, first define them as a standard GCode macro:</p> <pre><code>[gcode_macro PAUSE]\ngcode:\n    DYNAMIC_PAUSE\n</code></pre> <p>Restart Klipper.</p> <p>That's it. Your macros are now Dynamic Macros.</p>"},{"location":"tutorial/experimental/","title":"Experimental Features","text":"<p>Warning</p> <p>The features on this page are experimental, and untested or only lightly tested. Proceed at your own risk.</p>"},{"location":"tutorial/usingfeatures/","title":"Using Dynamic Macros Features","text":"<p>Now that your macros are dynamic, you can use the powerful feature set of Dynamic Macros.</p>"},{"location":"tutorial/usingfeatures/#recursion","title":"Recursion","text":"<p>Recursion allows a macro to call itself, something standard GCode macros can't do. </p> <p>When using recursion, it's important to make sure your macro has an \"end case\". This is a case when the macro won't call itself again. Otherwise the macro will be stuck in an infinite loop and freeze Klipper.</p> <p>Here are a few examples of recursion:</p> Counting to 10<pre><code>[gcode_macro COUNT]\ngcode:\n    {% set num = params.NUM|default(1)|int %}\n    {% if num &lt;= 10 %}\n        RESPOND MSG={num}\n        COUNT NUM={num+1} # Count up 1\n    {% else %}\n        RESPOND MSG=\"Done Counting\"\n    {% endif %}\n</code></pre> Load to Filament Sensor<pre><code>[gcode_macro LOAD_TO_FSENSOR]\ngcode:\n    {% set val = printer[\"filament_sensor fsensor\"].filament_detected %}\n    {% if val == 0 %}\n        M83\n        G1 E50 F900 # Move filament 50mm forwards\n        RESPOND MSG=\"Waiting for fsensor\"\n        LOAD_TO_FSENSOR # Recursion\n    {% else %}\n        G1 E65 F900 # Move filament to nozzle\n        RESPOND MSG=\"Filament Loaded\"\n    {% endif %}\n</code></pre>"},{"location":"tutorial/usingfeatures/#receiving-variable-updates","title":"Receiving Variable Updates","text":"<p>Receiving variable updates allows Dynamic Macros to update variables without rerunning the macro. </p> <p>An example of this is getting the printer's position. A standard GCode macro will evaluate all the variables, then run the GCode. However, using three newlines (two blank lines) between code segments in Dynamic Macros will allow each segment to be evaluated at runtime, allowing for variable updates.</p>"},{"location":"tutorial/usingfeatures/#utility-functions","title":"Utility Functions","text":"<p>See the link above (the subtitle) for more information on utility functions.</p>"},{"location":"tutorial/usingfeatures/#python","title":"Python","text":"<p>Dynamic Macro's most powerful feature allows you to run Python code from within a macro. See the link above (the subtitle) for more information.</p>"},{"location":"tutorial/usingfeatures/#delayed_gcode","title":"delayed_gcode","text":"<p>Dynamic Macros supports a feature similar to <code>delayed_gcode</code>. See the link above (the subtitle) for more information.</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Klipper Dynamic Macros","text":"<p>Never restart Klipper again for simple macros.</p> <p></p> <p>Klipper Dynamic Macros is an unofficial way to update macros without restarting Klipper, so you can update macros mid-print and see their results live. It also supports extra features that normal GCode Macros don't have.</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Recursion</li> <li>Receiving Variables</li> <li>Utility Functions</li> <li>Variables</li> <li>Python</li> <li>Delayed GCode</li> </ul>"},{"location":"#how-normal-macros-work","title":"How Normal Macros Work","text":"<p>Your macros are written in a <code>.cfg</code> file, then included into your <code>printer.cfg</code>. When Klipper restarts, it parses these files and saves the macros internally (you can't change them without restarting Klipper). When a macro is called, the cached code is interpreted and run.</p>"},{"location":"#how-dynamic-macros-work","title":"How Dynamic Macros Work","text":"<p>Your macros are written in a <code>.cfg</code> file, then the relative path to that file is configured in a <code>[dynamicmacros]</code> config section. The config files are read and parsed every time you run the <code>DYNAMIC_MACRO</code> command, allowing you to update macros without restarting Klipper.</p>"},{"location":"#klippy-extras-tutorial","title":"Klippy Extras Tutorial","text":"<p>DynamicMacros also includes a tutorial on writing Klippy extras.</p>"},{"location":"#get-started","title":"Get Started","text":"<p>Follow Setup to get started with Dynamic Macros.</p>"},{"location":"#planned-features","title":"Planned Features","text":"<p>See Development Status for the currently available features, and planned features.</p>"},{"location":"#examples","title":"Examples","text":"<p>See Example Macros for examples of Dynamic Macros.</p>"},{"location":"#more-projects","title":"More Projects","text":"<p>If you like this project, don't forget to give it a star! Also, check out the 3MS, a modular multimaterial system for Klipper!</p>"},{"location":"devstatus/","title":"Development Status","text":""},{"location":"devstatus/#features","title":"Features","text":"<ul> <li>Editing macros without restarting Klipper</li> <li>Accessing printer information from within Dynamic Macros</li> <li>Accessing parameters from within Dynamic Macros</li> <li>Adding new Dynamic Macros without restarting Klipper</li> <li>Removing existing Dynamic Macros without restarting Klipper</li> <li>Renaming Dynamic Macros without restarting Klipper</li> <li>Dynamic Macro descriptions</li> <li>Dynamic Macro variables</li> <li>Retrieving variables from other macros</li> <li>Support for <code>rename_existing</code></li> <li>Running Python from within a Dynamic Macro</li> <li>Dynamic <code>delayed_gcode</code> implementation</li> </ul>"},{"location":"devstatus/#planned-features","title":"Planned Features","text":"<p>A checkmark indicates a feature is experimental.</p> <ul> <li> Allow configuring multiple <code>dynamicmacros</code> config sections as clusters<ul> <li> Disable Python per-cluster</li> <li> Disable <code>printer</code> object per-cluster</li> </ul> </li> <li> Better error handling</li> <li> Klippy extras tutorial</li> </ul>"},{"location":"examples/","title":"Example Macros","text":"<p>This page will hold several different Dynamic Macro examples. Note that most of the examples here are specific to Dynamic Macros only.</p>"},{"location":"examples/#m900","title":"M900","text":"<p>Normal Macro</p> <p>In Marlin, M900 K is used to set pressure/linear advance. Now, you can use it in Klipper too:</p> <pre><code>[gcode_macro M900]\ndescription: Set Pressure Advance\ngcode:\n  {% set k = params.K|default(0)|float %}\n  {% if k &lt; 1 %}\n    SET_PRESSURE_ADVANCE ADVANCE={k}\n  {% endif %}\n</code></pre>"},{"location":"examples/#recursion","title":"Recursion","text":"<p>Dynamic Macro</p> <p>These are a few example Dynamic Macros to demonstrate the recursive functionality of Dynamic Macros.</p> Counting to 10<pre><code>[gcode_macro COUNT]\ngcode:\n    {% set num = params.NUM|default(1)|int %}\n    {% if num &lt;= 10 %}\n        RESPOND MSG={num}\n        COUNT NUM={num+1} # Count up 1\n    {% else %}\n        RESPOND MSG=\"Done Counting\"\n    {% endif %}\n</code></pre> Load to Filament Sensor<pre><code>[gcode_macro LOAD_TO_FSENSOR]\ngcode:\n    {% set val = printer[\"filament_sensor fsensor\"].filament_detected %}\n    {% if val == 0 %}\n        M83\n        G1 E50 F900 # Move filament 50mm forwards\n        RESPOND MSG=\"Waiting for fsensor\"\n        LOAD_TO_FSENSOR # Recursion\n    {% else %}\n        G1 E65 F900 # Move filament to nozzle\n        RESPOND MSG=\"Filament Loaded\"\n    {% endif %}\n</code></pre>"},{"location":"examples/#receiving-position-updates","title":"Receiving Position Updates","text":"<p>Dynamic Macro</p> <p>This is an example Dynamic Macro to demonstrate the ability to receive position updates from within the same macro.</p> <pre><code>[gcode_macro DYNAMIC_MOVE]\ngcode:\n  G28\n\n\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position after G28\n  G90\n  G1 Z20\n\n\n  M117 After: {printer.toolhead.position.z}\n  # Above displays position after G1\n</code></pre>"},{"location":"examples/#preserving-variables","title":"Preserving Variables","text":"<p>Dynamic Macro</p> <p>This is an example of how to preserve variables across triple-newlines in Dynamic Macros.</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = update(\"num\", 10) %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs 10\n</code></pre>"},{"location":"setup/","title":"Setup","text":"<p>Follow this guide to setup and confiure Dynamic Macros.</p>"},{"location":"setup/#install","title":"Install","text":"<p>Run in your terminal:</p> <pre><code>cd ~\ngit clone https://github.com/3DCoded/DynamicMacros\ncd DynamicMacros\nsh install.sh\nsudo service klipper restart\n</code></pre> <p>Add to your <code>moonraker.conf</code>:</p> moonraker.conf<pre><code># DynamicMacros Update Manager\n[update_manager DynamicMacros]\ntype: git_repo\npath: ~/DynamicMacros\norigin: https://github.com/3DCoded/DynamicMacros.git\nprimary_branch: main\nis_system_service: False\ninstall_script: install.sh\n</code></pre>"},{"location":"setup/#updating","title":"Updating","text":"<p>First, update via Moonraker's update manager. Then run in your terminal:</p> <pre><code>cd ~/DynamicMacros\nsh install.sh\nsudo service klipper restart\n</code></pre>"},{"location":"setup/#configuration","title":"Configuration","text":"<p>To configure Dynamic Macros, put in your <code>printer.cfg</code> (or a file included in it):</p> printer.cfg<pre><code>[dynamicmacros]\nconfig_path: ~/printer_data/config # If you left your printer configuration path as the default, you don't need to specify this\nconfigs: dynamic.cfg\n</code></pre> <p>Create a new file in the same folder as your <code>printer.cfg</code> called <code>dynamic.cfg</code>. In it, configure some macros like you normally would. Example:</p> dynamic.cfg<pre><code>[gcode_macro MYTEST]\ngcode:\n    M117 Hello world!\n\n[gcode_macro HEAT_HOTEND]\ngcode:\n    {% set temp = params.TEMP|int %}\n    M104 S{temp}\n</code></pre> <p>Restart Klipper.</p> <p>Info</p> <p>Updating the <code>[dynamicmacros]</code> config section requires a Klipper restart. The files listed in the <code>macros:</code> parameter must be present when Klipper restarts.</p>"},{"location":"setup/#testing","title":"Testing","text":"<p>If you run the command <code>MYTEST</code>, the output should be: <pre><code>Hello world!\n</code></pre></p> <p>If you runthe command <code>HEAT_HOTEND TEMP=200</code>, the hotend should start heating up. </p> <p>Next, edit the <code>MYTEST</code> macro to output something else, like <code>Test successful!</code></p> dynamic.cfg<pre><code>[gcode_macro MYTEST]\ngcode:\n    M117 Test successful!\n</code></pre> <p>Save the file, but do not restart Klipper.</p> <p>Run <code>MYTEST</code> again, and the output should be: <pre><code>Test successful!\n</code></pre></p>"},{"location":"setup/#features","title":"Features","text":"<ul> <li>Recursion</li> <li>Receiving Variable Updates</li> <li>Utility Functions</li> <li>Variables</li> </ul>"},{"location":"setup/#tutorial","title":"Tutorial","text":"<p>Follow the Tutorial.</p>"},{"location":"setup/#when-to-restart-klipper-or-reload-dynamic-macros","title":"When to Restart Klipper or Reload Dynamic Macros","text":"<p>Dynamic Macros provides a utility <code>DYNAMIC_MACRO</code> command to run macros manually, and to refresh the macros. Usage examples (assuming M900 is defined as a Dynamic Macro):</p> <pre><code>DYNAMIC_MACRO MACRO=M900 K=0.035\n</code></pre> <p>is the same as:</p> <pre><code>M900 K0.035\n</code></pre> <p>To refresh Dynamic Macros, just run <code>DYNAMIC_MACRO</code> with no parameters.</p> <p>A Klipper restart is required if:</p> <ul> <li>You changed the <code>description</code></li> <li>You changed the <code>initial_duration</code></li> <li>You changed the <code>repeat</code></li> </ul> <p>A <code>DYNAMIC_MACRO</code> refresh is required if:</p> <ul> <li>You created a new macro</li> <li>You renamed an existing macro</li> <li>You changed the contents of a macro</li> <li>You deleted an existing macro</li> </ul>"},{"location":"extras/extras-ex1/","title":"Example 1: Greeter (Structure)","text":"<p>Before you start to write a Klippy extra, it is important to understand the structure of a Klippy extra. </p> <p>In Python, a Klippy extra is defined as a class, then referenced in a function at the end of the file. Example:</p> greeter.py<pre><code>class Greeter:\n...\n\ndef load_config(config):\n    return Greeter(config)\n</code></pre> <p>There are two functions that can be used at the end of a file:</p> <ul> <li><code>load_config_prefix</code>, allows for configurations like <code>[greeter mygreeter]</code></li> <li><code>load_config</code>, like in this example, allows for configurations like <code>[greeter]</code></li> </ul>"},{"location":"extras/extras-ex1/#initializer","title":"Initializer","text":"<p>In the last line of the above code block, you can see that a <code>config</code> object is passed as a parameter to the <code>Greeter</code> object. The initializer of the <code>Greeter</code> class is shown below in sections:</p> Get printer objects and configuration options<pre><code>    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n</code></pre> <p>This section gets the <code>printer</code> object with <code>config.get_printer()</code>.</p> <p>It then gets the <code>gcode</code> object with <code>self.printer.lookup_object('gcode')</code>.</p> <p>Then, it gets the <code>reactor</code> object with <code>self.printer.get_reactor()</code>.</p> <p>After that, it reads the configuration to get the <code>message</code> parameter, specifying <code>'Welcome to Klipper!'</code> as the default, using <code>config.get('message', 'Welcome to Klipper!')</code>.</p> <p>The next part of the initializer:</p> Register GCode command and event handler<pre><code>        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre> <p>The <code>self.gcode</code> object is used here to register the <code>GREET</code> command: </p> <p><code>self.gcode.register_command('GREET', self.cmd_GREET, desc=self.cmd_GRRET_help)</code></p> <p>The <code>self.printer</code> object is then used to register an event handler to run when Klippy starts:</p> <p><code>self.printer.register_event_handler('klippy:ready', self._ready_handler)</code></p> Event handlers <p>Klipper supports the following event handlers for extras to use:</p> <ul> <li><code>\"klippy:ready\"</code></li> <li><code>\"klippy:firmware_restart\"</code></li> <li><code>\"klippy:disconnect\"</code></li> </ul> <p>The combined initializer is: greeter.py<pre><code>    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n\n        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre></p>"},{"location":"extras/extras-ex1/#functions","title":"Functions","text":"<p>The next part of this Klippy extra is the class functions. This class has three functions aside from the initializer, two of which were mentioned in the <code>__init__</code> function:</p> <ul> <li><code>cmd_GREET</code></li> <li><code>_ready_handler</code></li> </ul> <p>This example will start with the <code>_ready_handler</code> function:</p> _ready_handler<pre><code>    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + 1\n        self.reactor.register_timer(self._greet, waketime)\n</code></pre> <p>This event handler sets a timer for one second after Klippy starts to run <code>_greet()</code>. <code>self.reactor.monotonic()</code> represents the current time, and <code>+ 1</code> adds one second. <code>self.reactor.register_timer</code> registers <code>_greet()</code> to run when <code>waketime</code> occurs.</p> _greet()<pre><code>    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n</code></pre> <p>This function uses the <code>self.gcode</code> object declared in the initializer. Here, the <code>respond_info</code> command is used (similar to running <code>RESPOND MSG=\"\"</code>) to display <code>self.message</code>.</p> What is <code>eventtime</code>? <p>You may have noticed that <code>eventtime</code> is passed to the <code>_greet()</code> function. This is because when Klippy runs <code>_greet()</code> from the previous <code>register_timer</code>, it passes <code>eventtime</code> as a parameter. This is useful if you want a function to repeat itself after a specified interval. In this case, we only want it to run once, so <code>eventtime</code> is unused.</p> The <code>self.gcode</code> object <p>The <code>self.gcode</code> object has a few useful functions:</p> <ul> <li><code>register_command</code> (used in the initializer)</li> <li><code>register_mux_command</code> (explained later)</li> <li><code>respond_info</code> (used here)</li> <li><code>run_script_from_command</code> (runs the provided string as GCode. The provided string can be multiple lines long)</li> </ul> <p>Finally, the <code>cmd_GREET</code> function:</p> cmd_GREET<pre><code>    cmd_GREET_help = \"Greet the user\"\n    def cmd_GREET(self, gcmd):\n        self._greet()\n</code></pre> <p>Here, you can see the <code>cmd_GREET_help</code> is set to a string. Next, the <code>cmd_GREET</code> function takes in a <code>gcmd</code> parameter (unused). Finally, the <code>cmd_GREET</code> function calls <code>_greet()</code>.</p> The <code>gcmd</code> parameter <p>The <code>gcmd</code> parameter allows functions to receive parameters. For example, if <code>GREET REPEAT=3</code> was called, the <code>REPEAT</code> parameter could be read as follows:</p> <pre><code>repeat = gcmd.get_int('REPEAT', 1)\n</code></pre> <p>There are a few <code>get_</code> functions that can be used with the <code>gcmd</code> parameter:</p> <ul> <li><code>get</code> returns a <code>str</code></li> <li><code>getint</code> returns an <code>int</code></li> <li><code>getfloat</code> returns a <code>float</code></li> </ul> <p><code>gcmd</code> also has a <code>respond_info</code> function, similar to the <code>self.gcode.respond_info</code> function.</p> <p>The <code>repeat</code> variable can then be used:</p> <pre><code>for _ in range(repeat):\n    self._greet()\n</code></pre>"},{"location":"extras/extras-ex1/#install","title":"Install","text":"<p>To install a Klippy extra, it has to be placed in the <code>~/klipper/klippy/extras/</code> folder. Here's a simple command to install <code>greeter.py</code>:</p> <pre><code>cp greeter.py ~/klipper/klippy/extras/greeter.py\n</code></pre> <p>You can also create an install script that uses the <code>ln</code> command to create a link to the file, rather than a copy:</p> install.sh<pre><code>ln -f greeter.py ~/klippy/klippy/extras/greeter.py\n</code></pre>"},{"location":"extras/extras-ex1/#other-things","title":"Other Things","text":"<p>A few things that are good to know before moving on:</p> <ul> <li>If your Klippy extra uses <code>load_config_prefix</code>, instead of <code>load_config</code>, you can get the name of the configuration section (e.g. <code>[greeter first]</code> is named <code>first</code>) by using:      <pre><code>config.get_name().split()[1]\n</code></pre></li> <li>If you want to learn more about additional capabilities of Klippy extras, check out the built-in Klippy extras.</li> <li>For further explanation of topics on this page, open the dropdowns.</li> </ul> <p>Next example:</p> <p>Example 2: BetterGreeter </p>"},{"location":"extras/extras-ex2/","title":"Example 2: BetterGreeter","text":"<p>For this tutorial, we are going to improve on the greeter code used in Structure. </p> <p>For reference, the entire original greeter code is below:</p> Original Greeter <pre><code>class Greeter:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n\n        self.gcode.register_command(\n            'GREET', self.cmd_GREET, desc=self.cmd_GREET_help)\n        self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + 1\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREET_help = \"Greet the user\"\n    def cmd_GREET(self, gcmd):\n        self._greet()\n\ndef load_config(config):\n    return Greeter(config)\n</code></pre>"},{"location":"extras/extras-ex2/#goals","title":"Goals","text":"<p>For the <code>BetterGreeter</code>, we want the following features:</p> <ul> <li>Ability to have multiple different greetings</li> <li>Allow the user to choose if they want their greeting to display after Klipper starts, and if so, to set the delay</li> <li>Allow the user to set the message of the greeting</li> </ul> <p>Here's an example configuration:</p> better_greeter.cfg<pre><code>[greeting welcome]\nmessage: Welcome to Klipper!\ndelay: 1\n\n[greeting gcode]\nmessage: Upload some GCode!\ndelay: 2\n\n[greeting print_done]\nmessage: Print completed!\n</code></pre> <p>Here's the desired behavior (anything on the line of a <code>&gt;</code> is a user-typed command):</p> <pre><code>&gt; RESTART\nWelcome to Klipper! # (1)!\nUpload some GCode! # (2)!\n&gt; GREETING NAME=print_done\nPrint completed!\n</code></pre> <ol> <li>One second after <code>RESTART</code></li> <li>Two seconds after <code>RESTART</code></li> </ol>"},{"location":"extras/extras-ex2/#creating-the-base-class","title":"Creating the Base Class","text":"<p>The first step of creating a Klippy extra is to make the base class and the config function: </p> <pre><code>class Greeting:\n    def __init__(self, config):\n        pass\n\n# (1)!\ndef load_config_prefix(config):\n    return Greeting(config)\n</code></pre> <ol> <li><code>load_config_prefix</code> is used here instead of <code>load_config</code> because there will be multiple <code>greeter</code> configuration sections.</li> </ol>"},{"location":"extras/extras-ex2/#reading-the-configuration","title":"Reading the Configuration","text":"<p>The next step of our Klippy extra is to setup the class variables and read the parameters:</p> <pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n</code></pre> <p>Quiz</p> QuestionAnswer <p>If there was a configuration option (int) named <code>repeats</code>, how would you get it in the initializer?</p> <p><code>config.getint('repeats')</code></p> <p>Here, the <code>printer</code>, <code>reactor</code>, <code>gcode</code>, and <code>message</code> variables are the same as in the previous Klippy extra. However, in this case, there are a couple new variables:</p> <ul> <li><code>name</code> is explained in the last section of Structure.</li> <li><code>delay</code> is read as an <code>int</code> from the <code>config</code> object, with default value <code>0</code>. The default value of <code>0</code> indicates it will not be run when Klippy starts.</li> </ul>"},{"location":"extras/extras-ex2/#gcode-commands-and-event-handler","title":"GCode Commands and Event Handler","text":"<p>After reading the configuration variables, we need to setup the GCode commands and event handler:</p> <pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n\n        #(1)!\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n</code></pre> <ol> <li><code>register_mux_command</code> is used here because there are multiple <code>greeting</code> configuration sections, and each should be called separately.</li> </ol> <p>Here, a few parts are similar to the example in Structure, but not identical. Let's start with the GCode command.</p> <p>In the Structure example, the GCode command was registered with:</p> <p><code>self.gcode.register_command('GREET', self.cmd_GREET, desc=self.cmd_GREET_help)</code></p> <p>In this new example, the GCode command is registered with:</p> <pre><code>self.gcode.register_mux_command(\n    'GREETING',\n    'NAME',\n    self.name,\n    self.cmd_GREETING,\n    desc=self.cmd_GREETING_help\n)\n</code></pre> <p>The difference here is that there can be multiple <code>greeting</code> configuration sections, and as a result, multiple <code>Greeting</code> objects. To call each one separately, <code>register_mux_command</code> is used, passing the following parameters:</p> <ul> <li>Macro name: <code>\"GREETING\"</code></li> <li>Parameter name: <code>\"NAME\"</code></li> <li>Parameter value: <code>self.name</code></li> <li>Function: <code>self.cmd_GREETING</code></li> <li>Description <code>self.cmd_GREETING_help</code></li> </ul> <p>Next, the <code>register_event_handler</code> is nearly identical to the Structure example, except in this case, it is run only <code>if self.delay &gt; 0</code>.</p>"},{"location":"extras/extras-ex2/#functions","title":"Functions","text":"<p>The next part to creating this Klippy extra is the functions.</p> <p>There are three functions in the <code>Greeting</code> class:</p> <ul> <li><code>ready_handler</code></li> <li><code>_greet</code></li> <li><code>cmd_GREETING</code></li> </ul> Flowchart <pre><code>graph TD\nA[klippy:ready] --&gt; B[_ready_handler]\n    B --&gt; C[Wait self.delay seconds]\n    C --&gt; D[_greet]\n    D --&gt; E[Display self.message]\n    F[cmd_GREETING] --&gt; E</code></pre> <p>The first function, <code>_ready_handler</code>:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n</code></pre> <p>This function takes no parameters, and runs when Klippy reports <code>\"klippy:ready\"</code>.</p> <p>Inside, the <code>waketime</code> variable is declared as <code>self.reactor.monotonic() + self.delay</code>. Let's break this declaration down:</p> <ul> <li><code>self.reactor.monotonic()</code> This is the current Klippy time</li> <li><code>+ self.delay</code> This adds <code>self.delay</code> to the current time.</li> </ul> <p>The result is that <code>waketime</code> contains the Klippy time for <code>self.delay</code> seconds in the future. Finally, we use <code>self.reactor.register_timer</code> to register this time, telling it to run <code>self._greet()</code> when the time occurs.</p> <p>The next function, <code>_greet</code>:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n</code></pre> <p>This function takes an optional <code>eventtime</code> parameter (unused) (1), and prints out <code>self.message</code> to the Klipper console, using <code>self.gcode.respond_info</code>.</p> <ol> <li>This is passed by Klippy when it calls <code>_greet()</code> after the timer occurs.</li> </ol> <p>Tip</p> <p>If you want the timer function to repeat, you can return the provided <code>eventtime</code> plus any number of seconds in the future, and it will repeat.</p> <p>The final function in this class is the <code>cmd_GREETING</code> function:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREETING_help = \"Greet the user\"\n    def cmd_GREETING(self, gcmd):\n        self._greet()\n</code></pre> <p>This function simply calls <code>self._greet()</code>, which displays <code>self.message</code> to the Klipper terminal.</p>"},{"location":"extras/extras-ex2/#full-code","title":"Full Code","text":"<p>The full code of this Klippy extra is:</p> greeting.py<pre><code>class Greeting:\n    def __init__(self, config):\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.message = config.get('message', 'Welcome to Klipper!')\n        self.delay = config.getint('delay', 0)\n\n        self.gcode.register_mux_command(\n            'GREETING',\n            'NAME',\n            self.name,\n            self.cmd_GREETING,\n            desc=self.cmd_GREETING_help\n        )\n\n        if self.delay &gt; 0:\n            self.printer.register_event_handler(\n            'klippy:ready', self._ready_handler)\n\n    def _ready_handler(self):\n        waketime = self.reactor.monotonic() + self.delay\n        self.reactor.register_timer(self._greet, waketime)\n\n    def _greet(self, eventtime=None):\n        self.gcode.respond_info(self.message)\n        return self.reactor.NEVER\n\n    cmd_GREETING_help = \"Greet the user\"\n    def cmd_GREETING(self, gcmd):\n        self._greet()\n\ndef load_config_prefix(config):\n    return Greeting(config)\n</code></pre> <p>You can install it following these instructions, replacing <code>greeter.py</code> with <code>greeting.py</code>.</p> <p>Last example (so far):</p> <p>Example 3: KlipperMaintenance </p>"},{"location":"extras/extras-ex3/","title":"Example 3: KlipperMaintenance","text":"<p>This last example of the Klippy extra development tutorial is actually one of my other Klipper projects: KlipperMaintenance, a maintenance reminder system for Klipper.</p> <p>This example will go through how the KlipperMaintenance code works to teach a few more important things about developing Klippy extras.</p>"},{"location":"extras/extras-ex3/#full-code","title":"Full Code","text":"<p>For this tutorial, we'll start with the full code, then break it down and explain what each section does. If you can learn to read existing Klippy extras, you can read the builtin Klippy extras when developing your own extras.</p> Full Code <pre><code>import json\nimport os\nimport time\nimport urllib.request as requests\n\nAPI_URL = 'http://localhost:7125/server/history/totals'\nHOME_DIR = os.path.expanduser('~')\n\nclass Maintenance:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.reactor = self.printer.get_reactor()\n        self.gcode = self.printer.lookup_object('gcode')\n\n        self.interval = config.getint('interval', 60)\n\n        self.timer_handler = None\n        self.inside_timer = self.repeat = False\n        self.printer.register_event_handler(\"klippy:ready\", self._handle_ready)\n\n        self.gcode.register_command('MAINTAIN_STATUS', self.cmd_MAINTAIN_STATUS, desc=self.cmd_MAINTAIN_STATUS_help)\n\n    def _handle_ready(self):\n        waketime = self.reactor.monotonic() + self.interval\n        self.timer_handler = self.reactor.register_timer(\n            self._gcode_timer_event, waketime)\n\n    def _gcode_timer_event(self, eventtime):\n        self.inside_timer = True\n        self.check_maintenance()\n        nextwake = eventtime + self.interval\n        self.inside_timer = self.repeat = False\n        return nextwake\n\n    def check_maintenance(self):\n        objs = self.printer.lookup_objects('maintain')\n        for obj in objs:\n            obj = obj[1]\n            if not isinstance(obj, Maintain):\n                continue\n            if obj.get_remaining() &lt; 0:\n                self.gcode.respond_info(f'Maintenance \"{obj.label}\" Expired!\\n{obj.message}')\n                self.gcode.run_script_from_command('M117 Maintenance Expired!')\n\n    cmd_MAINTAIN_STATUS_help = 'Check status of maintenance'\n    def cmd_MAINTAIN_STATUS(self, gcmd):\n        objs = self.printer.lookup_objects('maintain')\n        for obj in objs:\n            obj = obj[1]\n            if not isinstance(obj, Maintain):\n                continue\n            remain = obj.get_remaining()\n            if remain &lt; 0:\n                self.gcode.respond_info(f'Maintenance \"{obj.label}\" Expired!\\n{obj.message}')\n            self.gcode.respond_info(f'{obj.label}: {obj.get_remaining()}{obj.units} remaining')\n\nclass Maintain:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1]\n\n        self.label = config.get('label')\n\n        self.trigger = config.getchoice('trigger', ['print_time', 'filament', 'time'])\n        if self.trigger == 'print_time':\n            self.units = 'h'\n        elif self.trigger == 'filament':\n            self.units = 'm'\n        elif self.trigger == 'time':\n            self.units = 'h'\n\n        self.threshold = config.getint('threshold')\n        self.message = config.get('message')\n\n        self.init_db()\n\n        # register GCode commands\n        self.gcode.register_mux_command('CHECK_MAINTENANCE', 'NAME', self.name, self.cmd_CHECK_MAINTENANCE, desc=self.cmd_CHECK_MAINTENANCE_help)\n        self.gcode.register_mux_command('UPDATE_MAINTENANCE', 'NAME', self.name, self.cmd_UPDATE_MAINTENANCE, desc=self.cmd_UPDATE_MAINTENANCE_help)\n\n    def fetch_history(self):\n        resp = requests.urlopen(API_URL) # fetch data from Moonraker History API\n        try:\n            json_data = json.loads(resp.read())\n        except Exception:\n            self.gcode.respond_info(f'Data {resp.read()}')\n            return {\n                'print_time': 0,\n                'filament': 0,\n                'time': time.time()/3600\n            }\n\n        job_totals = json_data['result']['job_totals'] # get job totals from JSON response\n        return {\n            'print_time': job_totals['total_time']/3600,\n            'filament': job_totals['total_filament_used']/1000,\n            'time': time.time()/3600\n        }\n\n    def init_db(self):\n        data = self.fetch_db()\n        if data is None:\n            data = self.fetch_history()\n            self.update_db(data)\n\n    def fetch_db(self):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}')\n        if os.path.exists(path):\n            with open(path, 'r') as file:\n                try:\n                    data = json.load(file)\n                except:\n                    data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n                return data\n\n    def update_db(self, new):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}')\n        os.makedirs(os.path.dirname(path), exist_ok=True)\n        with open(path, 'w+') as file:\n            try:\n                data = json.load(file)\n            except:\n                data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n            data.update(new)\n            json.dump(data, file)\n        return data\n\n    def get_remaining(self):\n        last = self.fetch_db()[self.trigger]\n        now = self.fetch_history()[self.trigger]\n        return round(self.threshold - (now - last), 2)\n\n    cmd_CHECK_MAINTENANCE_help = 'Check maintenance'\n    def cmd_CHECK_MAINTENANCE(self, gcmd):\n        gcmd.respond_info(f'''\nMaintenance {self.label} Status:\nNext maintenance in {self.get_remaining()}{self.units}\nMaintenance message: {self.message}\n        '''.strip())\n\n    cmd_UPDATE_MAINTENANCE_help = 'Update maintenance'\n    def cmd_UPDATE_MAINTENANCE(self, gcmd):\n        self.update_db(self.fetch_history())\n\ndef load_config(config):\n    return Maintenance(config)\n\ndef load_config_prefix(config):\n    return Maintain(config)\n</code></pre>"},{"location":"extras/extras-ex3/#structure","title":"Structure","text":"<p>The class structure of this Klippy extra is shown in this flowchart:</p> <pre><code>classDiagram\n    class Maintain{\n        str name\n        str label\n        str trigger\n        int threshold\n        str message\n        fetch_history()\n        init_db()\n        fetch_db()\n        update_db(new)\n        get_remaining()\n        cmd_CHECK_MAINTENANCE(gcmd)\n        cmd_UPDATE_MAINTENANCE(gcmd)\n    }\n    note for Maintain \"trigger must be one of:\\n - print_time\\n - filament\\n - time\"\n\n    class Maintenance{\n        int interval\n        _handle_ready()\n        _gcode_timer_event()\n        check_maintenance()\n        cmd_MAINTAIN_STATUS(gcmd)\n    }\n\n    Maintenance &lt;|-- Maintain: Has-a</code></pre> <p>This diagram has a lot of information, but the key points are:</p> <ul> <li>Multiple <code>Maintain</code> objects are managed by one <code>Maintainence</code> object.</li> <li>The <code>Maintain</code> class handles maintenance reminders, the <code>CHECK_MAINTENANCE</code> command, and the <code>UPDATE_MAINTENANCE</code> command.</li> <li>The <code>Maintenance</code> class handles the <code>MAINTAIN_STATUS</code> command.</li> <li>A <code>[maintain name]</code> section corresponds to the <code>Maintain</code> class (multiple).</li> <li>A <code>[maintain]</code> section corresponds to the <code>Maintenance</code> class (one).</li> </ul> <p>The base code for this is:</p> maintain.py<pre><code>import json\nimport os\nimport time\nimport urllib.request as requests\n\nAPI_URL = 'http://localhost:7125/server/history/totals'\nHOME_DIR = os.path.expanduser('~')\n\nclass Maintenance:\n    pass\n\nclass Maintain:\n    pass\n\n# (1)!\ndef load_config(config):\n    return Maintenance(config)\n\n# (2)!\ndef load_config_prefix(config):\n    return Maintain(config)\n</code></pre> <ol> <li>This function corresponds to a <code>[maintain]</code> config section.</li> <li>This function corresponds to a <code>[maintain name]</code> config section.</li> </ol> <p>The highlighted section in the code contains the classes, and the configuration loading, the parts relevant to this first section. The code above the highlighted section includes the relevant module imports and constant declarations (both explained later).</p> <p>Much of the content in this example will be embedded in the code (usually the highlighted section) as a plus sign, like this: (1)</p> <ol> <li>Click some more plus marks in the code to learn more about the code.</li> </ol>"},{"location":"extras/extras-ex3/#maintain-class","title":"<code>Maintain</code> class","text":"<p>This next section of the example will focus on the <code>Maintain</code> class.</p>"},{"location":"extras/extras-ex3/#initializer","title":"Initializer","text":"<p>When <code>load_config_prefix</code> creates a <code>Maintain</code> object, it starts in the initializer. </p> <p>Here's the full initializer, with explanations embedded inside with plus signs. Below is a more general breakdown of the initializer for clarity.</p> maintain.py<pre><code>class Maintain:\n    def __init__(self, config):\n        self.config = config\n        self.printer = config.get_printer()\n        self.gcode = self.printer.lookup_object('gcode')\n        self.name = config.get_name().split()[1] # (1)!\n\n        self.label = config.get('label')\n\n        # (2)!\n        self.trigger = config.getchoice('trigger', ['print_time', 'filament', 'time']) \n        if self.trigger == 'print_time': # (3)!\n            self.units = 'h'\n        elif self.trigger == 'filament':\n            self.units = 'm'\n        elif self.trigger == 'time':\n            self.units = 'h'\n\n        self.threshold = config.getint('threshold')\n        self.message = config.get('message')\n\n        # (4)!\n        self.init_db()\n\n        self.gcode.register_mux_command('CHECK_MAINTENANCE', 'NAME', self.name, self.cmd_CHECK_MAINTENANCE, desc=self.cmd_CHECK_MAINTENANCE_help)\n        self.gcode.register_mux_command('UPDATE_MAINTENANCE', 'NAME', self.name, self.cmd_UPDATE_MAINTENANCE, desc=self.cmd_UPDATE_MAINTENANCE_help)\n</code></pre> <ol> <li><code>config.get_name()</code> returns the full config name, like <code>\"maintain name\"</code>. The <code>.split()[1]</code> splits the name by spaces and gets the last \"word\".</li> <li><code>config.getchoice()</code> allows you to only accept values in a certain list.</li> <li>This part of the initializer chooses the units based on the <code>trigger</code> type:<ul> <li><code>\"print_time\"</code>: <code>\"h\"</code></li> <li><code>\"filament\"</code>: <code>\"m\"</code></li> <li><code>\"time\"</code>: <code>\"h\"</code></li> </ul> </li> <li>This is explained later, in functions.</li> </ol> <p>The major breakdown of this initializer is:</p> <ul> <li>First highlighted section: Load basic objects</li> <li>Second highlighted section: Read configuration options</li> <li>Third highlighted section: Register GCode commands</li> </ul> <p>The line <code>self.init_db()</code> will be explained later in functions.</p> <p>Quiz</p> QuestionAnswer <p>How would you add another trigger type (called <code>\"axes_distance\"</code> with units <code>\"m\"</code>)?</p> <pre><code>self.trigger = config.getchoice('trigger', [\n    'print_time',\n    'filament',\n    'time',\n    'axes_distance'])\nif self.trigger == 'print_time': # (3)!\n    self.units = 'h'\nelif self.trigger == 'filament':\n    self.units = 'm'\nelif self.trigger == 'time':\n    self.units = 'h'\nelif self.trigger == 'axes_distance':\n    self.units = 'm'\n</code></pre>"},{"location":"extras/extras-ex3/#functions","title":"Functions","text":"<p>The next part of the <code>Maintain</code> class is its functions. The functions in this class are, broken down into two sections:</p> <p>Database:</p> <ul> <li><code>fetch_history()</code></li> <li><code>init_db()</code></li> <li><code>fetch_db()</code></li> <li><code>update_db(new)</code></li> </ul> <p>GCode:</p> <ul> <li><code>get_remaining()</code></li> <li><code>cmd_CHECK_MAINTENANCE(gcmd)</code></li> <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li> </ul> <p>First, the database functions (again, plus signs throughout the code explain in more detail what each part does):</p> maintain.py<pre><code>class Maintain:\n    ...\n    def fetch_history(self):\n        resp = requests.urlopen(API_URL) # fetch data from Moonraker History API\n        try:\n            json_data = json.loads(resp.read()) \n        except Exception:\n            self.gcode.respond_info(f'Data {resp.read()}')\n            return {\n                'print_time': 0,\n                'filament': 0,\n                'time': time.time()/3600\n            } # (1)!\n\n        job_totals = json_data['result']['job_totals'] # get job totals from JSON response\n        return {\n            'print_time': job_totals['total_time']/3600,\n            'filament': job_totals['total_filament_used']/1000,\n            'time': time.time()/3600\n        } # (2)!\n\n    def init_db(self):\n        data = self.fetch_db() # Load the database\n        if data is None:\n            data = self.fetch_history()\n            self.update_db(data) # Update the database with history data\n\n    def fetch_db(self):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}') # (3)!\n        if os.path.exists(path):\n            with open(path, 'r') as file:\n                try:\n                    data = json.load(file) # JSON parse the file contents\n                except:\n                    data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n                return data # Return parsed data\n\n    def update_db(self, new):\n        path = os.path.join(HOME_DIR, f'maintain-db/{self.name}') # (3)!\n        os.makedirs(os.path.dirname(path), exist_ok=True) # (4)!\n        with open(path, 'w+') as file: # The \"w+\" file operator allows reading and writing\n            try:\n                data = json.load(file) # JSON parse the file contents\n            except:\n                data = {'print_time': 0, 'filament': 0, 'time': time.time()/3600}\n            data.update(new) # Update the file contents with the new data\n            json.dump(data, file) # JSON write the new data to the file\n        return data # Return the new updated data\n</code></pre> <ol> <li>In case of an error, empty placeholder data is returned.</li> <li>If history fetch was successful, return the data read from the Moonraker History API.</li> <li>The <code>path</code> is (if the username is <code>pi</code> and <code>self.name</code> is <code>\"lubricate\"</code>) <code>\"/home/pi/maintain-db/lubricate\"</code>. Even though it has no file extension, it stores JSON data.</li> <li>The first time running this, the <code>maintain-db</code> folder won't exist. <code>os.makedirs</code> creates the folder, and <code>exist_ok=True</code> doesn't throw an error if it already exists.</li> </ol> <p>The flow of information in this Klippy extra is:</p> <ul> <li><code>init_db()</code> is called when Klippy starts</li> <li><code>fetch_db()</code> is called to read the stored database</li> <li>If the data returned by <code>fetch_db()</code> is <code>None</code> (database is empty)<ul> <li><code>fetch_history()</code> is called to fetch the history stored by Moonraker</li> <li><code>update_db()</code> is called to update the database with the newly fetched data.</li> </ul> </li> </ul> <p>Calling <code>update_db()</code> will erase the current maintenance state (resetting the timer/filament counter).</p> <p>The next section of functions in the <code>Maintain</code> class are the GCode commands. There are three functions in this section:</p> <ul> <li><code>get_remaining()</code></li> <li><code>cmd_CHECK_MAINTENANCE(gcmd)</code></li> <li><code>cmd_UPDATE_MAINTENANCE(gcmd)</code></li> </ul>"},{"location":"extras/extras-start/","title":"Start Writing Klippy Extras","text":"<p>While DynamicMacros makes Klipper macros much more powerful, sometimes a Klippy extra is required for more functionality. In this tutorial, you will learn how to develop a Klippy extra and test it using DynamicMacros.</p> <p>Info</p> <p>To write a Klipper extra, you should be fluent in Python.</p> Klipper vs Klippy <p>To limit confusion, I'm going to explain this here. \"Klipper\" is the name of the firmware running on your 3D printer. \"Klippy\" is the name of the software running on your Klipper Host (usually a Raspberry Pi). Klipper is written in C code, and Klippy is mostly written in Python.</p> <p>Start writing your first Klippy extra:</p> <p>Start </p>"},{"location":"features/delayed/","title":"Delayed GCode","text":"<p>Dynamic Macros supports a feature similar to <code>delayed_gcode</code>.</p>"},{"location":"features/delayed/#configuration","title":"Configuration","text":"<p>To configure a DynamicMacro to be run repeatedly/after a delay, update your macro as follows:</p> BeforeAfter <pre><code>[gcode_macro test]\ngcode:\n    RESPOND MSG=\"test\"\n</code></pre> <pre><code>[gcode_macro test]\ninitial_duration: 2 # Wait two seconds after Klipper starts to run this, and two seconds between repeats (if enabled)\nrepeat: true # true means repeat, false means don't repeat\ngcode:\n    RESPOND MSG=\"test\"\n</code></pre>"},{"location":"features/delayed/#parameters","title":"Parameters","text":"<p><code>initial_duration</code> specifies the delay after Klipper starts that the macro will be run, and the duration between repeats, if <code>repeat</code> is true.</p> <p><code>repeat</code> specifies whether or not to repeat the macro.</p>"},{"location":"features/python/","title":"Python","text":"<p>Dynamic Macros's most powerful feature allows you to run Python code directly from within a macro.</p>"},{"location":"features/python/#running-python-from-within-a-macro","title":"Running Python from within a Macro","text":"<p>Disclaimer</p> <p>This functionality allows Dynamic Macros to gain significant control over your printer and Klipper host. I am not responsible for whatever happens if you download a malicious macro.</p> <p>There are three main reasons why this could be helpful:</p> <ol> <li>Allowing for deeper control of Klipper and the Klipper host</li> <li>A learning bridge for creating Klipper plugins/extras</li> <li>A tool to help develop Klipper plugins/extras without restarting Klipper</li> </ol> <p>To run Python from within a Dynamic Macro, use either the <code>python()</code> utility function, or the <code>python_file()</code> utility function. The <code>python()</code> function accepts python code as a multiline string, and the <code>python_file()</code> function accepts a filename (relative to your <code>printer.cfg</code> folder).</p> <p>Tip</p> <p>When using the <code>python()</code> utiltiy function, Jinja2 (which converts the macro to GCode) may throw errors during parsing. If you are getting errors, it is recommended to switch to <code>python_file()</code>.</p> <p>Here are a few examples:</p>"},{"location":"features/python/#python-math","title":"Python Math","text":"macros.cfg<pre><code>[gcode_macro MATH]\ngcode:\n    {% set value = python(\"\"\"\n    a = kwargs['a']\n    b = kwargs['b']\n    c = a + b\n    output(c)\n    \"\"\", a=1, b=2) %}\n    RESPOND MSG={value}\n</code></pre>"},{"location":"features/python/#python-file-running-gcode","title":"Python File Running GCode","text":"macros.cfg<pre><code>[gcode_macro PYFILE]\ngcode:\n    {% set value = python_file(\"test.py\") %}\n    RESPOND MSG={value}\n</code></pre> test.py<pre><code>print(\"Hello from Python!\")\ngcode(\"G28\\nG1 X100 Y100 Z100 F1200\")\noutput(\"GCode Executed\")\n</code></pre>"},{"location":"features/receivingvariables/","title":"Receiving Variable Updates","text":"<p>Unlike normal <code>gcode_macro</code>s, Dynamic Macros supports receiving variable updates within the same macro. For example, the following macro will show the same output in both <code>M117</code>s:</p> <pre><code>[gcode_macro STATIC_MOVE]\ngcode:\n  G28\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position before macro run\n  G90\n  G1 Z20\n  M117 After: {printer.toolhead.position.z}\n  # Above displays same position\n</code></pre> <p>However, this macro will show different outputs based on the current Z position of the toolhead:</p> <pre><code>[gcode_macro DYNAMIC_MOVE]\ngcode:\n  G28\n\n\n  M117 Before: {printer.toolhead.position.z}\n  # Above displays position after G28\n  G90\n  G1 Z20\n\n\n  M117 After: {printer.toolhead.position.z}\n  # Above displays position after G1\n</code></pre> <p>Notice the large whitespaces. Three newline characters (two blank lines) between code segments denotes a variable update. However, some variables won't be preserevd across the whitespace.</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = 10 %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs nothing\n</code></pre> <p>You can use the <code>update()</code> function to preserve certain variables across the whitespaces:</p> <pre><code>[gcode_macro VARIABLES]\ngcode:\n    {% set num = update(\"num\", 10) %}\n    M117 {num}\n\n\n    M117 {num}\n    # Above line outputs 10\n</code></pre> <p>See Examples for examples.</p>"},{"location":"features/recursion/","title":"Recursion","text":"<p>Unlike normal <code>gcode_macro</code>s, Dynamic Macros supports recursion (allowing a macro to call itself). For more examples, see Examples</p>"},{"location":"features/utilities/","title":"Utility Functions","text":"<p>Dynamic Macros provides a few utility functions to make Dynamic Macros easier to write.</p>"},{"location":"features/utilities/#update","title":"update()","text":"<p>The <code>update()</code> function allows to save variables across whitespaces (see Receiving Variables for more information). Example:</p> <pre><code>[gcode_macro MY_MACRO]\ngcode:\n    {% set a = 10 %}\n    {% set b = update(\"b\", 20) %}\n    RESPOND MSG=\"A: {a}\" # 10\n    RESPOND MSG=\"B: {b}\" # 20\n\n\n    RESPOND MSG=\"A: {a}\" # \"\"\n    RESPOND MSG=\"B: {b}\" # 20\n</code></pre>"},{"location":"features/utilities/#get_macro_variables","title":"get_macro_variables()","text":"<p>The <code>get_macro_variables()</code> function allows to retrieve all the variables from another macro in one line of code. Example:</p> <pre><code>[gcode_macro MY_SETTINGS]\nvariable_a: 10\nvariable_b: 20\ngcode:\n    RESPOND MSG=\"settings\"\n\n[gcode_macro GET_SETTINGS]\ngcode:\n    {% set settings = get_macro_variables(\"MY_SETTINGS\") %}\n    RESPOND MSG=\"Settings: {settings}\"\n    RESPOND MSG=\"A: {settings.a}\"\n</code></pre>"},{"location":"features/utilities/#update_from_dict","title":"update_from_dict()","text":"<p>The <code>update_from_dict()</code> function allows for saving the output of <code>get_macro_variables()</code> (or other dictionaries) across the whitespaces when Receiving Variables. Example:</p> <pre><code>[gcode_macro MY_SETTINGS]\nvariable_a: 10\nvariable_b: 20\ngcode:\n    RESPOND MSG=\"settings\"\n\n[gcode_macro GET_SETTINGS]\ngcode:\n    {% set settings = get_macro_variables(\"MY_SETTINGS\") %}\n    {% set settings = update_from_dict(settings) %}\n\n\n    RESPOND MSG=\"A: {a}\" # 10\n    RESPOND MSG=\"B: {b}\" # 20\n</code></pre>"},{"location":"features/variables/","title":"Variables","text":"<p>Dynamic Macro variables work nearly the same way as standard <code>gcode_macro</code> variables. This guide covers the differences.</p>"},{"location":"features/variables/#set_dynamic_variable","title":"SET_DYNAMIC_VARIABLE","text":"<p>Instead of using <code>SET_GCODE_VARIABLE</code>, Dynamic Macros use <code>SET_DYNAMIC_VARIABLE</code> to update Dynamic Macro variables. Example (assuming <code>VAR_TEST</code> is defined from Utilities):</p> <pre><code>SET_DYNAMIC_VARIABLE MACRO=var_test VARIABLE=a VALUE=15\n</code></pre>"},{"location":"tutorial/","title":"Table of Contents","text":"<p>Follow this tutorial to learn how to create Dynamic Macros and to use its powerful features.</p>"},{"location":"tutorial/#standard-macros","title":"Standard Macros","text":"<p>Before writing macros, it's a good idea to learn how to write standard <code>gcode_macro</code>s. Here is an amazing guide on how to write standard macros.</p>"},{"location":"tutorial/#table-of-contents_1","title":"Table of Contents","text":"<ol> <li>Converting to Dynamic Macros</li> <li>Using Dynamic Macros Features</li> <li>Experimental Features</li> </ol>"},{"location":"tutorial/converting/","title":"Converting to Dynamic Macros","text":"<p>Follow this tutorial to convert your standard <code>gcode_macro</code> to a Dynamic Macro. </p>"},{"location":"tutorial/converting/#printercfg","title":"printer.cfg","text":"<p>First, remove the <code>include</code> line in your <code>printer.cfg</code> referencing the file your macros are in. For example, if your macros are in <code>macros.cfg</code>, remove the line:</p> <pre><code>[include macros.cfg]\n</code></pre> <p>from your <code>printer.cfg</code>.</p>"},{"location":"tutorial/converting/#dynamic-macros-configuration","title":"Dynamic Macros Configuration","text":"<p>Next, if you don't already have one, create a <code>[dynamicmacros]</code> config section in your <code>printer.cfg</code> and add your macro configuration to it:</p> printer.cfg<pre><code>[dynamicmacros]\nconfig_path: ~/printer_data/config # If you left your printer configuration path as the default, you don't need to specify this\nconfigs: macros.cfg # You can add more files to this list, separated by commas.\n</code></pre> KlipperScreen <p>If you convert your <code>LOAD_FILAMENT</code> and <code>UNLOAD_FILAMENT</code> macros to be dynamic, KlipperScreen may not recognize them and report an error. To fix this, add blank macros to your <code>printer.cfg</code>, before your <code>[dynamicmacros]</code> section. Example: printer.cfg<pre><code>[gcode_macro LOAD_FILAMENT]\ngcode:\n    M117 LOAD\n[gcode_macro UNLOAD_FILAMENT]\ngcode:\n    M117 UNLOAD\n</code></pre></p> Unknown config object 'gcode_macro' <p>If you are getting a \"Unknown config object 'gcode_macro'\" error after converting your macros to Dynamic Macros, move your <code>[dynamicmacros]</code> section to be after your <code>[virtual_sdcard]</code> section.</p> Nacro Names <p>Klipper has certain macro names reserved for core functionality. If you are experiencing errors, don't name your Dynamic Macros any of the following:</p> <ul> <li><code>PAUSE</code></li> <li><code>RESUME</code></li> <li><code>CANCEL_PRINT</code></li> </ul> <p>If you want to make those macros dynamic, first define them as a standard GCode macro:</p> <pre><code>[gcode_macro PAUSE]\ngcode:\n    DYNAMIC_PAUSE\n</code></pre> <p>Restart Klipper.</p> <p>That's it. Your macros are now Dynamic Macros.</p>"},{"location":"tutorial/experimental/","title":"Experimental Features","text":"<p>Warning</p> <p>The features on this page are experimental, and untested or only lightly tested. Proceed at your own risk.</p>"},{"location":"tutorial/usingfeatures/","title":"Using Dynamic Macros Features","text":"<p>Now that your macros are dynamic, you can use the powerful feature set of Dynamic Macros.</p>"},{"location":"tutorial/usingfeatures/#recursion","title":"Recursion","text":"<p>Recursion allows a macro to call itself, something standard GCode macros can't do. </p> <p>When using recursion, it's important to make sure your macro has an \"end case\". This is a case when the macro won't call itself again. Otherwise the macro will be stuck in an infinite loop and freeze Klipper.</p> <p>Here are a few examples of recursion:</p> Counting to 10<pre><code>[gcode_macro COUNT]\ngcode:\n    {% set num = params.NUM|default(1)|int %}\n    {% if num &lt;= 10 %}\n        RESPOND MSG={num}\n        COUNT NUM={num+1} # Count up 1\n    {% else %}\n        RESPOND MSG=\"Done Counting\"\n    {% endif %}\n</code></pre> Load to Filament Sensor<pre><code>[gcode_macro LOAD_TO_FSENSOR]\ngcode:\n    {% set val = printer[\"filament_sensor fsensor\"].filament_detected %}\n    {% if val == 0 %}\n        M83\n        G1 E50 F900 # Move filament 50mm forwards\n        RESPOND MSG=\"Waiting for fsensor\"\n        LOAD_TO_FSENSOR # Recursion\n    {% else %}\n        G1 E65 F900 # Move filament to nozzle\n        RESPOND MSG=\"Filament Loaded\"\n    {% endif %}\n</code></pre>"},{"location":"tutorial/usingfeatures/#receiving-variable-updates","title":"Receiving Variable Updates","text":"<p>Receiving variable updates allows Dynamic Macros to update variables without rerunning the macro. </p> <p>An example of this is getting the printer's position. A standard GCode macro will evaluate all the variables, then run the GCode. However, using three newlines (two blank lines) between code segments in Dynamic Macros will allow each segment to be evaluated at runtime, allowing for variable updates.</p>"},{"location":"tutorial/usingfeatures/#utility-functions","title":"Utility Functions","text":"<p>See the link above (the subtitle) for more information on utility functions.</p>"},{"location":"tutorial/usingfeatures/#python","title":"Python","text":"<p>Dynamic Macro's most powerful feature allows you to run Python code from within a macro. See the link above (the subtitle) for more information.</p>"},{"location":"tutorial/usingfeatures/#delayed_gcode","title":"delayed_gcode","text":"<p>Dynamic Macros supports a feature similar to <code>delayed_gcode</code>. See the link above (the subtitle) for more information.</p>"}]}
\ No newline at end of file
diff --git a/setup/index.html b/setup/index.html
index 30c46ec..27aa413 100644
--- a/setup/index.html
+++ b/setup/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1188,6 +1188,46 @@ <h2 id="when-to-restart-klipper-or-reload-dynamic-macros">When to Restart Klippe
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href=".." class="md-footer__link md-footer__link--prev" aria-label="Previous: Home">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Home
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../tutorial/" class="md-footer__link md-footer__link--next" aria-label="Next: Table of Contents">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Table of Contents
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1198,6 +1238,21 @@ <h2 id="when-to-restart-klipper-or-reload-dynamic-macros">When to Restart Klippe
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1210,7 +1265,7 @@ <h2 id="when-to-restart-klipper-or-reload-dynamic-macros">When to Restart Klippe
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/tutorial/converting/index.html b/tutorial/converting/index.html
index 3a4c767..cdd41b3 100644
--- a/tutorial/converting/index.html
+++ b/tutorial/converting/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1036,6 +1036,46 @@ <h2 id="dynamic-macros-configuration">Dynamic Macros Configuration</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Table of Contents">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Table of Contents
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../usingfeatures/" class="md-footer__link md-footer__link--next" aria-label="Next: Using Dynamic Macros Features">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Using Dynamic Macros Features
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1046,6 +1086,21 @@ <h2 id="dynamic-macros-configuration">Dynamic Macros Configuration</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1058,7 +1113,7 @@ <h2 id="dynamic-macros-configuration">Dynamic Macros Configuration</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/tutorial/experimental/index.html b/tutorial/experimental/index.html
index af6ab73..7816616 100644
--- a/tutorial/experimental/index.html
+++ b/tutorial/experimental/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -914,6 +914,46 @@ <h1 id="experimental-features">Experimental Features</h1>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../usingfeatures/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Using Dynamic Macros Features">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Using Dynamic Macros Features
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../../features/recursion/" class="md-footer__link md-footer__link--next" aria-label="Next: Recursion">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Recursion
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -924,6 +964,21 @@ <h1 id="experimental-features">Experimental Features</h1>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -936,7 +991,7 @@ <h1 id="experimental-features">Experimental Features</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/tutorial/index.html b/tutorial/index.html
index 80f9238..c30fade 100644
--- a/tutorial/index.html
+++ b/tutorial/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -993,6 +993,46 @@ <h2 id="table-of-contents_1">Table of Contents</h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../setup/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Setup">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Setup
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="converting/" class="md-footer__link md-footer__link--next" aria-label="Next: Converting to Dynamic Macros">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Converting to Dynamic Macros
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1003,6 +1043,21 @@ <h2 id="table-of-contents_1">Table of Contents</h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1015,7 +1070,7 @@ <h2 id="table-of-contents_1">Table of Contents</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/tutorial/usingfeatures/index.html b/tutorial/usingfeatures/index.html
index d3a5ea6..5c0535b 100644
--- a/tutorial/usingfeatures/index.html
+++ b/tutorial/usingfeatures/index.html
@@ -91,7 +91,7 @@
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -148,7 +148,7 @@
     
     
     
-    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-orange" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="indigo"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
     
       <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
@@ -1094,6 +1094,46 @@ <h2 id="delayed_gcode"><a href="../../features/delayed/">delayed_gcode</a></h2>
       
         <footer class="md-footer">
   
+    
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../converting/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Converting to Dynamic Macros">
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Converting to Dynamic Macros
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../experimental/" class="md-footer__link md-footer__link--next" aria-label="Next: Experimental Features">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Experimental Features
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
+            </div>
+          </a>
+        
+      </nav>
+    
+  
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">
@@ -1104,6 +1144,21 @@ <h2 id="delayed_gcode"><a href="../../features/delayed/">delayed_gcode</a></h2>
       Material for MkDocs
     </a>
   
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://3dcoded.github.io" target="_blank" rel="noopener" title="3dcoded.github.io" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
+    </a>
+  
 </div>
       
     </div>
@@ -1116,7 +1171,7 @@ <h2 id="delayed_gcode"><a href="../../features/delayed/">delayed_gcode</a></h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "navigation.expand", "navigation.instant", "navigation.instant.prefetch", "navigation.footer", "content.code.copy", "content.code.annotate", "search.suggest", "search.highlight", "search.share"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
