diff --git a/404.html b/404.html
index 92a36451..8c2a2e95 100644
--- a/404.html
+++ b/404.html
@@ -406,6 +406,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -421,16 +425,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="/installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -440,6 +452,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -496,6 +510,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -509,16 +527,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="/installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -528,6 +554,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -619,6 +647,8 @@
     
       
         
+          
+        
       
     
     
@@ -635,16 +665,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="/library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -654,24 +687,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/buffer/index.html b/buffer/index.html
index 217cf785..6317b383 100644
--- a/buffer/index.html
+++ b/buffer/index.html
@@ -413,6 +413,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -428,16 +432,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -447,6 +459,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -503,6 +517,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -516,16 +534,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -535,6 +561,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -626,6 +654,8 @@
     
       
         
+          
+        
       
     
     
@@ -642,16 +672,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -661,24 +694,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/examples/index.html b/examples/index.html
index 5c8a5b04..55bf2e3f 100644
--- a/examples/index.html
+++ b/examples/index.html
@@ -417,6 +417,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -432,16 +436,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -451,6 +463,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -507,6 +521,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -520,16 +538,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -539,6 +565,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -640,6 +668,8 @@
     
       
         
+          
+        
       
     
     
@@ -656,16 +686,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -675,24 +708,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/getting-started/index.html b/getting-started/index.html
index b079bd73..1d34ca07 100644
--- a/getting-started/index.html
+++ b/getting-started/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/graph/config/index.html b/graph/config/index.html
index e87dd1c0..3978adce 100644
--- a/graph/config/index.html
+++ b/graph/config/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/graph/creating/index.html b/graph/creating/index.html
index 725e24f4..4355667e 100644
--- a/graph/creating/index.html
+++ b/graph/creating/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/graph/index.html b/graph/index.html
index bec86c75..ae41eba6 100644
--- a/graph/index.html
+++ b/graph/index.html
@@ -11,7 +11,7 @@
       
       
       
-        <link rel="prev" href="../license/">
+        <link rel="prev" href="../library/">
       
       
         <link rel="next" href="creating/">
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1424,7 +1439,7 @@ <h1 id="the-audiograph">The AudioGraph</h1>
       <nav class="md-footer__inner md-grid" aria-label="Footer" >
         
           
-          <a href="../license/" class="md-footer__link md-footer__link--prev" aria-label="Previous: License">
+          <a href="../library/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Reference library">
             <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>
@@ -1434,7 +1449,7 @@ <h1 id="the-audiograph">The AudioGraph</h1>
                 Previous
               </span>
               <div class="md-ellipsis">
-                License
+                Reference library
               </div>
             </div>
           </a>
diff --git a/graph/properties/index.html b/graph/properties/index.html
index f5f53147..c6ebc42e 100644
--- a/graph/properties/index.html
+++ b/graph/properties/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/graph/recording/index.html b/graph/recording/index.html
index 40ddc62c..0689fee9 100644
--- a/graph/recording/index.html
+++ b/graph/recording/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/graph/stopping/index.html b/graph/stopping/index.html
index c3b1a297..ed05221a 100644
--- a/graph/stopping/index.html
+++ b/graph/stopping/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/howto/index.html b/howto/index.html
index 62cbe74a..ae700061 100644
--- a/howto/index.html
+++ b/howto/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/howto/midi/index.html b/howto/midi/index.html
index 164d745d..85bffa36 100644
--- a/howto/midi/index.html
+++ b/howto/midi/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/index.html b/index.html
index f1f55bb3..e4ebc6cc 100644
--- a/index.html
+++ b/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/installation/command-line-generic/index.html b/installation/command-line-generic/index.html
index dd4b488b..26bc8600 100644
--- a/installation/command-line-generic/index.html
+++ b/installation/command-line-generic/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/installation/index.html b/installation/index.html
index c5d78366..e88a8cc6 100644
--- a/installation/index.html
+++ b/installation/index.html
@@ -14,7 +14,7 @@
         <link rel="prev" href="./">
       
       
-        <link rel="next" href="macos/easy/">
+        <link rel="next" href="macos/">
       
       
       <link rel="icon" href="../assets/images/favicon.png">
@@ -419,6 +419,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -434,16 +438,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -453,6 +465,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -509,6 +523,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -522,16 +540,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -541,6 +567,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -632,6 +660,8 @@
     
       
         
+          
+        
       
     
     
@@ -648,16 +678,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -667,24 +700,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1445,13 +1460,19 @@ <h2 id="requirements">Requirements</h2>
 <h2 id="installation">Installation</h2>
 <hr />
 <h3 id="macos">macOS</h3>
+<!-- BEGIN INCLUDE installation/macos/buttons.md -->
+<p>If you're new to Python or getting started from scratch:</p>
+<p><a class="md-button" href="macos/easy/">macOS: Easy install with Visual Studio Code</a> </p>
 <p>If you are an existing Python user and confident with the command line:</p>
 <p><a class="md-button" href="macos/command-line/">macOS: Install from the command line</a></p>
-<p>If you're new to Python or getting started from scratch: </p>
-<p><a class="md-button" href="macos/easy/">macOS: Easy install with Visual Studio Code</a> </p>
+<!-- END INCLUDE -->
+
 <hr />
 <h3 id="linux">Linux</h3>
+<!-- BEGIN INCLUDE installation/linux/buttons.md -->
 <p><a class="md-button" href="linux/command-line/">Linux: Install from the command line</a></p>
+<!-- END INCLUDE -->
+
 <hr />
 <h2 id="examples">Examples</h2>
 <p><a href="https://github.com/ideoforms/signalflow/tree/master/examples">Several example scripts</a> are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>
@@ -1499,13 +1520,13 @@ <h2 id="examples">Examples</h2>
         
         
           
-          <a href="macos/easy/" class="md-footer__link md-footer__link--next" aria-label="Next: Easy install">
+          <a href="macos/" class="md-footer__link md-footer__link--next" aria-label="Next: Installing on macOS">
             <div class="md-footer__title">
               <span class="md-footer__direction">
                 Next
               </span>
               <div class="md-ellipsis">
-                Easy install
+                Installing on macOS
               </div>
             </div>
             <div class="md-footer__button md-icon">
diff --git a/installation/linux/buttons/index.html b/installation/linux/buttons/index.html
new file mode 100644
index 00000000..390b4d4a
--- /dev/null
+++ b/installation/linux/buttons/index.html
@@ -0,0 +1,1475 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="SignalFlow is a sound synthesis framework designed for exploring complex sonic ideas.">
+      
+      
+      
+      
+      
+      
+      <link rel="icon" href="../../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.8">
+    
+    
+      
+        <title>Buttons - SignalFlow</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.4b4a2bd9.min.css">
+      
+        
+        <link rel="stylesheet" href="../../../assets/stylesheets/palette.356b1318.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=IBM+Plex+Sans:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"IBM Plex Sans";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo">
+  
+    
+    
+      <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../../.." title="SignalFlow" class="md-header__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            SignalFlow
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Buttons
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo"  aria-hidden="true"  type="radio" name="__palette" id="__palette_1">
+    
+  
+</form>
+      
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <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>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../../.." title="SignalFlow" class="md-nav__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    SignalFlow
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../.." class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Home
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_1">
+            <span class="md-nav__icon md-icon"></span>
+            Home
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Getting started
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+            Getting started
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installation
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installation
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../macos/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installing on macOS
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on macOS
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../macos/easy/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Easy install
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../macos/command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installing on Linux
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2_3">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on Linux
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Examples
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../license/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    License
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../library/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Reference library
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Reference library
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../graph/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    The AudioGraph
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            The AudioGraph
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/creating/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Creating the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Configuration
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/recording/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Recording the audio output
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/stopping/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stopping the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../node/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Nodes
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            Nodes
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/multichannel/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Multichannel
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/stochastic/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stochastic nodes
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/developing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Developing a new Node class
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../patch/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Patches
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            Patches
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/defining/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Defining a Patch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/exporting/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Exporting and importing patches
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/auto-free/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Auto-free and memory management
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../buffer/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Buffers
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_7">
+            <span class="md-nav__icon md-icon"></span>
+            Buffers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+  <h1>Buttons</h1>
+
+<p><a class="md-button" href="../command-line/">Linux: Install from the command line</a></p>
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+        </div>
+        
+          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
+  Back to top
+</button>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+    
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://github.com/ideoforms" target="_blank" rel="noopener" title="github.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.4.2 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 2023 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>
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://twitter.com/ideoforms" target="_blank" rel="noopener" title="twitter.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.copy", "navigation.sections", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer"], "search": "../../../assets/javascripts/workers/search.f886a092.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.81fa17fe.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/installation/linux/command-line/index.html b/installation/linux/command-line/index.html
index 0c1b88b6..56401a49 100644
--- a/installation/linux/command-line/index.html
+++ b/installation/linux/command-line/index.html
@@ -11,7 +11,7 @@
       
       
       
-        <link rel="prev" href="../../macos/command-line/">
+        <link rel="prev" href="../">
       
       
         <link rel="next" href="../../../examples/">
@@ -419,6 +419,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -434,16 +438,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -453,6 +465,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -511,6 +525,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -524,16 +542,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -543,6 +569,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -716,6 +744,8 @@
     
       
         
+          
+        
       
     
     
@@ -732,16 +762,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -751,24 +784,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1609,7 +1624,7 @@ <h2 id="next-steps">Next steps</h2>
       <nav class="md-footer__inner md-grid" aria-label="Footer" >
         
           
-          <a href="../../macos/command-line/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Command-line installation">
+          <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Installing on Linux">
             <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>
@@ -1619,7 +1634,7 @@ <h2 id="next-steps">Next steps</h2>
                 Previous
               </span>
               <div class="md-ellipsis">
-                Command-line installation
+                Installing on Linux
               </div>
             </div>
           </a>
diff --git a/installation/linux/index.html b/installation/linux/index.html
index 57b140ba..d17f7db8 100644
--- a/installation/linux/index.html
+++ b/installation/linux/index.html
@@ -11,6 +11,10 @@
       
       
       
+        <link rel="prev" href="../macos/command-line/">
+      
+      
+        <link rel="next" href="command-line/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
@@ -18,7 +22,7 @@
     
     
       
-        <title>Getting started - SignalFlow</title>
+        <title>Installing on Linux - SignalFlow</title>
       
     
     
@@ -73,7 +77,7 @@
     <div data-md-component="skip">
       
         
-        <a href="#getting-started" class="md-skip">
+        <a href="#installation-on-linux" class="md-skip">
           Skip to content
         </a>
       
@@ -109,7 +113,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
             
-              Getting started
+              Installing on Linux
             
           </span>
         </div>
@@ -289,6 +293,8 @@
       
   
   
+    
+  
   
     
     
@@ -310,12 +316,12 @@
       
       
     
-    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
       
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
         
           
           
@@ -337,7 +343,7 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2">
             <span class="md-nav__icon md-icon"></span>
             Getting started
@@ -350,6 +356,8 @@
                 
   
   
+    
+  
   
     
     
@@ -366,12 +374,12 @@
     
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" checked>
         
           
           
@@ -393,7 +401,7 @@
             
           </div>
         
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2_2">
             <span class="md-nav__icon md-icon"></span>
             Installation
@@ -411,6 +419,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +438,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +465,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -496,36 +518,50 @@
                 
   
   
+    
+  
   
     
     
       
         
+          
+        
+      
+        
       
     
     
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
       
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2_2_3">
             <span class="md-nav__icon md-icon"></span>
             Installing on Linux
@@ -533,6 +569,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +662,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +680,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +702,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1366,35 +1391,6 @@
     
   
   
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    Requirements
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#installation" class="md-nav__link">
-    Installation
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    Examples
-  </a>
-  
-</li>
-      
-    </ul>
-  
 </nav>
                   </div>
                 </div>
@@ -1411,20 +1407,10 @@
   
 
 
-<h1 id="getting-started">Getting started</h1>
-<h2 id="requirements">Requirements</h2>
-<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p>
-<p>Python 3.8 or above is required. On macOS, we recommend installing an up-to-date version of Python3 <a href="https://docs.python-guide.org/starting/install3/osx/">using Homebrew</a>: <code>brew install python3</code>.</p>
-<h2 id="installation">Installation</h2>
-<p>On macOS and Linux x86_64, SignalFlow can be installed using <code>pip</code>:</p>
-<div class="highlight"><pre><span></span><code>pip3 install signalflow 
-</code></pre></div>
-<p>Verify that the installation has worked correctly by using the <code>signalflow</code> command-line tool to play a test tone through your default system audio output:</p>
-<div class="highlight"><pre><span></span><code>signalflow test
-</code></pre></div>
-<p>For more detailed installation information, including Windows install and compilation from source, see the <a href="https://github.com/ideoforms/signalflow">README</a>.</p>
-<h2 id="examples">Examples</h2>
-<p><a href="https://github.com/ideoforms/signalflow/tree/master/examples">Several example scripts</a> are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>
+<h1 id="installation-on-linux">Installation on Linux</h1>
+<!-- BEGIN INCLUDE installation/linux/buttons.md -->
+<p><a class="md-button" href="command-line/">Linux: Install from the command line</a></p>
+<!-- END INCLUDE -->
 
 
 
@@ -1448,6 +1434,44 @@ <h2 id="examples">Examples</h2>
         <footer class="md-footer">
   
     
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../macos/command-line/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Command-line installation">
+            <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">
+                Command-line installation
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="command-line/" class="md-footer__link md-footer__link--next" aria-label="Next: Command-line installation">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Command-line installation
+              </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">
diff --git a/installation/macos/buttons/index.html b/installation/macos/buttons/index.html
new file mode 100644
index 00000000..1cb67db2
--- /dev/null
+++ b/installation/macos/buttons/index.html
@@ -0,0 +1,1478 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="SignalFlow is a sound synthesis framework designed for exploring complex sonic ideas.">
+      
+      
+      
+      
+      
+      
+      <link rel="icon" href="../../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.8">
+    
+    
+      
+        <title>Buttons - SignalFlow</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../../assets/stylesheets/main.4b4a2bd9.min.css">
+      
+        
+        <link rel="stylesheet" href="../../../assets/stylesheets/palette.356b1318.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=IBM+Plex+Sans:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"IBM Plex Sans";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo">
+  
+    
+    
+      <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../../.." title="SignalFlow" class="md-header__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            SignalFlow
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Buttons
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo"  aria-hidden="true"  type="radio" name="__palette" id="__palette_1">
+    
+  
+</form>
+      
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <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>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../../.." title="SignalFlow" class="md-nav__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    SignalFlow
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../.." class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Home
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_1">
+            <span class="md-nav__icon md-icon"></span>
+            Home
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Getting started
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+            Getting started
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installation
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installation
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installing on macOS
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on macOS
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../easy/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Easy install
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../linux/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installing on Linux
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2_3">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on Linux
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../linux/command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../examples/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Examples
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../license/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    License
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../library/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Reference library
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Reference library
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../graph/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    The AudioGraph
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            The AudioGraph
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/creating/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Creating the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Configuration
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/recording/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Recording the audio output
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../graph/stopping/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stopping the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../node/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Nodes
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            Nodes
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/multichannel/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Multichannel
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/stochastic/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stochastic nodes
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../node/developing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Developing a new Node class
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../patch/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Patches
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            Patches
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/defining/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Defining a Patch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/exporting/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Exporting and importing patches
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../patch/auto-free/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Auto-free and memory management
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../buffer/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Buffers
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_7">
+            <span class="md-nav__icon md-icon"></span>
+            Buffers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+  <h1>Buttons</h1>
+
+<p>If you're new to Python or getting started from scratch:</p>
+<p><a class="md-button" href="../easy/">macOS: Easy install with Visual Studio Code</a> </p>
+<p>If you are an existing Python user and confident with the command line:</p>
+<p><a class="md-button" href="../command-line/">macOS: Install from the command line</a></p>
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+        </div>
+        
+          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
+  Back to top
+</button>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+    
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://github.com/ideoforms" target="_blank" rel="noopener" title="github.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.4.2 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 2023 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>
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://twitter.com/ideoforms" target="_blank" rel="noopener" title="twitter.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.copy", "navigation.sections", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer"], "search": "../../../assets/javascripts/workers/search.f886a092.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.81fa17fe.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/installation/macos/command-line/index.html b/installation/macos/command-line/index.html
index cbab976d..9a4e2047 100644
--- a/installation/macos/command-line/index.html
+++ b/installation/macos/command-line/index.html
@@ -14,7 +14,7 @@
         <link rel="prev" href="../easy/">
       
       
-        <link rel="next" href="../../linux/command-line/">
+        <link rel="next" href="../../linux/">
       
       
       <link rel="icon" href="../../../assets/images/favicon.png">
@@ -421,6 +421,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -436,16 +440,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" checked>
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -455,6 +467,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -593,6 +607,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -606,16 +624,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -625,6 +651,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -716,6 +744,8 @@
     
       
         
+          
+        
       
     
     
@@ -732,16 +762,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -751,24 +784,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1625,13 +1640,13 @@ <h2 id="next-steps">Next steps</h2>
         
         
           
-          <a href="../../linux/command-line/" class="md-footer__link md-footer__link--next" aria-label="Next: Command-line installation">
+          <a href="../../linux/" class="md-footer__link md-footer__link--next" aria-label="Next: Installing on Linux">
             <div class="md-footer__title">
               <span class="md-footer__direction">
                 Next
               </span>
               <div class="md-ellipsis">
-                Command-line installation
+                Installing on Linux
               </div>
             </div>
             <div class="md-footer__button md-icon">
diff --git a/installation/macos/easy/index.html b/installation/macos/easy/index.html
index e5642512..70a135d0 100644
--- a/installation/macos/easy/index.html
+++ b/installation/macos/easy/index.html
@@ -11,7 +11,7 @@
       
       
       
-        <link rel="prev" href="../../">
+        <link rel="prev" href="../">
       
       
         <link rel="next" href="../command-line/">
@@ -421,6 +421,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -436,16 +440,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" checked>
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -455,6 +467,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +642,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -641,16 +659,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -660,6 +686,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -751,6 +779,8 @@
     
       
         
+          
+        
       
     
     
@@ -767,16 +797,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -786,24 +819,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1736,7 +1751,7 @@ <h2 id="next-steps">Next steps</h2>
       <nav class="md-footer__inner md-grid" aria-label="Footer" >
         
           
-          <a href="../../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Installation">
+          <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Installing on macOS">
             <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>
@@ -1746,7 +1761,7 @@ <h2 id="next-steps">Next steps</h2>
                 Previous
               </span>
               <div class="md-ellipsis">
-                Installation
+                Installing on macOS
               </div>
             </div>
           </a>
diff --git a/installation/macos/index.html b/installation/macos/index.html
new file mode 100644
index 00000000..71712513
--- /dev/null
+++ b/installation/macos/index.html
@@ -0,0 +1,1534 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="SignalFlow is a sound synthesis framework designed for exploring complex sonic ideas.">
+      
+      
+      
+      
+        <link rel="prev" href="../">
+      
+      
+        <link rel="next" href="easy/">
+      
+      
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.8">
+    
+    
+      
+        <title>Installing on macOS - SignalFlow</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/main.4b4a2bd9.min.css">
+      
+        
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.356b1318.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=IBM+Plex+Sans:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"IBM Plex Sans";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo">
+  
+    
+    
+      <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#installation-on-macos" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="SignalFlow" class="md-header__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            SignalFlow
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Installing on macOS
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="red" data-md-color-accent="indigo"  aria-hidden="true"  type="radio" name="__palette" id="__palette_1">
+    
+  
+</form>
+      
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <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>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="SignalFlow" class="md-nav__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
+
+    </a>
+    SignalFlow
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/ideoforms/signalflow" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    ideoforms/signalflow
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../.." class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Home
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_1">
+            <span class="md-nav__icon md-icon"></span>
+            Home
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Getting started
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+            Getting started
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+    
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installation
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installation
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+    
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" checked>
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
+  
+  <span class="md-ellipsis">
+    Installing on macOS
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_2_2_2">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on macOS
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="easy/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Easy install
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../linux/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Installing on Linux
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_2_3">
+            <span class="md-nav__icon md-icon"></span>
+            Installing on Linux
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../linux/command-line/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Command-line installation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../examples/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Examples
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../license/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    License
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Reference library
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Reference library
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../graph/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    The AudioGraph
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            The AudioGraph
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../graph/creating/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Creating the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../graph/config/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Configuration
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../graph/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../graph/recording/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Recording the audio output
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../graph/stopping/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stopping the graph
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../node/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Nodes
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            Nodes
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/multichannel/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Multichannel
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Status and properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/stochastic/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Stochastic nodes
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../node/developing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Developing a new Node class
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../patch/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Patches
+  </span>
+  
+
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            Patches
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/defining/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Defining a Patch
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/playback/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Playback
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/inputs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Inputs
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/operators/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Operators
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/properties/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Properties
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/exporting/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Exporting and importing patches
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../patch/auto-free/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Auto-free and memory management
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+      
+        
+          
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
+        
+          
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../buffer/" class="md-nav__link ">
+              
+  
+  <span class="md-ellipsis">
+    Buffers
+  </span>
+  
+
+            </a>
+            
+          </div>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_7">
+            <span class="md-nav__icon md-icon"></span>
+            Buffers
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+<h1 id="installation-on-macos">Installation on macOS</h1>
+<!-- BEGIN INCLUDE installation/macos/buttons.md -->
+<p>If you're new to Python or getting started from scratch:</p>
+<p><a class="md-button" href="easy/">macOS: Easy install with Visual Studio Code</a> </p>
+<p>If you are an existing Python user and confident with the command line:</p>
+<p><a class="md-button" href="command-line/">macOS: Install from the command line</a></p>
+<!-- END INCLUDE -->
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+        </div>
+        
+          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
+  Back to top
+</button>
+        
+      </main>
+      
+        <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: Installation">
+            <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">
+                Installation
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="easy/" class="md-footer__link md-footer__link--next" aria-label="Next: Easy install">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Easy install
+              </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">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+        <div class="md-social">
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://github.com/ideoforms" target="_blank" rel="noopener" title="github.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.4.2 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 2023 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>
+  
+    
+    
+    
+    
+      
+      
+    
+    <a href="https://twitter.com/ideoforms" target="_blank" rel="noopener" title="twitter.com" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.4.2 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 2023 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy", "navigation.sections", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer"], "search": "../../assets/javascripts/workers/search.f886a092.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.81fa17fe.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/installation/next-steps/index.html b/installation/next-steps/index.html
index 5ef62094..914f460c 100644
--- a/installation/next-steps/index.html
+++ b/installation/next-steps/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/library/index.html b/library/index.html
similarity index 78%
rename from node/library/index.html
rename to library/index.html
index 204b8beb..d98c1caa 100644
--- a/node/library/index.html
+++ b/library/index.html
@@ -11,21 +11,25 @@
       
       
       
+        <link rel="prev" href="../license/">
       
       
-      <link rel="icon" href="../../assets/images/favicon.png">
+        <link rel="next" href="../graph/">
+      
+      
+      <link rel="icon" href="../assets/images/favicon.png">
       <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.8">
     
     
       
-        <title>Node reference library - SignalFlow</title>
+        <title>Reference library - SignalFlow</title>
       
     
     
-      <link rel="stylesheet" href="../../assets/stylesheets/main.4b4a2bd9.min.css">
+      <link rel="stylesheet" href="../assets/stylesheets/main.4b4a2bd9.min.css">
       
         
-        <link rel="stylesheet" href="../../assets/stylesheets/palette.356b1318.min.css">
+        <link rel="stylesheet" href="../assets/stylesheets/palette.356b1318.min.css">
       
       
 
@@ -44,7 +48,7 @@
       
     
     
-    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
     
       
 
@@ -89,7 +93,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../.." title="SignalFlow" class="md-header__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+    <a href=".." title="SignalFlow" class="md-header__button md-logo" aria-label="SignalFlow" data-md-component="logo">
       
   
   <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
@@ -109,7 +113,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
             
-              Node reference library
+              Reference library
             
           </span>
         </div>
@@ -205,7 +209,7 @@
 
 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="SignalFlow" class="md-nav__button md-logo" aria-label="SignalFlow" data-md-component="logo">
+    <a href=".." title="SignalFlow" class="md-nav__button md-logo" aria-label="SignalFlow" data-md-component="logo">
       
   
   <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
@@ -257,7 +261,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../.." class="md-nav__link ">
+            <a href=".." class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -320,7 +324,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../installation/" class="md-nav__link ">
+            <a href="../installation/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -376,7 +380,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../installation/" class="md-nav__link ">
+            <a href="../installation/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -411,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,12 +461,14 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
   
     <li class="md-nav__item">
-      <a href="../../installation/macos/easy/" class="md-nav__link">
+      <a href="../installation/macos/easy/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -470,7 +488,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../installation/macos/command-line/" class="md-nav__link">
+      <a href="../installation/macos/command-line/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -501,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,12 +563,14 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
   
     <li class="md-nav__item">
-      <a href="../../installation/linux/command-line/" class="md-nav__link">
+      <a href="../installation/linux/command-line/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -574,7 +606,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../examples/" class="md-nav__link">
+      <a href="../examples/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -594,7 +626,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../license/" class="md-nav__link">
+      <a href="../license/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -619,11 +651,15 @@
       
   
   
+    
+  
   
     
     
       
         
+          
+        
       
     
     
@@ -632,26 +668,29 @@
       
       
     
-    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
       
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
             <span class="md-nav__icon md-icon"></span>
             Reference library
@@ -659,24 +698,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -724,7 +745,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../graph/" class="md-nav__link ">
+            <a href="../graph/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -756,7 +777,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../graph/creating/" class="md-nav__link">
+      <a href="../graph/creating/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -776,7 +797,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../graph/config/" class="md-nav__link">
+      <a href="../graph/config/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -796,7 +817,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../graph/properties/" class="md-nav__link">
+      <a href="../graph/properties/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -816,7 +837,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../graph/recording/" class="md-nav__link">
+      <a href="../graph/recording/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -836,7 +857,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../graph/stopping/" class="md-nav__link">
+      <a href="../graph/stopping/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -900,7 +921,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../" class="md-nav__link ">
+            <a href="../node/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -932,7 +953,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../playback/" class="md-nav__link">
+      <a href="../node/playback/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -952,7 +973,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../inputs/" class="md-nav__link">
+      <a href="../node/inputs/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -972,7 +993,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../operators/" class="md-nav__link">
+      <a href="../node/operators/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -992,7 +1013,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../multichannel/" class="md-nav__link">
+      <a href="../node/multichannel/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1012,7 +1033,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../properties/" class="md-nav__link">
+      <a href="../node/properties/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1032,7 +1053,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../stochastic/" class="md-nav__link">
+      <a href="../node/stochastic/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1052,7 +1073,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../developing/" class="md-nav__link">
+      <a href="../node/developing/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1116,7 +1137,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../patch/" class="md-nav__link ">
+            <a href="../patch/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -1148,7 +1169,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/defining/" class="md-nav__link">
+      <a href="../patch/defining/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1168,7 +1189,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/playback/" class="md-nav__link">
+      <a href="../patch/playback/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1188,7 +1209,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/inputs/" class="md-nav__link">
+      <a href="../patch/inputs/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1208,7 +1229,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/operators/" class="md-nav__link">
+      <a href="../patch/operators/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1228,7 +1249,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/properties/" class="md-nav__link">
+      <a href="../patch/properties/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1248,7 +1269,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/exporting/" class="md-nav__link">
+      <a href="../patch/exporting/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1268,7 +1289,7 @@
   
   
     <li class="md-nav__item">
-      <a href="../../patch/auto-free/" class="md-nav__link">
+      <a href="../patch/auto-free/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
@@ -1318,7 +1339,7 @@
           
           
           <div class="md-nav__link md-nav__container">
-            <a href="../../buffer/" class="md-nav__link ">
+            <a href="../buffer/" class="md-nav__link ">
               
   
   <span class="md-ellipsis">
@@ -1374,105 +1395,105 @@
       
         <li class="md-nav__item">
   <a href="#analysis" class="md-nav__link">
-    analysis
+    Analysis
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#buffer" class="md-nav__link">
-    buffer
+    Buffer
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#control" class="md-nav__link">
-    control
+    Control
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#envelope" class="md-nav__link">
-    envelope
+    Envelope
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#fft" class="md-nav__link">
-    fft
+    Fft
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#operators" class="md-nav__link">
-    operators
+    Operators
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#oscillators" class="md-nav__link">
-    oscillators
+    Oscillators
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#processors" class="md-nav__link">
-    processors
+    Processors
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#processorsdelays" class="md-nav__link">
-    processors/delays
+  <a href="#processors-delays" class="md-nav__link">
+    Processors: Delays
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#processorsdistortion" class="md-nav__link">
-    processors/distortion
+  <a href="#processors-distortion" class="md-nav__link">
+    Processors: Distortion
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#processorsdynamics" class="md-nav__link">
-    processors/dynamics
+  <a href="#processors-dynamics" class="md-nav__link">
+    Processors: Dynamics
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#processorsfilters" class="md-nav__link">
-    processors/filters
+  <a href="#processors-filters" class="md-nav__link">
+    Processors: Filters
   </a>
   
 </li>
       
         <li class="md-nav__item">
-  <a href="#processorspanning" class="md-nav__link">
-    processors/panning
+  <a href="#processors-panning" class="md-nav__link">
+    Processors: Panning
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#sequencing" class="md-nav__link">
-    sequencing
+    Sequencing
   </a>
   
 </li>
       
         <li class="md-nav__item">
   <a href="#stochastic" class="md-nav__link">
-    stochastic
+    Stochastic
   </a>
   
 </li>
@@ -1496,13 +1517,13 @@
 
 
 <h1 id="node-reference-library">Node reference library</h1>
-<h2 id="analysis">analysis</h2>
+<h2 id="analysis">Analysis</h2>
 <ul>
-<li><strong>CrossCorrelate</strong>: CrossCorrelate <code>(input=nullptr, buffer=nullptr, hop_size=0)</code></li>
-<li><strong>OnsetDetector</strong>: OnsetDetector <code>(input=0.0, threshold=2.0, min_interval=0.1)</code></li>
-<li><strong>VampAnalysis</strong>: VampAnalysis <code>(input=0.0, plugin_id="vamp-example-plugins:spectralcentroid:linearcentroid")</code></li>
+<li><strong>CrossCorrelate</strong>: Outputs the cross-correlation of the input signal with the given buffer. If hop_size is zero, calculates the cross-correlation every sample. <code>(input=nullptr, buffer=nullptr, hop_size=0)</code></li>
+<li><strong>OnsetDetector</strong>: Simple time-domain onset detector. Outputs an impulse when an onset is detected in the input. Maintains short-time and long-time averages. An onset is registered when the short-time average is threshold x the long-time average. min_interval is the minimum interval between onsets, in seconds. <code>(input=0.0, threshold=2.0, min_interval=0.1)</code></li>
+<li><strong>VampAnalysis</strong>: Feature extraction using the Vamp plugin toolkit. <code>(input=0.0, plugin_id="vamp-example-plugins:spectralcentroid:linearcentroid")</code></li>
 </ul>
-<h2 id="buffer">buffer</h2>
+<h2 id="buffer">Buffer</h2>
 <ul>
 <li><strong>BeatCutter</strong>: Cuts a buffer into segment_count segments, and stutters/jumps with the given probabilities. <code>(buffer=nullptr, segment_count=8, stutter_probability=0.0, stutter_count=1, jump_probability=0.0, duty_cycle=1.0, rate=1.0, segment_rate=1.0)</code></li>
 <li><strong>BufferLooper</strong>: Read and write from a buffer concurrently, with controllable overdub. <code>(buffer=nullptr, input=0.0, feedback=0.0, loop_playback=false, loop_record=false)</code></li>
@@ -1514,13 +1535,13 @@ <h2 id="buffer">buffer</h2>
 <li><strong>Granulator</strong>: Granulator. Generates a grain from the given buffer each time a clock signal is received, with the given duration/rate/pan parameters. The input buffer can be mono or stereo. <code>(buffer=nullptr, clock=0, pos=0, duration=0.1, pan=0.0, rate=1.0, max_grains=2048)</code></li>
 <li><strong>SegmentPlayer</strong>: Trigger segments of a buffer at the given onset positions. <code>(buffer=nullptr, onsets={})</code></li>
 </ul>
-<h2 id="control">control</h2>
+<h2 id="control">Control</h2>
 <ul>
-<li><strong>MouseX</strong>: Outputs the normalised cursor X position, from 0 to 1. <code>()</code></li>
-<li><strong>MouseY</strong>: Outputs the normalised cursor Y position, from 0 to 1. <code>()</code></li>
-<li><strong>MouseDown</strong>: Outputs 1 if the left mouse button is down, 0 otherwise. <code>(button_index=0)</code></li>
+<li><strong>MouseX</strong>: Outputs the normalised cursor X position, from 0 to 1. Currently only supported on macOS. <code>()</code></li>
+<li><strong>MouseY</strong>: Outputs the normalised cursor Y position, from 0 to 1. Currently only supported on macOS. <code>()</code></li>
+<li><strong>MouseDown</strong>: Outputs 1 if the left mouse button is down, 0 otherwise. Currently only supported on macOS. <code>(button_index=0)</code></li>
 </ul>
-<h2 id="envelope">envelope</h2>
+<h2 id="envelope">Envelope</h2>
 <ul>
 <li><strong>ADSREnvelope</strong>: Attack-decay-sustain-release envelope. Sustain portion is held until gate is zero. <code>(attack=0.1, decay=0.1, sustain=0.5, release=0.1, gate=0)</code></li>
 <li><strong>ASREnvelope</strong>: Attack-sustain-release envelope. <code>(attack=0.1, sustain=0.5, release=0.1, curve=1.0, clock=nullptr)</code></li>
@@ -1529,56 +1550,56 @@ <h2 id="envelope">envelope</h2>
 <li><strong>Line</strong>: Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal. <code>(from=0.0, to=1.0, time=1.0, loop=0, clock=nullptr)</code></li>
 <li><strong>RectangularEnvelope</strong>: Rectangular envelope with the given sustain duration. <code>(sustain_duration=1.0, clock=nullptr)</code></li>
 </ul>
-<h2 id="fft">fft</h2>
+<h2 id="fft">Fft</h2>
 <ul>
-<li><strong>FFTContinuousPhaseVocoder</strong>: FFTContinuousPhaseVocoder <code>(input=nullptr, rate=1.0)</code></li>
-<li><strong>FFTConvolve</strong>: FFTConvolve <code>(input=nullptr, buffer=nullptr)</code></li>
-<li><strong>FFT</strong>: FFT <code>(input=0.0, fft_size=SIGNALFLOW_DEFAULT_FFT_SIZE, hop_size=SIGNALFLOW_DEFAULT_FFT_HOP_SIZE, window_size=0, do_window=true)</code></li>
+<li><strong>FFTContinuousPhaseVocoder</strong>: Continuous phase vocoder. Requires an FFT* input. <code>(input=nullptr, rate=1.0)</code></li>
+<li><strong>FFTConvolve</strong>: Frequency-domain convolution, using overlap-add. Useful for convolution reverb, with the input buffer containing an impulse response. Requires an FFT* input. <code>(input=nullptr, buffer=nullptr)</code></li>
+<li><strong>FFT</strong>: Fast Fourier Transform. Takes a time-domain input, and generates a frequency-domain (FFT) output. <code>(input=0.0, fft_size=SIGNALFLOW_DEFAULT_FFT_SIZE, hop_size=SIGNALFLOW_DEFAULT_FFT_HOP_SIZE, window_size=0, do_window=true)</code></li>
 <li><strong>FFTNode</strong>: FFTNode <code>(fft_size=None, hop_size=None, window_size=None, do_window=None)</code></li>
 <li><strong>FFTOpNode</strong>: FFTOpNode <code>(input=nullptr)</code></li>
-<li><strong>FFTFindPeaks</strong>: FFTFindPeaks <code>(input=0, prominence=1, threshold=0.000001, count=SIGNALFLOW_MAX_CHANNELS, interpolate=true)</code></li>
-<li><strong>IFFT</strong>: IFFT <code>(input=nullptr, do_window=false)</code></li>
-<li><strong>FFTLPF</strong>: FFTLPF <code>(input=0, frequency=2000)</code></li>
-<li><strong>FFTNoiseGate</strong>: FFTNoiseGate <code>(input=0, threshold=0.5)</code></li>
-<li><strong>FFTPhaseVocoder</strong>: FFTPhaseVocoder <code>(input=nullptr)</code></li>
-<li><strong>FFTTonality</strong>: FFTTonality <code>(input=0, level=0.5, smoothing=0.9)</code></li>
-<li><strong>FFTZeroPhase</strong>: FFTZeroPhase <code>(input=0)</code></li>
+<li><strong>FFTFindPeaks</strong>: Find peaks in the FFT magnitude spectrum. Requires an FFT* input. <code>(input=0, prominence=1, threshold=0.000001, count=SIGNALFLOW_MAX_CHANNELS, interpolate=true)</code></li>
+<li><strong>IFFT</strong>: Inverse Fast Fourier Transform. Requires an FFT* input, generates a time-domain output. <code>(input=nullptr, do_window=false)</code></li>
+<li><strong>FFTLPF</strong>: FFT-based brick wall low pass filter. Requires an FFT* input. <code>(input=0, frequency=2000)</code></li>
+<li><strong>FFTNoiseGate</strong>: FFT-based noise gate. Requires an FFT* input. <code>(input=0, threshold=0.5)</code></li>
+<li><strong>FFTPhaseVocoder</strong>: Phase vocoder. Requires an FFT* input. <code>(input=nullptr)</code></li>
+<li><strong>FFTTonality</strong>: Tonality filter. Requires an FFT* input. <code>(input=0, level=0.5, smoothing=0.9)</code></li>
+<li><strong>FFTZeroPhase</strong>: Remove phase information from a frequency-domain input. Requires an FFT* input. <code>(input=0)</code></li>
 </ul>
-<h2 id="operators">operators</h2>
+<h2 id="operators">Operators</h2>
 <ul>
-<li><strong>Add</strong>: Add <code>(a=0, b=0)</code></li>
-<li><strong>AmplitudeToDecibels</strong>: AmplitudeToDecibels <code>(a=0)</code></li>
+<li><strong>Add</strong>: Add each sample of a to each sample of b. Can also be written as a + b <code>(a=0, b=0)</code></li>
+<li><strong>AmplitudeToDecibels</strong>: Map a linear amplitude value to decibels. <code>(a=0)</code></li>
 <li><strong>DecibelsToAmplitude</strong>: DecibelsToAmplitude <code>(a=0)</code></li>
 <li><strong>ChannelArray</strong>: Takes an array of inputs and spreads them across multiple channels of output. <code>()</code></li>
 <li><strong>ChannelCrossfade</strong>: Given a multichannel input, crossfades between channels based on the given position within the virtual array, producing a single-channel output. <code>(input=nullptr, index=nullptr, num_output_channels=1)</code></li>
 <li><strong>ChannelMixer</strong>: Downmix a multichannel input to a lower-channel output. If num_channels is greater than one, spreads the input channels across the field. If amplitude_compensation is enabled, scale down the amplitude based on the ratio of input to output channels. <code>(num_channels=1, input=0, amplitude_compensation=true)</code></li>
 <li><strong>ChannelSelect</strong>: Select a subset of channels from a multichannel input, starting at offset, up to a maximum of maximum, with the given step. <code>(input=nullptr, offset=0, maximum=0, step=1)</code></li>
-<li><strong>Equal</strong>: Equal <code>(a=0, b=0)</code></li>
-<li><strong>NotEqual</strong>: NotEqual <code>(a=0, b=0)</code></li>
-<li><strong>GreaterThan</strong>: GreaterThan <code>(a=0, b=0)</code></li>
-<li><strong>GreaterThanOrEqual</strong>: GreaterThanOrEqual <code>(a=0, b=0)</code></li>
-<li><strong>LessThan</strong>: LessThan <code>(a=0, b=0)</code></li>
-<li><strong>LessThanOrEqual</strong>: LessThanOrEqual <code>(a=0, b=0)</code></li>
-<li><strong>Modulo</strong>: Modulo <code>(a=0, b=0)</code></li>
-<li><strong>Abs</strong>: Abs <code>(a=0)</code></li>
-<li><strong>If</strong>: If <code>(a=0, value_if_true=0, value_if_false=0)</code></li>
-<li><strong>Divide</strong>: Divide <code>(a=1, b=1)</code></li>
+<li><strong>Equal</strong>: Compares the output of a to the output of b. Outputs 1 when equal, 0 otherwise. Can also be written as a == b <code>(a=0, b=0)</code></li>
+<li><strong>NotEqual</strong>: Compares the output of a to the output of b. Outputs 0 when equal, 1 otherwise. Can also be written as a != b <code>(a=0, b=0)</code></li>
+<li><strong>GreaterThan</strong>: Compares the output of a to the output of b. Outputs 1 when a &gt; b, 0 otherwise. Can also be written as a &gt; b <code>(a=0, b=0)</code></li>
+<li><strong>GreaterThanOrEqual</strong>: Compares the output of a to the output of b. Outputs 1 when a &gt;= b, 0 otherwise. Can also be written as a &gt;= b <code>(a=0, b=0)</code></li>
+<li><strong>LessThan</strong>: Compares the output of a to the output of b. Outputs 1 when a &lt; b, 0 otherwise. Can also be written as a &lt; b <code>(a=0, b=0)</code></li>
+<li><strong>LessThanOrEqual</strong>: Compares the output of a to the output of b. Outputs 1 when a &lt;= b, 0 otherwise. Can also be written as a &lt;= b <code>(a=0, b=0)</code></li>
+<li><strong>Modulo</strong>: Outputs the value of a modulo b, per sample. Supports fractional values. Can also be written as a % b <code>(a=0, b=0)</code></li>
+<li><strong>Abs</strong>: Outputs the absolute value of a, per sample. Can also be written as abs(a) <code>(a=0)</code></li>
+<li><strong>If</strong>: Outputs value_if_true for each non-zero value of a, value_if_false for all other values. <code>(a=0, value_if_true=0, value_if_false=0)</code></li>
+<li><strong>Divide</strong>: Divide each sample of a by each sample of b. Can also be written as a / b <code>(a=1, b=1)</code></li>
 <li><strong>FrequencyToMidiNote</strong>: Map a frequency to a MIDI note (where 440Hz = A4 = 69), with floating-point output. <code>(a=0)</code></li>
 <li><strong>MidiNoteToFrequency</strong>: Map a MIDI note to a frequency (where 440Hz = A4 = 69), supporting floating-point input. <code>(a=0)</code></li>
-<li><strong>Multiply</strong>: Multiply <code>(a=1.0, b=1.0)</code></li>
-<li><strong>Pow</strong>: Pow <code>(a=0, b=0)</code></li>
+<li><strong>Multiply</strong>: Multiply each sample of a by each sample of b. Can also be written as a * b <code>(a=1.0, b=1.0)</code></li>
+<li><strong>Pow</strong>: Outputs a to the power of b, per sample. Can also be written as a ** b <code>(a=0, b=0)</code></li>
 <li><strong>RoundToScale</strong>: Given a frequency input, generates a frequency output that is rounded to the nearest MIDI note. (TODO: Not very well named) <code>(a=0)</code></li>
 <li><strong>Round</strong>: Round the input to the nearest integer value. <code>(a=0)</code></li>
 <li><strong>ScaleLinExp</strong>: Scales the input from a linear range (between a and b) to an exponential range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li>
 <li><strong>ScaleLinLin</strong>: Scales the input from a linear range (between a and b) to a linear range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li>
-<li><strong>Subtract</strong>: Subtract <code>(a=0, b=0)</code></li>
-<li><strong>Sum</strong>: Sum <code>()</code></li>
-<li><strong>Sin</strong>: Sin <code>(a=0)</code></li>
-<li><strong>Cos</strong>: Cos <code>(a=0)</code></li>
-<li><strong>Tan</strong>: Tan <code>(a=0)</code></li>
-<li><strong>Tanh</strong>: Tanh <code>(a=0)</code></li>
+<li><strong>Subtract</strong>: Subtract each sample of b from each sample of a. Can also be written as a - b <code>(a=0, b=0)</code></li>
+<li><strong>Sum</strong>: Sums the output of all of the input nodes, by sample. <code>()</code></li>
+<li><strong>Sin</strong>: Outputs sin(a), per sample. <code>(a=0)</code></li>
+<li><strong>Cos</strong>: Outputs cos(a), per sample. <code>(a=0)</code></li>
+<li><strong>Tan</strong>: Outputs tan(a), per sample. <code>(a=0)</code></li>
+<li><strong>Tanh</strong>: Outputs tanh(a), per sample. Can be used as a soft clipper. <code>(a=0)</code></li>
 </ul>
-<h2 id="oscillators">oscillators</h2>
+<h2 id="oscillators">Oscillators</h2>
 <ul>
 <li><strong>Constant</strong>: Produces a constant value. <code>(value=0)</code></li>
 <li><strong>Impulse</strong>: Produces a value of 1 at the given frequency, with output of 0 at all other times. If frequency is 0, produces a single impulse. <code>(frequency=1.0)</code></li>
@@ -1594,7 +1615,7 @@ <h2 id="oscillators">oscillators</h2>
 <li><strong>Wavetable</strong>: Plays the wavetable stored in buffer at the given frequency. <code>(buffer=nullptr, frequency=440, phase=0, sync=0, phase_map=nullptr)</code></li>
 <li><strong>Wavetable2D</strong>: Wavetable2D <code>(buffer=nullptr, frequency=440, crossfade=0.0, phase=0.0, sync=0)</code></li>
 </ul>
-<h2 id="processors">processors</h2>
+<h2 id="processors">Processors</h2>
 <ul>
 <li><strong>Clip</strong>: Clip the input to min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li>
 <li><strong>Fold</strong>: Fold the input beyond min/max, reflecting the excess back. <code>(input=nullptr, min=-1.0, max=1.0)</code></li>
@@ -1602,35 +1623,35 @@ <h2 id="processors">processors</h2>
 <li><strong>WetDry</strong>: Takes wet and dry inputs, and outputs a mix determined by wetness. <code>(dry_input=nullptr, wet_input=nullptr, wetness=0.0)</code></li>
 <li><strong>Wrap</strong>: Wrap the input beyond min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li>
 </ul>
-<h2 id="processorsdelays">processors/delays</h2>
+<h2 id="processors-delays">Processors: Delays</h2>
 <ul>
 <li><strong>AllpassDelay</strong>: All-pass delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li>
 <li><strong>CombDelay</strong>: Comb delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li>
 <li><strong>OneTapDelay</strong>: Single-tap delay line. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, max_delay_time=0.5)</code></li>
 <li><strong>Stutter</strong>: Stutters the input whenever a signal is received on clock. Generates stutter_count repeats, with duration stutter_time. <code>(input=0.0, stutter_time=0.1, stutter_count=1, clock=nullptr, max_stutter_time=1.0)</code></li>
 </ul>
-<h2 id="processorsdistortion">processors/distortion</h2>
+<h2 id="processors-distortion">Processors: Distortion</h2>
 <ul>
 <li><strong>Resample</strong>: Resampler and bit crusher. sample_rate is in Hz, bit_rate is an integer between 0 and 16. <code>(input=0, sample_rate=44100, bit_rate=16)</code></li>
 <li><strong>SampleAndHold</strong>: Samples and holds the input each time a clock signal is received. <code>(input=nullptr, clock=nullptr)</code></li>
 <li><strong>Squiz</strong>: Implementation of Dan Stowell's Squiz algorithm, a kind of downsampler. <code>(input=0.0, rate=2.0, chunk_size=1)</code></li>
 <li><strong>WaveShaper</strong>: Applies wave-shaping as described in buffer. <code>(input=0.0, buffer=nullptr)</code></li>
 </ul>
-<h2 id="processorsdynamics">processors/dynamics</h2>
+<h2 id="processors-dynamics">Processors: Dynamics</h2>
 <ul>
 <li><strong>Compressor</strong>: Dynamic range compression, with optional sidechain input. <code>(input=0.0, threshold=0.1, ratio=2, attack_time=0.01, release_time=0.1, sidechain=nullptr)</code></li>
 <li><strong>Gate</strong>: Outputs the input value when it is above the given threshold, otherwise zero. <code>(input=0.0, threshold=0.1)</code></li>
 <li><strong>Maximiser</strong>: Gain maximiser. <code>(input=0.0, ceiling=0.5, attack_time=1.0, release_time=1.0)</code></li>
 <li><strong>RMS</strong>: Outputs the root-mean-squared value of the input, in buffers equal to the graph's current buffer size. <code>(input=0.0)</code></li>
 </ul>
-<h2 id="processorsfilters">processors/filters</h2>
+<h2 id="processors-filters">Processors: Filters</h2>
 <ul>
 <li><strong>BiquadFilter</strong>: Biquad filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. Not recommended for real-time modulation; for this, use SVFilter. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0, peak_gain=0.0)</code></li>
 <li><strong>EQ</strong>: Three-band EQ. <code>(input=0.0, low_gain=1.0, mid_gain=1.0, high_gain=1.0, low_freq=500, high_freq=5000)</code></li>
 <li><strong>MoogVCF</strong>: Moog ladder low-pass filter. <code>(input=0.0, cutoff=200.0, resonance=0.0)</code></li>
 <li><strong>SVFilter</strong>: State variable filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0)</code></li>
 </ul>
-<h2 id="processorspanning">processors/panning</h2>
+<h2 id="processors-panning">Processors: Panning</h2>
 <ul>
 <li><strong>AzimuthPanner</strong>: Pan input around an equally-spaced ring of num_channels speakers. pan is the pan position from -1..+1, where 0 = centre front. width is the source's width, where 1.0 spans exactly between an adjacent pair of channels. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li>
 <li><strong>ChannelPanner</strong>: Pan the input between a linear series of channels, where pan 0 = channel 0, 1 = channel 1, etc. No wrapping is applied. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li>
@@ -1639,7 +1660,7 @@ <h2 id="processorspanning">processors/panning</h2>
 <li><strong>StereoPanner</strong>: Pans a mono input to a stereo output. Pans from -1 (hard left) to +1 (hard right), with 0 = centre. <code>(input=0, pan=0.0)</code></li>
 <li><strong>StereoWidth</strong>: Reduces the width of a stereo signal. When width = 1, input is unchanged. When width = 0, outputs a pair of identical channels both containing L+R. <code>(input=0, width=1)</code></li>
 </ul>
-<h2 id="sequencing">sequencing</h2>
+<h2 id="sequencing">Sequencing</h2>
 <ul>
 <li><strong>ClockDivider</strong>: When given a clock input (e.g., an Impulse), divides the clock by the given factor. factor must be an integer greater than or equal to 1. <code>(clock=0, factor=1)</code></li>
 <li><strong>Counter</strong>: Count upwards from min, driven by clock. <code>(clock=0, min=0, max=2147483647)</code></li>
@@ -1650,7 +1671,7 @@ <h2 id="sequencing">sequencing</h2>
 <li><strong>Latch</strong>: Initially outputs 0. When a trigger is received at set, outputs 1. When a trigger is subsequently received at reset, outputs 0, until the next set. <code>(set=0, reset=0)</code></li>
 <li><strong>Sequence</strong>: Outputs the elements in sequence, incrementing position on each clock. <code>(sequence=std::vector&lt;float&gt; ( ), clock=nullptr)</code></li>
 </ul>
-<h2 id="stochastic">stochastic</h2>
+<h2 id="stochastic">Stochastic</h2>
 <ul>
 <li><strong>Logistic</strong>: Logistic noise. <code>(chaos=3.7, frequency=0.0)</code></li>
 <li><strong>PinkNoise</strong>: Pink noise, with specified low/high cutoffs. <code>(low_cutoff=20.0, high_cutoff=20000.0, reset=nullptr)</code></li>
@@ -1689,6 +1710,44 @@ <h2 id="stochastic">stochastic</h2>
         <footer class="md-footer">
   
     
+      
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+        
+          
+          <a href="../license/" class="md-footer__link md-footer__link--prev" aria-label="Previous: License">
+            <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">
+                License
+              </div>
+            </div>
+          </a>
+        
+        
+          
+          <a href="../graph/" class="md-footer__link md-footer__link--next" aria-label="Next: The AudioGraph">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                The AudioGraph
+              </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">
@@ -1738,10 +1797,10 @@ <h2 id="stochastic">stochastic</h2>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy", "navigation.sections", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer"], "search": "../../assets/javascripts/workers/search.f886a092.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.code.copy", "navigation.sections", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer"], "search": "../assets/javascripts/workers/search.f886a092.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.81fa17fe.min.js"></script>
+      <script src="../assets/javascripts/bundle.81fa17fe.min.js"></script>
       
     
   </body>
diff --git a/license/index.html b/license/index.html
index 5a4b0028..4f091afb 100644
--- a/license/index.html
+++ b/license/index.html
@@ -14,7 +14,7 @@
         <link rel="prev" href="../examples/">
       
       
-        <link rel="next" href="../graph/">
+        <link rel="next" href="../library/">
       
       
       <link rel="icon" href="../assets/images/favicon.png">
@@ -417,6 +417,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -432,16 +436,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -451,6 +463,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -507,6 +521,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -520,16 +538,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -539,6 +565,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -640,6 +668,8 @@
     
       
         
+          
+        
       
     
     
@@ -656,16 +686,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -675,24 +708,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1446,13 +1461,13 @@ <h1 id="license">License</h1>
         
         
           
-          <a href="../graph/" class="md-footer__link md-footer__link--next" aria-label="Next: The AudioGraph">
+          <a href="../library/" class="md-footer__link md-footer__link--next" aria-label="Next: Reference library">
             <div class="md-footer__title">
               <span class="md-footer__direction">
                 Next
               </span>
               <div class="md-ellipsis">
-                The AudioGraph
+                Reference library
               </div>
             </div>
             <div class="md-footer__button md-icon">
diff --git a/node/developing/index.html b/node/developing/index.html
index 945f6b8f..0f65c1c1 100644
--- a/node/developing/index.html
+++ b/node/developing/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/index.html b/node/index.html
index 21f96233..3af60146 100644
--- a/node/index.html
+++ b/node/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1400,7 +1415,7 @@ <h1 id="nodes">Nodes</h1>
 <li>A Node's status and output can be examined by querying its <a href="properties/">properties</a></li>
 <li>Some Nodes generate unpredictable <a href="stochastic/">stochastic output</a>, which can be controlled via its internal random number generator </li>
 <li>Details of how to create a new Node type are detailed in <a href="developing/">Developing a new Node class</a></li>
-<li>For an overview of every type of Node available in SignalFlow, see the <a href="library/">Node Reference Library</a></li>
+<li>For an overview of every type of Node available in SignalFlow, see the <a href="library.md">Node Reference Library</a></li>
 </ul>
 <hr />
 <p><a href="playback/">→ Next: Node playback</a></p>
diff --git a/node/inputs/index.html b/node/inputs/index.html
index 135b3c96..9c394683 100644
--- a/node/inputs/index.html
+++ b/node/inputs/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/multichannel/index.html b/node/multichannel/index.html
index 9d6ea2e6..fa8981d2 100644
--- a/node/multichannel/index.html
+++ b/node/multichannel/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/operators/index.html b/node/operators/index.html
index a5d471a0..ded4af3a 100644
--- a/node/operators/index.html
+++ b/node/operators/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/playback/index.html b/node/playback/index.html
index c9dab578..e11ca137 100644
--- a/node/playback/index.html
+++ b/node/playback/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/properties/index.html b/node/properties/index.html
index 66fed524..96724c49 100644
--- a/node/properties/index.html
+++ b/node/properties/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/node/stochastic/index.html b/node/stochastic/index.html
index 23fc417b..4af0affe 100644
--- a/node/stochastic/index.html
+++ b/node/stochastic/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
@@ -1473,7 +1488,7 @@ <h2 id="chance-and-stochastic-nodes">Chance and stochastic nodes</h2>
 <p>Calling <code>node.process()</code> is generally not good practice, as it does not recursively process all of the node's inputs (unlike when a node is embedded within an AudioGraph, which correctly handles recursion and cyclical loops). Please use at your peril!</p>
 </div>
 <hr />
-<p><a href="../library/">→ Next: Node reference library</a></p>
+<p><a href="library.md">→ Next: Node reference library</a></p>
 
 
 
diff --git a/patch/auto-free/index.html b/patch/auto-free/index.html
index 878de5fe..795f1855 100644
--- a/patch/auto-free/index.html
+++ b/patch/auto-free/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/defining/index.html b/patch/defining/index.html
index d5fa1fb6..3c5a0b77 100644
--- a/patch/defining/index.html
+++ b/patch/defining/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/exporting/index.html b/patch/exporting/index.html
index 7528e07e..af7176f5 100644
--- a/patch/exporting/index.html
+++ b/patch/exporting/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/index.html b/patch/index.html
index 74336940..cb7a62c0 100644
--- a/patch/index.html
+++ b/patch/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/inputs/index.html b/patch/inputs/index.html
index 690993cf..dc587318 100644
--- a/patch/inputs/index.html
+++ b/patch/inputs/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/operators/index.html b/patch/operators/index.html
index 6685d129..dbd29cb5 100644
--- a/patch/operators/index.html
+++ b/patch/operators/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/playback/index.html b/patch/playback/index.html
index f9efa962..912cd9cc 100644
--- a/patch/playback/index.html
+++ b/patch/playback/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/patch/properties/index.html b/patch/properties/index.html
index 8d53d28e..aaba1392 100644
--- a/patch/properties/index.html
+++ b/patch/properties/index.html
@@ -415,6 +415,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -430,16 +434,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -449,6 +461,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -505,6 +519,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -518,16 +536,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -537,6 +563,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -628,6 +656,8 @@
     
       
         
+          
+        
       
     
     
@@ -644,16 +674,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -663,24 +696,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/planning/NAMING/index.html b/planning/NAMING/index.html
index a388322e..3109c2e9 100644
--- a/planning/NAMING/index.html
+++ b/planning/NAMING/index.html
@@ -411,6 +411,10 @@
     
       
         
+          
+        
+      
+        
       
         
       
@@ -426,16 +430,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_2" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/macos/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on macOS
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_2" id="__nav_2_2_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_2">
@@ -445,6 +457,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -501,6 +515,10 @@
     
       
         
+          
+        
+      
+        
       
     
     
@@ -514,16 +532,24 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_3" >
         
           
-          <label class="md-nav__link" for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../installation/linux/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Installing on Linux
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2_2_3" id="__nav_2_2_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2_2_3">
@@ -533,6 +559,8 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
+            
+              
                 
   
   
@@ -624,6 +652,8 @@
     
       
         
+          
+        
       
     
     
@@ -640,16 +670,19 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          
+          <div class="md-nav__link md-nav__container">
+            <a href="../../library/" class="md-nav__link ">
+              
   
   <span class="md-ellipsis">
     Reference library
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -659,24 +692,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../library/index.md" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference library
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
           </ul>
         </nav>
diff --git a/search/search_index.json b/search/search_index.json
index 0ee8ce1c..0566807d 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"SignalFlow: Explore sound synthesis and DSP with Python","text":"<p>SignalFlow is a sound synthesis framework whose goal is to make it quick and intuitive to explore complex sonic ideas. It has a simple Python API, allowing for rapid prototyping in Jupyter notebooks or on the command-line. It comes with over 100 signal processing classes for creative exploration, from filters and delays to FFT-based spectral processing and Euclidean rhythm generators.</p> <p>Its core is implemented in efficient C++11, with cross-platform hardware acceleration.  </p> <p>SignalFlow has robust support for macOS and Linux (including Raspberry Pi), and has work-in-progress support for Windows. The overall project is currently in alpha status, and interfaces may change without warning.</p>"},{"location":"#example","title":"Example","text":"<p>Let's take a look at a minimal SignalFlow example. Here, we create and immediately start the <code>AudioGraph</code>, construct a stereo sine oscillator with a short envelope, connect the oscillator to the graph's output, and run the graph indefinitely.</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope\noutput.play()\ngraph.wait()\n</code></pre> <p>This demo shows a few syntactical benefits that SignalFlow provides to make it easy to work with audio:</p> <ul> <li>The 2-item array of frequency values passed to <code>SineOscillator</code> is expanded to create a stereo, 2-channel output. If you passed a 10-item array, the output would have 10 channels. (Read more: Multichannel nodes)</li> <li>Mathematical operators like <code>*</code> can be used to multiply, add, subtract or divide the output of nodes, and creates a new output Node that corresponds to the output of the operation. This example uses an envelope to modulate the amplitude of an oscillator. (Read more: Node operators)</li> <li>Even through the envelope is mono and the oscillator is stereo, SignalFlow does the right thing and upmixes the envelope's values to create a stereo output, so that the same envelope shape is applied to the L and R channels of the oscillator, before creating a stereo output. This is called \"automatic upmixing\", and is handy when working with multichannel graphs. (Read more: Automatic upmixing)</li> </ul> <p>In subsequent examples, we will skip the <code>import</code> line and assume you have already imported everything from the <code>signalflow</code> namespace.</p> <p>Info</p> <p>If you want to enforce separation of namespaces, you might want to do something like the below. <pre><code>import signalflow as sf\n\ngraph = sf.AudioGraph()\nsine = sf.SineOscillator(440)\n...\n</code></pre></p>"},{"location":"#overview","title":"Overview","text":"<p>At its core, SignalFlow has a handful of key concepts.</p> <ul> <li>At the top level is the AudioGraph, which connects to the system's audio input/output hardware.</li> <li>The graph comprises of a network of Nodes, each of which performs a single function (for example, generating a cyclical waveform, or filtering an input node). Nodes are connected by input and output relationships: the output of one node may be used to control the frequency of another. As the output of the first node increases, the frequency of the second node increases correspondingly. This modulation is applied on a sample-by-sample basis: all modulation in SignalFlow happens at audio rate.</li> <li>Nodes may have multiple inputs, which determine which synthesis properties can be modulated at runtime.</li> <li>A node can also have Buffer properties, which contain audio waveform data that can be read and written to, for playback or recording of samples. </li> <li>Nodes can be grouped in a Patch, which is a user-defined configuration of nodes. A patch may have one or more named inputs that are defined by the user when creating the patch. Patches can be thought of like voices of a synthesizer. A patch can also be set to automatically remove itself from the graph when a specified node's playback is complete, which is important for automatic memory management.</li> </ul>"},{"location":"#documentation","title":"Documentation","text":"<ul> <li>Installation</li> <li>Example code</li> </ul>"},{"location":"examples/","title":"Examples","text":"<p>For various code examples using SignalFlow, see <code>examples</code> in GitHub:</p> <p>https://github.com/ideoforms/signalflow/tree/master/examples</p>"},{"location":"getting-started/","title":"Getting started","text":""},{"location":"getting-started/#requirements","title":"Requirements","text":"<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p>"},{"location":"getting-started/#installation","title":"Installation","text":""},{"location":"getting-started/#macos","title":"macOS","text":"<p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install SignalFlow from the command line</p> <p>If you're new to Python or getting started from scratch: </p> <p>macOS: Install SignalFlow with Visual Studio Code </p>"},{"location":"getting-started/#examples","title":"Examples","text":"<p>Several example scripts are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>"},{"location":"license/","title":"License","text":"<p>SignalFlow is under the MIT license.</p> <p>This means that you are welcome to use it for any purpose, including commercial usage, but must include the copyright notice above in any copies or derivative works.</p> <p>Please do let me know what you use it for! </p>"},{"location":"buffer/","title":"Buffer","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>A <code>Buffer</code> is an allocated area of memory that can be used to store single-channel or multi-channel data, which may represent an audio waveform or any other type of signal. </p> <ul> <li>A Buffer can be created from a sound file, an array of samples, or with an empty contents</li> <li>A Buffer can be passed to a Node or Patch as an input</li> <li>A Buffer can be exported to a sound file</li> <li>A Buffer's data can be directly accessed in memory as a numpy array, or by get/set methods</li> <li>The contents of a buffer can be combined with arithmetic operators</li> <li>Properties</li> <li>Buffer interpolation modes</li> <li>2D buffers</li> <li>Buffer applications: Sample recording and playback, control recording and playback, envelopes, waveshapers </li> <li>The total Buffer memory usage can be queried </li> </ul>"},{"location":"graph/","title":"The AudioGraph","text":"<p><code>AudioGraph</code> is the global audio processing system that schedules and performs audio processing. It is comprised of an interconnected network of Node and Patch objects, which audio flows through.</p> <p>Each time a new block of audio is requested by the system audio I/O layer, the <code>AudioGraph</code> object is responsible for traversing the tree of nodes and generating new samples by calling each <code>Node</code>'s <code>process</code> method.</p> <p>Why 'Graph'?</p> <p>You may be more familiar with \"graph\" being used to mean a data visualisation. In signal processing and discrete mathematics, the term \"graph\" is also used to denote a system of nodes (\"vertices\") related by connections (\"edges\"). Read more: Graph Theory Basics (Lumen Learning). </p> <p>\u2192 Next: Creating the graph</p>"},{"location":"graph/config/","title":"The AudioGraph","text":""},{"location":"graph/config/#graph-configuration","title":"Graph configuration","text":"<p>There are a number of graph configuration parameters that can be used to change the global behaviour of the audio system. This can be done programmatically, via a config file, or via environmental variables.</p> Parameter Description output_backend_name The name of the audio output backend to use, which can be one of: <code>jack</code>, <code>alsa</code>, <code>pulseaudio</code>, <code>coreaudio</code>, <code>wasapi</code>, <code>dummy</code>. Defaults to the first of these found on the system. Typically only required for Linux. output_device_name The name of the audio output device to use. This must precisely match the device's name in your system. If not found, <code>DeviceNotFoundException</code> is thrown when instantiating the graph. output_buffer_size The size of the hardware output audio buffer, in samples. A larger buffer reduces the chance of buffer overflows and glitches, but at the cost of higher latency. Note that this config option merely specifies the preferred output buffer size, which may not be available in the system hardware. To check the actual buffer size used by the AudioGraph, query <code>graph.output_buffer_size</code> after instantiation. input_device_name The name of the input device to use. input_buffer_size The size of the hardware input audio buffer. sample_rate The audio sample rate to use. cpu_usage_limit Imposes a hard limit on the CPU usage permitted by SignalFlow. If the estimated (single-core) CPU usage exceeds this value, no more nodes or patches can be created until it returns to below the limit. Floating-point value between 0..1, where 0.5 means 50% CPU."},{"location":"graph/config/#configuring-the-graph-programmatically","title":"Configuring the graph programmatically","text":"<p>To specify an alternative config, create and populate an <code>AudioGraphConfig</code> object before the graph is started:</p> <pre><code>config = AudioGraphConfig()\nconfig.output_device_name = \"MacBook Pro Speakers\"\nconfig.sample_rate = 44100\nconfig.output_buffer_size = 2048\n\ngraph = AudioGraph(config)\n</code></pre>"},{"location":"graph/config/#configuring-the-graph-via-signalflowconfig","title":"Configuring the graph via ~/.signalflow/config","text":"<p>To specify a configuration that is used by all future SignalFlow sessions, create a file <code>~/.signalflow/config</code>, containing one or more of the \"Graph configuration\" fields listed above.</p> <p>For example:</p> <pre><code>[audio]\nsample_rate = 48000\noutput_buffer_size = 256\ninput_buffer_size = 256\noutput_device_name = \"MacBook Pro Speakers\"\ninput_device_name = \"MacBook Pro Microphone\"\n</code></pre> <p>All fields are optional.</p> <p>A quick and easy way to edit your config, or create a new config file, is by using the <code>signalflow</code> command-line utility:</p> <pre><code>signalflow configure\n</code></pre> <p>This will use your default <code>$EDITOR</code> to open the configuration, or <code>pico</code> if no editor is specified.</p>"},{"location":"graph/config/#configuring-the-graph-via-environmental-variables","title":"Configuring the graph via environmental variables","text":"<p>SignalFlow config can also be set by setting an environmental variable in your shell. Variable names are identical to the upper-case version of the config string, prefixed with <code>SIGNALFLOW_</code>. For example:</p> <pre><code>export SIGNALFLOW_OUTPUT_DEVICE_NAME=\"MacBook Pro Speakers\"\nexport SIGNALFLOW_OUTPUT_BUFFER_SIZE=1024\n</code></pre>"},{"location":"graph/config/#printing-the-current-config","title":"Printing the current config","text":"<p>To print the current configuration to stdout:</p> <pre><code>graph.config.print()\n</code></pre> <p>\u2192 Next: Graph status and properties</p>"},{"location":"graph/creating/","title":"The AudioGraph","text":""},{"location":"graph/creating/#creating-the-graph","title":"Creating the graph","text":"<p>Creating the graph is simple: <code>graph = AudioGraph()</code></p> <p>By default, a new <code>AudioGraph</code> immediately connects to the system's default audio hardware device (via the integrated <code>libsoundio</code> library), using the system's default sample rate and buffer size.</p> <p>Info</p> <p>Note that the AudioGraph is a singleton object: only one AudioGraph can be created, which is shared globally.</p> <p>To prevent the graph from starting instantly (for example, if you want to use the graph in offline mode), pass <code>start=False</code> to the constructor.</p> <p>To configure graph playback or recording parameters, see AudioGraph: Configuration.</p> <p>\u2192 Next: Graph configuration</p>"},{"location":"graph/properties/","title":"The AudioGraph","text":""},{"location":"graph/properties/#status-and-properties","title":"Status and properties","text":"<p>A number of methods are provided to query the graph's current status and properties.</p>"},{"location":"graph/properties/#status","title":"Status","text":"<p>Querying <code>graph.status</code> returns a one-line description of the number of nodes and patches in the graph, and the estimated CPU and RAM usage:</p> <pre><code>&gt;&gt;&gt; graph.status\nAudioGraph: 235 active nodes, 6 patches, 13.95% CPU usage, 34.91MB memory usage\n</code></pre> <p>To automatically poll and print the graph's status periodically, call <code>graph.poll(interval)</code>, where <code>interval</code> is in seconds:</p> <pre><code>&gt;&gt;&gt; graph.poll(1)\nAudioGraph: 118 active nodes, 3 patches, 7.09% CPU usage, 34.91MB memory usage\nAudioGraph: 118 active nodes, 3 patches, 7.16% CPU usage, 34.91MB memory usage\nAudioGraph: 40 active nodes, 1 patch, 2.60% CPU usage, 34.91MB memory usage\n</code></pre> <p>To stop polling, call <code>graph.poll(0)</code>.</p>"},{"location":"graph/properties/#structure","title":"Structure","text":"<p>Querying <code>graph.structure</code> returns a multi-line string describing every Node in the graph, their parameter values, and their connectivity structure.</p> <pre><code>&gt;&gt;&gt; graph.structure\n * audioout-soundio\n   input0:\n    * linear-panner\n      pan: 0.000000\n      input:\n       * multiply\n         input1: 0.251189\n         input0:\n          * sine\n            frequency: 440.000000\n</code></pre>"},{"location":"graph/properties/#other-graph-properties","title":"Other graph properties","text":"<ul> <li><code>graph.node_count</code> (int): Returns the current number of Nodes in the graph (including within patches)</li> <li><code>graph.patch_count</code> (int): Returns the current number of Patches in the graph</li> <li><code>cpu_usage</code> (float): Returns the current CPU usage, between 0.0 (0%) and 1.0 (100%). CPU usage can be lowered by increasing the output buffer size.</li> <li><code>memory_usage</code> (int): Returns the current RAM usage, in bytes. This is typically mostly used by waveform data in Buffers.</li> <li><code>num_output_channels</code> (int): Returns the graph's current output channel count, which is typically identical to the number of channels supported by the audio output device.</li> <li><code>output_buffer_size</code> (int): Returns the current hardware output buffer size, in bytes.</li> </ul> <p>\u2192 Next: Recording graph output</p>"},{"location":"graph/recording/","title":"The AudioGraph","text":""},{"location":"graph/recording/#recording-the-audio-output-of-the-graph","title":"Recording the audio output of the graph","text":"<p>Convenience methods are provided to make it easy to record the global audio output when rendering audio in real-time:</p> <pre><code>graph.start_recording(\"filename.wav\")\n...\ngraph.stop_recording()\n</code></pre> <p>To record output in formats other than the default stereo, <code>start_recording</code> takes a <code>num_channels</code> argument that can be used to specify an alternative channel count.</p> <p>Note</p> <p>At present, only .wav is supported as an output format for global audio recordings. </p>"},{"location":"graph/recording/#offline-non-real-time-rendering","title":"Offline (non-real-time) rendering","text":"<p>It is also possible to perform non-real-time rendering of a synthesis graph,  by synthesizing audio output to a <code>Buffer</code> which can then be saved to disk:   </p> <pre><code># Create an AudioGraph with a dummy output device\ngraph = AudioGraph(output_device=AudioOut_Dummy(2))\n\n# Create a buffer that will be used to store the audio output\nbuffer = Buffer(2, graph.sample_rate * 4)\n\n# Create a synthesis graph to render\nfreq = SawLFO(1, 200, 400)\nsine = SineOscillator([freq, freq+10])\ngraph.play(sine)\n\n# Render to the buffer. Non-real-time, so happens instantaneously.\n# Note that the graph renders as many samples as needed to fill the buffer.\ngraph.render_to_buffer(buffer)\n\n# Write the buffer contents to a file\nbuffer.save(\"output.wav\")\n\n# Finally, tear down the buffer\ngraph.destroy()\n</code></pre> <p>\u2192 Next: Clearing and stopping the graph</p>"},{"location":"graph/stopping/","title":"The AudioGraph","text":""},{"location":"graph/stopping/#clearing-and-stopping-the-graph","title":"Clearing and stopping the graph","text":"<p>To clear all nodes and patches from the graph but leave it running for further audio synthesis:</p> <pre><code>&gt;&gt;&gt; graph.clear()\n</code></pre> <p>To stop the graph and pause audio I/O:</p> <pre><code>&gt;&gt;&gt; graph.stop()\n</code></pre> <p>To permanently destroy the graph:</p> <pre><code>&gt;&gt;&gt; graph.destroy()\n</code></pre>"},{"location":"howto/","title":"Howto","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>Tutorials on common tasks with SignalFlow.</p>"},{"location":"howto/midi/","title":"Howto: MIDI control","text":""},{"location":"installation/","title":"Getting started","text":""},{"location":"installation/#requirements","title":"Requirements","text":"<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p>"},{"location":"installation/#installation","title":"Installation","text":""},{"location":"installation/#macos","title":"macOS","text":"<p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install from the command line</p> <p>If you're new to Python or getting started from scratch: </p> <p>macOS: Easy install with Visual Studio Code </p>"},{"location":"installation/#linux","title":"Linux","text":"<p>Linux: Install from the command line</p>"},{"location":"installation/#examples","title":"Examples","text":"<p>Several example scripts are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>"},{"location":"installation/command-line-generic/","title":"Command line generic","text":""},{"location":"installation/command-line-generic/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/command-line-generic/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/command-line-generic/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/command-line-generic/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/command-line-generic/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/linux/","title":"Getting started","text":""},{"location":"installation/linux/#requirements","title":"Requirements","text":"<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p> <p>Python 3.8 or above is required. On macOS, we recommend installing an up-to-date version of Python3 using Homebrew: <code>brew install python3</code>.</p>"},{"location":"installation/linux/#installation","title":"Installation","text":"<p>On macOS and Linux x86_64, SignalFlow can be installed using <code>pip</code>:</p> <pre><code>pip3 install signalflow \n</code></pre> <p>Verify that the installation has worked correctly by using the <code>signalflow</code> command-line tool to play a test tone through your default system audio output:</p> <pre><code>signalflow test\n</code></pre> <p>For more detailed installation information, including Windows install and compilation from source, see the README.</p>"},{"location":"installation/linux/#examples","title":"Examples","text":"<p>Several example scripts are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>"},{"location":"installation/next-steps/","title":"Next steps","text":""},{"location":"installation/next-steps/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/linux/command-line/","title":"SignalFlow: Command-line installation for Linux","text":"<p>SignalFlow currently supports Linux x86_64 and Raspberry Pi.</p> <p>These instructions assume you have a working version of Python 3.8+.</p>"},{"location":"installation/linux/command-line/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/linux/command-line/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/linux/command-line/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/linux/command-line/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/linux/command-line/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/linux/command-line/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/macos/command-line/","title":"SignalFlow: Command-line installation for macOS","text":"<p>These instructions assume you have a working version of Python 3.8+, installed either via Homebrew or from Python.org.</p>"},{"location":"installation/macos/command-line/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/macos/command-line/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/macos/command-line/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/macos/command-line/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/macos/command-line/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/macos/command-line/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/macos/easy/","title":"SignalFlow: Easy install for macOS","text":"<p>The simplest way to start exploring SignalFlow is with the free Visual Studio Code editor. Visual Studio Code can edit interactive \"Jupyter\" notebooks, which allow you to run and modify blocks of Python code in real-time, which is a great way to experiment live with audio synthesis.</p> <p>You'll only need to do this installation process once. Once setup, experimenting with SignalFlow is as simple as opening Visual Studio Code.  </p>"},{"location":"installation/macos/easy/#1-install-python","title":"1. Install Python","text":"<p>Download and install the latest version of Python (currently 3.12).</p> <p>Download Python</p>"},{"location":"installation/macos/easy/#2-download-and-install-visual-studio-code","title":"2. Download and install Visual Studio Code","text":"<p>Download and install the latest version of Visual Studio Code.</p> <p>Download Visual Studio Code</p> <p>Once installed, open <code>Applications</code> and run <code>Visual Studio Code</code>.</p>"},{"location":"installation/macos/easy/#3-install-the-python-and-jupyter-extensions","title":"3. Install the Python and Jupyter extensions","text":"<p>Visual Studio Code requires extensions to be installed to handle Python and Jupyter files.</p> <p>In Visual Studio Code, select the <code>Extensions</code> icon from in the far-left column (or press <code>\u21e7\u2318X</code>), and install the <code>Python</code> and <code>Jupyter</code> extensions by searching for their names and clicking \"Install\" on each.</p> <p>Once installation has finished, close the <code>Extensions</code> tab.</p>"},{"location":"installation/macos/easy/#4-create-a-new-workspace","title":"4. Create a new workspace","text":"<p>In Visual Studio code, create a new folder to contain your new SignalFlow project:</p> <ul> <li>Select <code>File \u2192 Open Folder...</code></li> <li>Select <code>New Folder</code>, and pick a name for your new project folder</li> </ul> <p>Where to put your workspace</p> <p>You can store your project workspace anywhere on your drive. The workspace can hold multiple notebooks, audio files, etc.</p> <p>Trusted workspaces</p> <p>If Visual Studio asks \"Do you trust the authors of the files in this folder?\", select \"Yes, I trust the authors\". This is a security mechanism to protect you against untrusted third-party code.</p>"},{"location":"installation/macos/easy/#5-create-a-notebook","title":"5. Create a notebook","text":"<p>Select <code>File \u2192 New File...</code> (<code>^\u2325\u2318N</code>), and select <code>Jupyter Notebook</code>. You should see the screen layout change to display an empty black text block (in Jupyter parlance, a \"cell\"). </p>"},{"location":"installation/macos/easy/#6-create-a-python-virtual-environment-to-use","title":"6. Create a Python virtual environment to use","text":"<p>Click the button marked <code>Select Kernel</code> in the top right. </p> <ul> <li>Select <code>Python Environments...</code></li> <li>Select <code>Create Python Environment</code></li> <li>Select <code>Venv</code></li> <li>Finally, select the version of Python you just installed (<code>3.12.x</code>).</li> </ul> <p>Visual Studio Code will launch into some activity, in which it is installing necessary libraries and creating a Python \"virtual environment\", which is an isolated area of the filesystem containing all of the packages needed for this working space. Working in different virtual environments for different projects is good practice to minimise the likelihood of conflicts and disruptions.</p> <p>When the setup is complete, the button in the top right should change to say <code>.venv (Python 3.12.x)</code>.</p> <p>Info</p> <p>New notebooks created within this workspace will share the same Python virtual environment.  </p>"},{"location":"installation/macos/easy/#7-install-signalflow","title":"7. Install SignalFlow","text":"<p>In the first block, copy and paste the below:</p> <pre><code>%pip install signalflow\n</code></pre> <p>To run the cell, press <code>^\u21b5</code> (control-enter). After a minute, you should see some output saying <code>Successfully installed signalflow</code>.</p> <p>You're now all set to start writing code!</p>"},{"location":"installation/macos/easy/#8-start-writing-code","title":"8. Start writing code","text":"<p>In a Jupyter interactive notebook, you can write and run multi-line blocks of Python code. Press <code>enter</code> to edit the cell, delete its contents, and paste the below.    </p> <pre><code>print(\"Hello\")\nprint(\"world!\")\n</code></pre> <p>Press <code>^\u21b5</code> (control-enter) to run the cell. You should see \"Hello world!\" appear below the cell. </p> <p>Keyboard shortcuts</p> <ul> <li>Navigate between cells with the arrow keys</li> <li>Press <code>enter</code> to begin editing a cell, and <code>escape</code> to end editing and move to select mode</li> <li>In select mode, use <code>b</code> to add a cell after the current cell, and <code>a</code> to add a cell before it </li> <li>To evaluate a cell and move on to the next cell, use <code>\u21e7\u21b5</code> (shift-enter)</li> </ul>"},{"location":"installation/macos/easy/#9-signalflow-import-the-library-and-start-audio-processing","title":"9. SignalFlow: Import the library and start audio processing","text":"<p>Clear the first cell, and replace it with:</p> <pre><code>from signalflow import *\n</code></pre> <p>Run the cell with <code>^\u21b5</code>. This command imports all of the SignalFlow commands and classes, and only needs to be run once per session.</p> <p>Create a new cell by pressing <code>b</code>, and in the new cell, run:</p> <pre><code>graph = AudioGraph()\n</code></pre> <p>This will create and start a new global audio processing graph, using the system's default audio output. You should see the name of the audio device printed to the notebook.</p> <p>This also needs to be run once per session. In fact, only one global <code>AudioGraph</code> object can be created.  </p>"},{"location":"installation/macos/easy/#10-signalflow-make-some-sound","title":"10. SignalFlow: Make some sound","text":"<p>We're finally ready to make some noise!</p> <p>In a new cell, copy and paste the below:</p> <pre><code>sine = SineOscillator(440)\npanner = StereoPanner(sine, 0.0)\noutput = panner * 0.1\noutput.play()\n</code></pre> <p>This will create a simple sine wave oscillator, pan it over a stereo pair, attenuate it, and play it from the system's audio output. Hopefully you should now hear a tone playing from your speaker or headphones.</p> <p>One of the benefits of coding interactively is that you can modify the parameters of a synthesis network while it is running. In a new cell, try modifying the <code>frequency</code> property of the oscillator:</p> <pre><code>sine.frequency = 880\n</code></pre> <p>You should hear it increase in pitch. Try changing the value to something different and re-running the cell.</p> <p>The <code>pan</code> property of <code>StereoPanner</code> controls its position in the stereo field from left to right, and can range from <code>-1</code> to <code>1</code>:</p> <pre><code>panner.pan = -1\n</code></pre> <p>Finally, to stop the playback:</p> <pre><code>output.stop()\n</code></pre>"},{"location":"installation/macos/easy/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"node/","title":"Nodes","text":"<p>A <code>Node</code> object is an audio processing unit that performs one single function. For example, a Node's role may be to synthesize a waveform, read from a buffer, or take two input Nodes and sum their values.</p> <ul> <li>Nodes are played and stopped by connecting them to the AudioGraph </li> <li>A node has one or more audio-rate inputs, which can be modulated by other nodes</li> <li>Some nodes can be triggered with trigger inputs \u2014 for example, to restart playback, or set the position of an envelope</li> <li>Some nodes can be used to play back the contents of buffer inputs, or can use buffer data as a source of modulation</li> <li>The output of multiple nodes can be combined and modulated with use of the standard Python operators (<code>+</code>, <code>-</code>, <code>*</code>, <code>%</code>, etc)</li> <li>The output of a node can be mono (single-channel) or multichannel</li> <li>A Node's status and output can be examined by querying its properties</li> <li>Some Nodes generate unpredictable stochastic output, which can be controlled via its internal random number generator </li> <li>Details of how to create a new Node type are detailed in Developing a new Node class</li> <li>For an overview of every type of Node available in SignalFlow, see the Node Reference Library</li> </ul> <p>\u2192 Next: Node playback</p>"},{"location":"node/developing/","title":"Nodes","text":""},{"location":"node/developing/#developing-new-node-classes","title":"Developing new Node classes","text":"<p>See CONTRIBUTING.md</p>"},{"location":"node/inputs/","title":"Nodes","text":""},{"location":"node/inputs/#node-inputs","title":"Node inputs","text":"<p>A node has three different classes of input:</p> <ul> <li>Audio-rate inputs: Takes the output of another node as an input, for continuous modulation of synthesis parameters</li> <li>Trigger inputs: Used to trigger discrete control events \u2014 for example, restarting buffer playback</li> <li>Buffer inputs: Used to pass the contents of an audio buffer to a node \u2014 for example, as a source of audio samples, or an envelope shape</li> </ul>"},{"location":"node/inputs/#audio-rate-inputs","title":"Audio-rate inputs","text":"<p>Virtually every node has one or more audio-rate inputs. Put simply, an audio-rate input is the output of another node. Let's look at a short example:</p> <pre><code>lfo = SineLFO()\nsignal = SquareOscillator(frequency=200, width=lfo)\n</code></pre> <p>In this case, we are passing the output of a <code>SineLFO</code> as the pulse width of a <code>SquareOscillator</code>. This is an audio-rate input.</p> <p>Although it's not obvious, the <code>frequency</code> parameter is also an audio-rate input. Any constant value (such as the <code>200</code> here) is behind the scenes implemented as a <code>Constant</code> node, which continuously outputs the value at an audio rate.</p> <p>All audio-rate inputs can be modified just like a normal Python property. For example:</p> <pre><code>signal.frequency = TriangleOscillator(0.5, 100, 1000)\n</code></pre>"},{"location":"node/inputs/#variable-input-nodes","title":"Variable input nodes","text":"<p>Some nodes have a variable number of inputs, which can change over the Node's lifetime. For example, <code>Sum()</code> takes an arbitrary number of input Nodes, and generates an output which is the sum of all of its inputs.</p> <p>For variable-input nodes such as this, audio-rate inputs are added with <code>add_input()</code>, and can be removed with <code>remove_input()</code>.</p> <pre><code>a = Constant(1)\nb = Constant(2)\nc = Constant(3)\nsum = Sum()\nsum.add_input(a)\nsum.add_input(b)\nsum.add_input(c)\n# sum will now generate an output of 6.0\n</code></pre> <p>It is possible to check whether a Node object takes variable inputs by querying <code>node.has_variable_inputs</code>.</p>"},{"location":"node/inputs/#triggers","title":"Triggers","text":"<p>When working with sequencing and timing, it is often useful be able to trigger discrete events within a node. This is where trigger inputs come in handy.</p> <p>There are two different ways to handle trigger inputs:</p> <ul> <li>by calling the <code>trigger()</code> method on a <code>Node</code></li> <li>by passing a Node to an input that corresponds to an audio-rate trigger</li> </ul>"},{"location":"node/inputs/#calling-trigger","title":"Calling trigger()","text":"<p>To generate trigger events at arbitrary times, call <code>node.trigger()</code>. For example:</p> <pre><code>freq_env = Line(10000, 100, 0.5)\nsine = SineOscillator(freq_env)\nsine.play()\nwhile True:\n    freq_env.trigger()\n    graph.wait(1)\n</code></pre> <p>This is useful because it can be done outside the audio thread. For example, <code>trigger()</code> could be called each time a MIDI note event is received. </p> <p>The <code>trigger()</code> method takes an optional <code>name</code> parameter, which is used by <code>Node</code> classes containing more than one type of trigger. This example uses the <code>set_position</code> trigger of <code>BufferPlayer</code> to seek to a new location in the sample every second. </p> <pre><code>buffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True)\nplayer.play()\nwhile True:\n    player.trigger(\"set_position\", random_uniform(0, buffer.duration))\n    graph.wait(1)\n</code></pre> <p>Note</p> <p>Because the <code>trigger</code> method happens outside the audio thread, it will take effect at the start of the next audio block. This means that, if you are running at 44.1kHz with an audio buffer size of 1024 samples, this could introduce a latency of up to <code>1024/44100 = 0.023s</code>.   For time-critical events like drum triggers, this can be minimised by reducing the hardware output buffer size.</p> <p>This constraint also means that only one event can be triggered per audio block. To trigger events at a faster rate than the hardware buffer size allows, see Audio-rate triggers below.  </p>"},{"location":"node/inputs/#audio-rate-triggers","title":"Audio-rate triggers","text":"<p>It is often desirable to trigger events using the audio-rate output of another Node object as a source of trigger events, to give sample-level precision in timing. Most nodes that support <code>trigger</code> inputs can also be triggered by a corresponding audio-rate input. </p> <p>Triggers happen at zero-crossings \u2014 that is, when the output of the node passes above zero (i.e., from <code>&lt;= 0</code> to <code>&gt;0</code>). For example, to create a clock with an oscillating tempo to re-trigger buffer playback: </p> <pre><code>clock = Impulse(SineLFO(0.2, 1, 10))\nbuffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True, clock=clock)\nplayer.play()\n</code></pre> <p>This can be used to your advantage with the boolean operator nodes. </p> <pre><code>on_the_right = MouseX() &gt; 0.5\nenvelope = ASREnvelope(0, 0, 0.5, clock=on_the_right)\nsquare = SquareOscillator(100)\noutput = envelope * square * 0.1\noutput.play()\n</code></pre> <p>TODO: Should the name of the trigger() event always be identical to the trigger input name? So <code>clock</code> for envelopes, buffer player, etc...?</p>"},{"location":"node/inputs/#buffer-inputs","title":"Buffer inputs","text":"<p>The third type of input supported by nodes is the buffer. Nodes often take buffer inputs as sources of audio samples. They are also useful as sources of envelope shape data (for example, to shape the grains of a Granulator), or general control data (for example, recording motion patterns from a <code>MouseX</code> input).</p> <pre><code>buffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True)\n</code></pre> <p>\u2192 Next: Operators</p>"},{"location":"node/library/","title":"Node reference library","text":""},{"location":"node/library/#analysis","title":"analysis","text":"<ul> <li>CrossCorrelate: CrossCorrelate <code>(input=nullptr, buffer=nullptr, hop_size=0)</code></li> <li>OnsetDetector: OnsetDetector <code>(input=0.0, threshold=2.0, min_interval=0.1)</code></li> <li>VampAnalysis: VampAnalysis <code>(input=0.0, plugin_id=\"vamp-example-plugins:spectralcentroid:linearcentroid\")</code></li> </ul>"},{"location":"node/library/#buffer","title":"buffer","text":"<ul> <li>BeatCutter: Cuts a buffer into segment_count segments, and stutters/jumps with the given probabilities. <code>(buffer=nullptr, segment_count=8, stutter_probability=0.0, stutter_count=1, jump_probability=0.0, duty_cycle=1.0, rate=1.0, segment_rate=1.0)</code></li> <li>BufferLooper: Read and write from a buffer concurrently, with controllable overdub. <code>(buffer=nullptr, input=0.0, feedback=0.0, loop_playback=false, loop_record=false)</code></li> <li>BufferPlayer: Plays the contents of the given buffer. start_time/end_time are in seconds. When a clock signal is receives, rewinds to the start_time. <code>(buffer=nullptr, rate=1.0, loop=0, start_time=nullptr, end_time=nullptr, clock=nullptr)</code></li> <li>BufferRecorder: Records the input to a buffer. feedback controls overdub. <code>(buffer=nullptr, input=0.0, feedback=0.0, loop=false)</code></li> <li>FeedbackBufferReader: Counterpart to FeedbackBufferWriter. <code>(buffer=nullptr)</code></li> <li>FeedbackBufferWriter: Counterpart to FeedbackBufferReader. <code>(buffer=nullptr, input=0.0, delay_time=0.1)</code></li> <li>GrainSegments: GrainSegments <code>(buffer=nullptr, clock=0, target=0, offsets={}, values={}, durations={})</code></li> <li>Granulator: Granulator. Generates a grain from the given buffer each time a clock signal is received, with the given duration/rate/pan parameters. The input buffer can be mono or stereo. <code>(buffer=nullptr, clock=0, pos=0, duration=0.1, pan=0.0, rate=1.0, max_grains=2048)</code></li> <li>SegmentPlayer: Trigger segments of a buffer at the given onset positions. <code>(buffer=nullptr, onsets={})</code></li> </ul>"},{"location":"node/library/#control","title":"control","text":"<ul> <li>MouseX: Outputs the normalised cursor X position, from 0 to 1. <code>()</code></li> <li>MouseY: Outputs the normalised cursor Y position, from 0 to 1. <code>()</code></li> <li>MouseDown: Outputs 1 if the left mouse button is down, 0 otherwise. <code>(button_index=0)</code></li> </ul>"},{"location":"node/library/#envelope","title":"envelope","text":"<ul> <li>ADSREnvelope: Attack-decay-sustain-release envelope. Sustain portion is held until gate is zero. <code>(attack=0.1, decay=0.1, sustain=0.5, release=0.1, gate=0)</code></li> <li>ASREnvelope: Attack-sustain-release envelope. <code>(attack=0.1, sustain=0.5, release=0.1, curve=1.0, clock=nullptr)</code></li> <li>DetectSilence: Detects blocks of silence below the threshold value. Used as an auto-free node to terminate a Patch after processing is complete. <code>(input=nullptr, threshold=0.00001)</code></li> <li>Envelope: Generic envelope constructor, given an array of levels, times and curves. <code>(levels=std::vector&lt;NodeRef&gt; ( ), times=std::vector&lt;NodeRef&gt; ( ), curves=std::vector&lt;NodeRef&gt; ( ), clock=nullptr, loop=false)</code></li> <li>Line: Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal. <code>(from=0.0, to=1.0, time=1.0, loop=0, clock=nullptr)</code></li> <li>RectangularEnvelope: Rectangular envelope with the given sustain duration. <code>(sustain_duration=1.0, clock=nullptr)</code></li> </ul>"},{"location":"node/library/#fft","title":"fft","text":"<ul> <li>FFTContinuousPhaseVocoder: FFTContinuousPhaseVocoder <code>(input=nullptr, rate=1.0)</code></li> <li>FFTConvolve: FFTConvolve <code>(input=nullptr, buffer=nullptr)</code></li> <li>FFT: FFT <code>(input=0.0, fft_size=SIGNALFLOW_DEFAULT_FFT_SIZE, hop_size=SIGNALFLOW_DEFAULT_FFT_HOP_SIZE, window_size=0, do_window=true)</code></li> <li>FFTNode: FFTNode <code>(fft_size=None, hop_size=None, window_size=None, do_window=None)</code></li> <li>FFTOpNode: FFTOpNode <code>(input=nullptr)</code></li> <li>FFTFindPeaks: FFTFindPeaks <code>(input=0, prominence=1, threshold=0.000001, count=SIGNALFLOW_MAX_CHANNELS, interpolate=true)</code></li> <li>IFFT: IFFT <code>(input=nullptr, do_window=false)</code></li> <li>FFTLPF: FFTLPF <code>(input=0, frequency=2000)</code></li> <li>FFTNoiseGate: FFTNoiseGate <code>(input=0, threshold=0.5)</code></li> <li>FFTPhaseVocoder: FFTPhaseVocoder <code>(input=nullptr)</code></li> <li>FFTTonality: FFTTonality <code>(input=0, level=0.5, smoothing=0.9)</code></li> <li>FFTZeroPhase: FFTZeroPhase <code>(input=0)</code></li> </ul>"},{"location":"node/library/#operators","title":"operators","text":"<ul> <li>Add: Add <code>(a=0, b=0)</code></li> <li>AmplitudeToDecibels: AmplitudeToDecibels <code>(a=0)</code></li> <li>DecibelsToAmplitude: DecibelsToAmplitude <code>(a=0)</code></li> <li>ChannelArray: Takes an array of inputs and spreads them across multiple channels of output. <code>()</code></li> <li>ChannelCrossfade: Given a multichannel input, crossfades between channels based on the given position within the virtual array, producing a single-channel output. <code>(input=nullptr, index=nullptr, num_output_channels=1)</code></li> <li>ChannelMixer: Downmix a multichannel input to a lower-channel output. If num_channels is greater than one, spreads the input channels across the field. If amplitude_compensation is enabled, scale down the amplitude based on the ratio of input to output channels. <code>(num_channels=1, input=0, amplitude_compensation=true)</code></li> <li>ChannelSelect: Select a subset of channels from a multichannel input, starting at offset, up to a maximum of maximum, with the given step. <code>(input=nullptr, offset=0, maximum=0, step=1)</code></li> <li>Equal: Equal <code>(a=0, b=0)</code></li> <li>NotEqual: NotEqual <code>(a=0, b=0)</code></li> <li>GreaterThan: GreaterThan <code>(a=0, b=0)</code></li> <li>GreaterThanOrEqual: GreaterThanOrEqual <code>(a=0, b=0)</code></li> <li>LessThan: LessThan <code>(a=0, b=0)</code></li> <li>LessThanOrEqual: LessThanOrEqual <code>(a=0, b=0)</code></li> <li>Modulo: Modulo <code>(a=0, b=0)</code></li> <li>Abs: Abs <code>(a=0)</code></li> <li>If: If <code>(a=0, value_if_true=0, value_if_false=0)</code></li> <li>Divide: Divide <code>(a=1, b=1)</code></li> <li>FrequencyToMidiNote: Map a frequency to a MIDI note (where 440Hz = A4 = 69), with floating-point output. <code>(a=0)</code></li> <li>MidiNoteToFrequency: Map a MIDI note to a frequency (where 440Hz = A4 = 69), supporting floating-point input. <code>(a=0)</code></li> <li>Multiply: Multiply <code>(a=1.0, b=1.0)</code></li> <li>Pow: Pow <code>(a=0, b=0)</code></li> <li>RoundToScale: Given a frequency input, generates a frequency output that is rounded to the nearest MIDI note. (TODO: Not very well named) <code>(a=0)</code></li> <li>Round: Round the input to the nearest integer value. <code>(a=0)</code></li> <li>ScaleLinExp: Scales the input from a linear range (between a and b) to an exponential range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li> <li>ScaleLinLin: Scales the input from a linear range (between a and b) to a linear range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li> <li>Subtract: Subtract <code>(a=0, b=0)</code></li> <li>Sum: Sum <code>()</code></li> <li>Sin: Sin <code>(a=0)</code></li> <li>Cos: Cos <code>(a=0)</code></li> <li>Tan: Tan <code>(a=0)</code></li> <li>Tanh: Tanh <code>(a=0)</code></li> </ul>"},{"location":"node/library/#oscillators","title":"oscillators","text":"<ul> <li>Constant: Produces a constant value. <code>(value=0)</code></li> <li>Impulse: Produces a value of 1 at the given frequency, with output of 0 at all other times. If frequency is 0, produces a single impulse. <code>(frequency=1.0)</code></li> <li>LFO: LFO <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SawLFO: Produces a sawtooth LFO, with output ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SawOscillator: Produces a (non-band-limited) sawtooth wave, with the given frequency and phase offset. When a reset or trigger is received, resets the phase to zero. <code>(frequency=440, phase=nullptr, reset=nullptr)</code></li> <li>SineLFO: Produces a sinusoidal LFO at the given frequency and phase offset, with output ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SineOscillator: Produces a sine wave at the given frequency. <code>(frequency=440)</code></li> <li>SquareLFO: Produces a pulse wave LFO with the given frequency and pulse width, ranging from min to max, where width=0.5 is a square wave. <code>(frequency=1.0, min=0.0, max=1.0, width=0.5, phase=0.0)</code></li> <li>SquareOscillator: Produces a pulse wave with the given frequency and pulse width, where width=0.5 is a square wave. <code>(frequency=440, width=0.5)</code></li> <li>TriangleLFO: Produces a triangle LFO with the given frequency, ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>TriangleOscillator: TriangleOscillator <code>(frequency=440)</code></li> <li>Wavetable: Plays the wavetable stored in buffer at the given frequency. <code>(buffer=nullptr, frequency=440, phase=0, sync=0, phase_map=nullptr)</code></li> <li>Wavetable2D: Wavetable2D <code>(buffer=nullptr, frequency=440, crossfade=0.0, phase=0.0, sync=0)</code></li> </ul>"},{"location":"node/library/#processors","title":"processors","text":"<ul> <li>Clip: Clip the input to min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> <li>Fold: Fold the input beyond min/max, reflecting the excess back. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> <li>Smooth: Smooth the input with a given smoothing coefficient. When smooth = 0, applies no smoothing. <code>(input=nullptr, smooth=0.99)</code></li> <li>WetDry: Takes wet and dry inputs, and outputs a mix determined by wetness. <code>(dry_input=nullptr, wet_input=nullptr, wetness=0.0)</code></li> <li>Wrap: Wrap the input beyond min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> </ul>"},{"location":"node/library/#processorsdelays","title":"processors/delays","text":"<ul> <li>AllpassDelay: All-pass delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li> <li>CombDelay: Comb delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li> <li>OneTapDelay: Single-tap delay line. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, max_delay_time=0.5)</code></li> <li>Stutter: Stutters the input whenever a signal is received on clock. Generates stutter_count repeats, with duration stutter_time. <code>(input=0.0, stutter_time=0.1, stutter_count=1, clock=nullptr, max_stutter_time=1.0)</code></li> </ul>"},{"location":"node/library/#processorsdistortion","title":"processors/distortion","text":"<ul> <li>Resample: Resampler and bit crusher. sample_rate is in Hz, bit_rate is an integer between 0 and 16. <code>(input=0, sample_rate=44100, bit_rate=16)</code></li> <li>SampleAndHold: Samples and holds the input each time a clock signal is received. <code>(input=nullptr, clock=nullptr)</code></li> <li>Squiz: Implementation of Dan Stowell's Squiz algorithm, a kind of downsampler. <code>(input=0.0, rate=2.0, chunk_size=1)</code></li> <li>WaveShaper: Applies wave-shaping as described in buffer. <code>(input=0.0, buffer=nullptr)</code></li> </ul>"},{"location":"node/library/#processorsdynamics","title":"processors/dynamics","text":"<ul> <li>Compressor: Dynamic range compression, with optional sidechain input. <code>(input=0.0, threshold=0.1, ratio=2, attack_time=0.01, release_time=0.1, sidechain=nullptr)</code></li> <li>Gate: Outputs the input value when it is above the given threshold, otherwise zero. <code>(input=0.0, threshold=0.1)</code></li> <li>Maximiser: Gain maximiser. <code>(input=0.0, ceiling=0.5, attack_time=1.0, release_time=1.0)</code></li> <li>RMS: Outputs the root-mean-squared value of the input, in buffers equal to the graph's current buffer size. <code>(input=0.0)</code></li> </ul>"},{"location":"node/library/#processorsfilters","title":"processors/filters","text":"<ul> <li>BiquadFilter: Biquad filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. Not recommended for real-time modulation; for this, use SVFilter. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0, peak_gain=0.0)</code></li> <li>EQ: Three-band EQ. <code>(input=0.0, low_gain=1.0, mid_gain=1.0, high_gain=1.0, low_freq=500, high_freq=5000)</code></li> <li>MoogVCF: Moog ladder low-pass filter. <code>(input=0.0, cutoff=200.0, resonance=0.0)</code></li> <li>SVFilter: State variable filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0)</code></li> </ul>"},{"location":"node/library/#processorspanning","title":"processors/panning","text":"<ul> <li>AzimuthPanner: Pan input around an equally-spaced ring of num_channels speakers. pan is the pan position from -1..+1, where 0 = centre front. width is the source's width, where 1.0 spans exactly between an adjacent pair of channels. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li> <li>ChannelPanner: Pan the input between a linear series of channels, where pan 0 = channel 0, 1 = channel 1, etc. No wrapping is applied. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li> <li>SpatialPanner: Implements a spatial panning algorithm, applied to a given SpatialEnvironment. Currently, only DBAP is supported. <code>(env=nullptr, input=0.0, x=0.0, y=0.0, z=0.0, radius=1.0, algorithm=\"dbap\")</code></li> <li>StereoBalance: Takes a stereo input and rebalances it, where 0 is unchanged, -1 is hard left, and 1 is hard right. <code>(input=0, balance=0)</code></li> <li>StereoPanner: Pans a mono input to a stereo output. Pans from -1 (hard left) to +1 (hard right), with 0 = centre. <code>(input=0, pan=0.0)</code></li> <li>StereoWidth: Reduces the width of a stereo signal. When width = 1, input is unchanged. When width = 0, outputs a pair of identical channels both containing L+R. <code>(input=0, width=1)</code></li> </ul>"},{"location":"node/library/#sequencing","title":"sequencing","text":"<ul> <li>ClockDivider: When given a clock input (e.g., an Impulse), divides the clock by the given factor. factor must be an integer greater than or equal to 1. <code>(clock=0, factor=1)</code></li> <li>Counter: Count upwards from min, driven by clock. <code>(clock=0, min=0, max=2147483647)</code></li> <li>Euclidean: Euclidean rhythm as described by Toussaint, with sequence_length (n) and num_events (k), driven by clock. <code>(clock=0, sequence_length=0, num_events=0)</code></li> <li>FlipFlop: Flips from 0/1 on each clock. <code>(clock=0)</code></li> <li>ImpulseSequence: Each time a clock or trigger is received, outputs the next value in the sequence. At all other times, outputs zero. <code>(sequence=std::vector&lt;int&gt; ( ), clock=nullptr)</code></li> <li>Index: Outputs the value in list corresponding to index. <code>(list={}, index=0)</code></li> <li>Latch: Initially outputs 0. When a trigger is received at set, outputs 1. When a trigger is subsequently received at reset, outputs 0, until the next set. <code>(set=0, reset=0)</code></li> <li>Sequence: Outputs the elements in sequence, incrementing position on each clock. <code>(sequence=std::vector&lt;float&gt; ( ), clock=nullptr)</code></li> </ul>"},{"location":"node/library/#stochastic","title":"stochastic","text":"<ul> <li>Logistic: Logistic noise. <code>(chaos=3.7, frequency=0.0)</code></li> <li>PinkNoise: Pink noise, with specified low/high cutoffs. <code>(low_cutoff=20.0, high_cutoff=20000.0, reset=nullptr)</code></li> <li>RandomBrownian: Outputs Brownian noise between min/max, with a mean change of delta between samples. If a clock is passed, only generates a new value on a clock tick. <code>(min=-1.0, max=1.0, delta=0.01, clock=nullptr, reset=nullptr)</code></li> <li>RandomChoice: Pick a random value from the given array. If a clock is passed, only picks a new value on a clock tick. <code>(values=std::vector&lt;float&gt; ( ), clock=nullptr, reset=nullptr)</code></li> <li>RandomCoin: Flip a coin with the given probability. If a clock is passed, only picks a new value on a clock tick. <code>(probability=0.5, clock=nullptr, reset=nullptr)</code></li> <li>RandomExponentialDist: Generate an random value following the exponential distribution. If a clock is passed, only picks a new value on a clock tick. <code>(scale=0.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomExponential: Generate an random exponential value between min/max. If a clock is passed, only picks a new value on a clock tick. <code>(min=0.001, max=1.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomGaussian: Generate an random Gaussian value, with given mean and sigma. If a clock is passed, only picks a new value on a clock tick. <code>(mean=0.0, sigma=0.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomImpulseSequence: Generates a random sequence of 0/1 bits with the given length, and the given probability each each bit = 1. The position of the sequence is incremented on each clock signal. explore and generate are trigger inputs which cause the sequence to mutate and re-generate respectively. <code>(probability=0.5, length=8, clock=nullptr, explore=nullptr, generate=nullptr, reset=nullptr)</code></li> <li>RandomImpulse: Generate random impulses at the given frequency, with either uniform or poisson distribution. <code>(frequency=1.0, distribution=SIGNALFLOW_EVENT_DISTRIBUTION_UNIFORM, reset=nullptr)</code></li> <li>RandomUniform: Generates a uniformly random value between min/max. If a clock is passed, only picks a new value on a clock tick. <code>(min=0.0, max=1.0, clock=nullptr, reset=nullptr)</code></li> <li>StochasticNode: StochasticNode <code>(reset=nullptr)</code></li> <li>WhiteNoise: Generates whitenoise between min/max. If frequency is zero, generates at audio rate. For frequencies lower than audio rate, interpolate applies linear interpolation between values, and random_interval specifies whether new random values should be equally-spaced or randomly-spaced. <code>(frequency=0.0, min=-1.0, max=1.0, interpolate=true, random_interval=true, reset=nullptr)</code></li> </ul>"},{"location":"node/multichannel/","title":"Nodes","text":""},{"location":"node/multichannel/#multichannel-nodes","title":"Multichannel nodes","text":"<p>When passing a value to audio-rate input of a Node, the signal is by default monophonic (single-channel). For example, <code>SquareOscillator(440)</code> generates a 1-channel output.</p> <p>It is possible to generate multi-channel output by passing an array of values in the place of a constant. For example, <code>SquareOscillator([440, 880])</code> generates stereo output with a different frequency in the L and R channels. </p> <p>There is no limit to the number of channels that can be generated by a node. For example, <code>SquareOscillator(list(100 + 50 * n for n in range(100)))</code> will create a node with 100-channel output, each with its own frequency. </p> <pre><code>&gt;&gt;&gt; sq = SquareOscillator([100 + 50 * n for n in range(100)])\n&gt;&gt;&gt; print(sq.num_output_channels)\n100\n</code></pre>"},{"location":"node/multichannel/#automatic-upmixing","title":"Automatic upmixing","text":"<p>There are generally multiple inputs connected to a node, which may themselves have differing number of channels. For example, <code>SquareOscillator(frequency=[100, 200, 300, 400, 500], width=0.7)</code> has a 5-channel input and a 1-channel input. In cases like this, the output of the nodes with fewer channels is upmixed to match the higher-channel inputs.</p> <p>Upmixing here means simply duplicating the output until it reaches the desired number of channels. In the above case, the <code>width</code> input will be upmixed to generate 5 channels, all containing <code>0.7</code>.</p> <p>If <code>width</code> were a stereo input with L and R channels, the output would be tiled, alternating between the channels. Each frame of stereo input would then be upmixed to contain <code>[L, R, L, R, L]</code>, where <code>L</code> and <code>R</code> are the samples corresponding to the L and R channels.</p> <p>The key rule is that, for nodes that support upmixing, the output signal has as many channels as the input signal with the highest channel count. </p> <p>This process percolates through the signal chain. For example:</p> <pre><code>SquareOscillator(frequency=SineLFO([1, 3, 5], min=440, max=880),\n                 width=SawLFO([0.5, 0.6], min=0.25, max=0.75))\n</code></pre> <ul> <li>The <code>min</code> and <code>max</code> inputs of the <code>frequency</code> LFO would be upmixed to 3 channels each</li> <li>The <code>min</code> and <code>max</code> inputs of the <code>width</code> LFO would be upmixed to 2 channels each</li> <li>Then, the output of the <code>width</code> node would be upmixed from 2 to 3 channels</li> </ul>"},{"location":"node/multichannel/#nodes-with-fixed-inputoutput-channels","title":"Nodes with fixed input/output channels","text":"<p>Some nodes have immutable numbers of input/output channels. For example:</p> <ul> <li><code>StereoPanner</code> has 1 input channel and 2 output channels</li> <li><code>StereoBalance</code> has 2 input channels and 2 output channels</li> <li><code>ChannelMixer</code> has an arbitrary number of input channels, but a fixed, user-specified number of output channels</li> </ul> <p>Even Nodes that do not have an obvious input (e.g. <code>BufferPlayer</code>) have input channels, for modulation inputs (for example, modulating the rate of the buffer).</p> <p>When two nodes are connected together with incompatible channel counts (for example, connecting a <code>StereoBalance</code> into a <code>StereoMixer</code>), an <code>InvalidChannelCountException</code> will be raised.</p>"},{"location":"node/multichannel/#the-channel-node-classes","title":"The Channel* node classes","text":"<p>There are a number of Node subclasses dedicated to channel handling.</p> <ul> <li>ChannelArray: Concatenates the channels of multiple nodes, so that calling <code>ChannelMix</code> with nodes of <code>N</code> and <code>M</code> channels will produce an output of <code>N + M</code> channels.</li> <li>ChannelMixer: Reduces or expands the number of channels by evenly spreading the audio across the output channels.</li> <li>ChannelSelect: Selects sub-channels of the input, either individually or by group. </li> </ul>"},{"location":"node/multichannel/#querying-channel-subsets-with-the-index-operator","title":"Querying channel subsets with the index operator","text":"<p>Single channels of a multi-channel node can be accessed using the index <code>[]</code> operator. For example:</p> <pre><code>square = SquareOscillator([440, 441, 442, 443])\noutput = square[0]\n# output now contains a mono output, with a frequency of 440Hz.\n</code></pre> <p>Slice syntax can be used to query multiple subchannels:</p> <pre><code>square = SquareOscillator([440, 441, 442, 880])\noutput = square[0:2]\n# now contains a two-channel square wave\n</code></pre> <p>\u2192 Next: Status and properties</p>"},{"location":"node/operators/","title":"Nodes","text":""},{"location":"node/operators/#node-operators","title":"Node operators","text":""},{"location":"node/operators/#arithmetic","title":"Arithmetic","text":"<p>The output of multiple nodes can be combined using Python's mathematical operators. For example, to sum two sine waves together to create harmonics, use the <code>+</code> operator:</p> <pre><code>output = SineOscillator(440) + SineOscillator(880)\noutput.play()\n</code></pre> <p>To modulate the amplitude of one node with another, use the <code>*</code> operator:</p> <pre><code>sine = SineOscillator(440)\nenvelope = ASREnvelope(0.1, 1, 0.1)\noutput = sine * envelope\n</code></pre> <p>You can use constant values in place of <code>Node</code> objects:</p> <pre><code>sine = SineOscillator(440)\nattenuated = sine * 0.5\n</code></pre> <p>Operators can be chained together in the normal way:</p> <pre><code># Create an envelope that rises from 0.5 to 1.0 and back to 0.5\nenv = (ASREnvelope(0.1, 1, 0.1) * 0.5) + 0.5\n</code></pre> <p>Behind the scenes, these operators are actually creating composites of <code>Node</code> subclasses. The last example could alternatively be written as:</p> <pre><code>Add(Multiply(ASREnvelope(0.1, 1, 0.1), 0.5), 0.5)\n</code></pre>"},{"location":"node/operators/#comparison","title":"Comparison","text":"<p>Comparison operators can also be used to compare two Node output values, generating a binary (1/0) output. For example:</p> <pre><code># Generates an output of 1 when the sinusoid is above 0, and 0 otherwise \nSineOscillator(440) &gt; 0\n</code></pre> <p>This can then be used as an input to other nodes. The below will generate a half-wave-rectified sine signal (that is, a sine wave with all negative values set to zero). </p> <pre><code>sine = SineOscillator(440)\nrectified = sine * (sine &gt; 0)\n</code></pre>"},{"location":"node/operators/#index-of-operators","title":"Index of operators","text":"<p>Below is a full list of operators supported by SignalFlow.</p>"},{"location":"node/operators/#arithmetic-operators","title":"Arithmetic operators","text":"Operator Node class <code>+</code> Add <code>-</code> Subtract <code>*</code> Multiply <code>/</code> Divide <code>**</code> Power <code>%</code> Modulo"},{"location":"node/operators/#comparison-operators","title":"Comparison operators","text":"Operator Node class <code>==</code> Equal <code>!=</code> NotEqual <code>&lt;</code> LessThan <code>&lt;=</code> LessThanOrEqual <code>&gt;</code> GreaterThan <code>&gt;=</code> GreaterThanOrEqual <p>\u2192 Next: Multichannel</p>"},{"location":"node/playback/","title":"Nodes","text":""},{"location":"node/playback/#playing-and-stopping-a-node","title":"Playing and stopping a node","text":""},{"location":"node/playback/#starting-playback","title":"Starting playback","text":"<p>To start a node playing, simply call the <code>play()</code> method:</p> <pre><code>graph = AudioGraph()\nnode = SineOscillator(440)\nnode.play()\n</code></pre> <p>This connects the node to the <code>output</code> endpoint of the current global <code>AudioGraph</code>. The next time the graph processes a block of samples, the graph's <code>output</code> node then calls upon the sine oscillator to generate a block.</p> <p>It is important to remember that playing a node means \"connecting it to the graph\". For this reason, it is not possible to play the same node more than once, as it is already connected to the graph. To play multiples of a particular Node type, simply create and play multiple instances.</p>"},{"location":"node/playback/#connecting-a-node-to-another-nodes-input","title":"Connecting a Node to another Node's input","text":"<p>It is often the case that you want to connect a Node to the input of another Node for playback, rather than simply wiring it to the output of a graph -- for example, to pass an oscillator through a processor. In this case, you do not need to call <code>play()</code> (which means \"connect this node to the graph\"). Instead, it is sufficient to simply connect the Node to the input of another Node that is already playing.</p> <p>For example:</p> <pre><code># create and begin playback of a variable input summer, passed through a filter\nsum = Sum()\nflt = SVFilter(sum, \"low_pass\", 200)\nflt.play()\n</code></pre> <p>Now, let's create an oscillator. Observe that connecting the oscillator to the filter's input begins playback immediately.</p> <pre><code>square = SquareOscillator(100)\nsum.add_input(square)\n</code></pre>"},{"location":"node/playback/#stopping-playback","title":"Stopping playback","text":"<p>To stop a node playing:</p> <pre><code>node.stop()\n</code></pre> <p>This disconnects the node from the output device that it is connected to. </p> <p>\u2192 Next: Inputs</p>"},{"location":"node/properties/","title":"Nodes","text":""},{"location":"node/properties/#node-properties","title":"Node properties","text":"<p>A <code>Node</code> has a number of read-only properties which can be used to query its status at a given moment in time.</p> Property Type Description name str Short alphanumeric string that identifies the type of node (for example, <code>asr-envelope</code>) num_output_channels int The number of output channels that the node generates. num_input_channels int The number of input channels that the node takes. Note that most nodes have <code>matches_input_channels</code> set, meaning that their <code>num_input_channels</code> will be automatically increased according to their inputs. To learn more, see Nodes: Multichannel. matches_input_channels bool Whether the node automatically increases its <code>num_input_channels</code> based on its inputs. To learn more, see Nodes: Multichannel. has_variable_inputs bool Whether the node supports an arbitrary number of audio-rate inputs output_buffer numpy.ndarray Contains the Node's most recent audio output, in <code>float32</code> samples. The buffer is indexed by <code>channel</code> x <code>frame</code>, so to obtain the 32nd sample in the first channel, query: <code>node.output_buffer[0][31]</code>. inputs dict A dict containing all of the <code>Node</code>'s audio-rate inputs. Note that buffer inputs are not currently included within this dict. state int The Node's current playback state, which can be one of <code>SIGNALFLOW_NODE_STATE_ACTIVE</code> and <code>SIGNALFLOW_NODE_STATE_STOPPED</code>. The <code>STOPPED</code> state only applies to those nodes which have a finite duration (e.g. <code>ASREnvelope</code>, or <code>BufferPlayer</code> with looping disabled) and have reached the end of playback. Nodes continue to have a state of <code>ACTIVE</code> whether or not they are connected to the graph. patch Patch Indicates the Patch that the node is part of, or None if the Node does not belong to a Patch."},{"location":"node/properties/#monitoring-a-nodes-output","title":"Monitoring a node's output","text":"<p>To monitor the output of a node, call <code>node.poll(num_seconds)</code>, where <code>num_seconds</code> is the interval between messages. This will print the last sample generated by the node to <code>stdout</code>. In the case of multichannel nodes, only the first channel's value is printed.</p> <pre><code>&gt;&gt;&gt; a = Counter(Impulse(1))\n&gt;&gt;&gt; a.poll(1)\n&gt;&gt;&gt; a.play()\ncounter: 0.00000\ncounter: 1.00000\ncounter: 2.00000\n</code></pre> <p>To stop polling a node, call <code>node.poll(0)</code>.</p>"},{"location":"node/properties/#node-specific-properties","title":"Node-specific properties","text":"<p>Some <code>Node</code> classes have additional properties, containing information on implementation-specific states. These can be accessed via the <code>get_property</code> method.</p> <p>For example, the <code>BufferPlayer</code> node exposes a <code>position</code> property, which returns the playhead's current position, in seconds.</p> <pre><code>&gt;&gt;&gt; buffer = Buffer(\"audio.wav\")\n&gt;&gt;&gt; player = BufferPlayer(buffer)\n&gt;&gt;&gt; player.play()\n...\n&gt;&gt;&gt; player.get_property(\"position\")\n5.984000205993652\n</code></pre> <p>\u2192 Next: Stochastic nodes</p>"},{"location":"node/stochastic/","title":"Nodes","text":""},{"location":"node/stochastic/#chance-and-stochastic-nodes","title":"Chance and stochastic nodes","text":"<p>SignalFlow has a number of stochastic nodes, which make use of a pseudo-random number generator (RNG) to produce unpredictable output values.</p> <p>Each object of these <code>StochasticNode</code> subclasses stores its own RNG. By default, the RNG is seeded with a random value, so that each run will generate a different set of outputs. However, to create a repeatable pseudo-random output, the <code>seed</code> of the node's RNG can be set to a known value:</p> <pre><code>&gt;&gt;&gt; r = RandomUniform(0, 1)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.48836085, 0.64326525, 0.79819506, 0.8489549 ], dtype=float32)\n&gt;&gt;&gt; r.set_seed(123)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.7129553 , 0.42847094, 0.6908848 , 0.7191503 ], dtype=float32)\n&gt;&gt;&gt; r.set_seed(123)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.7129553 , 0.42847094, 0.6908848 , 0.7191503 ], dtype=float32)\n</code></pre> <p>Note the identical sequences generated after repeatedly setting the seed to a known value. </p> <p>Warning</p> <p>Calling <code>node.process()</code> is generally not good practice, as it does not recursively process all of the node's inputs (unlike when a node is embedded within an AudioGraph, which correctly handles recursion and cyclical loops). Please use at your peril!</p> <p>\u2192 Next: Node reference library</p>"},{"location":"patch/","title":"Patch","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>A <code>Patch</code> represents a connected group of <code>Nodes</code>, analogous to a synthesizer. Defining patches makes it easy to create higher-level structures, which can then be reused and instantiated with a single line of code, in much the same way as a Node.</p> <p>Behind the scenes, the structure of a <code>Patch</code> is encapsulated by a <code>PatchSpec</code>, a template which can be instantiated or serialised to a JSON file for later use.  </p> <ul> <li>A Patch structure is defined either by declaring a Patch subclass or with a JSON specification file</li> <li>Play and stop a Patch by connecting it to the AudioGraph or the input of another Patch or Node </li> <li>Similar to nodes, a Patch can be modulated by audio-rate inputs, triggered by trigger inputs, and access sample data via buffer inputs </li> <li>The outputs of Patches can be altered or combined by normal Python operators</li> <li>The status of a Patch can be queried via its properties </li> <li>Patches can be exported and imported to JSON</li> <li>The auto-free mechanism allows Patches to automatically stop and free their memory after playback is complete </li> </ul> <p>\u2192 Next: Defining a Patch</p>"},{"location":"patch/auto-free/","title":"Patch","text":""},{"location":"patch/auto-free/#auto-free-and-memory-management","title":"Auto-free and memory management","text":"<p>Auto-free.</p>"},{"location":"patch/defining/","title":"Patch","text":""},{"location":"patch/defining/#defining-a-patch","title":"Defining a Patch","text":"<p>A Patch is made up of a connected network of Nodes, together with a set of properties that determine how the Patch can be controlled.</p> <p>There are two general ways to define the structure of a Patch:</p> <ul> <li>Create a new class that subclasses <code>Patch</code>. In general, this is the recommended approach for defining new Patches.</li> <li>Create a JSON file that can be loaded as a <code>PatchSpec</code>, which describes the structure of a patch </li> </ul>"},{"location":"patch/defining/#creating-a-patch-subclass","title":"Creating a Patch subclass","text":"<p>The quickest and most intuitive way to define a <code>Patch</code> is by subclassing the <code>Patch</code> class itself. Let's look at an example.</p> <pre><code>class Bleep (Patch):\n    def __init__(self, frequency=880, duration=0.1):\n        super().__init__()\n        frequency = self.add_input(\"frequency\", frequency)\n        duration = self.add_input(\"duration\", duration)\n        sine = SineOscillator(frequency)\n        env = ASREnvelope(0.001, duration, 0.001)\n        output = sine * env\n        self.set_output(output)\n        self.set_auto_free(True)\n</code></pre> <p>In the above example:</p> <ul> <li>At the very start of the <code>__init__</code> function, <code>super().__init__()</code> must be called to initialise the Patch and its storage. This is vital! Without it, your program will crash. </li> <li>Two audio-rate input parameters are defined. The <code>add_input()</code> method is used to define them as inputs of the <code>Patch</code>, which can then be subsequently modulated. Note that the <code>add_input()</code> method returns a reference to the frequency node, which then acts as a pointer to the input node.</li> <li><code>self.set_output()</code> is used to define the Patch's output. A Patch can only have one single output.</li> <li>Finally, <code>self.set_auto_free()</code> is used to automatically stop and free the Patch after playback of the envelope is completed. More about auto-free... </li> </ul> <p>You can now instantiate a <code>Bleep</code> object in just the same way as you would instantiate and play a Node:</p> <pre><code>b = Bleep(frequency=440, duration=0.2)\nb.play()\n</code></pre> <p>If you query <code>graph.status</code> after playback has finished, you should see that the <code>Patch</code> is automatically freed and the number of nodes returns to 0. </p>"},{"location":"patch/defining/#creating-a-patchspec-from-json","title":"Creating a PatchSpec from JSON","text":"<p>The structure of a <code>Patch</code> is described by a <code>PatchSpec</code>, which can in turn be imported/exported in the JSON text-based data interchange format. </p> <p>For information on loading or saving PatchSpecs as JSON, see Exporting and importing patches.</p> <p>\u2192 Next: Playing and stopping a Patch</p>"},{"location":"patch/exporting/","title":"Patch","text":""},{"location":"patch/exporting/#exporting-and-importing-patches","title":"Exporting and importing patches","text":"<p>A Patch can be exported or imported.</p> <p>\u2192 Next: Auto-free and memory management</p>"},{"location":"patch/inputs/","title":"Patch","text":""},{"location":"patch/inputs/#patch-inputs","title":"Patch inputs","text":"<p>Just like a Node, a Patch supports three different classes of input:</p> <ul> <li>Audio-rate inputs: Takes the output of another Node or Patch as an input, for continuous modulation of synthesis parameters</li> <li>Trigger inputs: Used to trigger discrete control events \u2014 for example, restarting buffer playback</li> <li>Buffer inputs: Used to pass the contents of an audio buffer to a patch \u2014 for example, as a source of audio samples, or an envelope shape</li> </ul>"},{"location":"patch/inputs/#audio-rate-inputs","title":"Audio-rate inputs","text":"<p>A Patch supports any number of user-defined named inputs, which can be used to modulate the nodes within the patch.</p> <p>Each input must be defined by calling <code>add_input()</code> when the Patch is first defined, with an optional default value.</p> <p>Info</p> <p>Note that Patches do not yet support variable inputs.</p> <p>When a Patch is playing, the value of its inputs can be set using <code>patch.set_input()</code>:</p> <pre><code>class Bloop (Patch):\n    def __init__(self, frequency=880, duration=0.1):\n        super().__init__()\n        frequency = self.add_input(\"frequency\", frequency)\n        sine = SineOscillator(frequency)\n        self.set_output(sine)\n        self.set_auto_free(True)\n\nbloop = Bloop()\nbloop.play()\n...\nbloop.set_input(\"frequency\", 100)\n</code></pre> <p>Info</p> <p>Note that Patches do not yet support setting inputs with Python properties (e.g. <code>patch.prop_name = 123</code>), as is possible with node inputs.</p>"},{"location":"patch/inputs/#triggers","title":"Triggers","text":"<p>When defining a <code>Patch</code>, it is possible to define which Node should receive <code>trigger()</code> events sent to the Patch. This is done with <code>patch.set_trigger_node()</code>:</p> <pre><code>class Hat (Patch):\n    def __init__(self, duration=0.1):\n        super().__init__()\n        duration = self.add_input(\"duration\", duration)\n        noise = WhiteNoise()\n        env = ASREnvelope(0.0001, 0.0, duration, curve=2)\n        output = noise * env\n        self.set_trigger_node(env)\n        self.set_output(output)\n\nh = Hat()\nh.play()\n...\nh.trigger() # triggers a hit, resetting the ASREnvelope to its start point\n</code></pre> <p>This can be used to create a <code>Patch</code> that stays connected to the AudioGraph and can be retriggered to play a hit.</p> <p>Info</p> <p>Note that Patches only presently support trigger events directed to a single node within the patch, and cannot route triggers to multiple different nodes.</p>"},{"location":"patch/inputs/#buffer-inputs","title":"Buffer inputs","text":"<p>Buffer inputs can be declared at define time by calling <code>self.add_buffer_input()</code>. Similar to <code>add_input</code>, the return value is a placeholder <code>Buffer</code> that can be used wherever you would normally pass a <code>Buffer</code>:</p> <pre><code>class WobblyPlayer (Patch):\n    def __init__(self, buffer):\n        super().__init__()\n        buffer = self.add_buffer_input(\"buffer\", buffer)\n        rate = SineLFO(0.2, 0.5, 1.5)\n        player = BufferPlayer(buffer, rate=rate, loop=True)\n        self.set_output(player)\n\nbuffer = Buffer(\"examples/audio/stereo-count.wav\")\nplayer = WobblyPlayer(buffer)\nplayer.play()\n</code></pre> <p>The buffer can then be replaced at runtime by calling <code>set_input()</code>:</p> <pre><code>player.set_input(\"buffer\", another_buffer)\n</code></pre> <p>\u2192 Next: Operators</p>"},{"location":"patch/operators/","title":"Patch","text":""},{"location":"patch/operators/#operators","title":"Operators","text":"<p>The output of a Patch can be amplified, attenuated, combined, modulated and compared using Python operators, in much the same way as Node:</p> <pre><code>patch = Patch(patch_spec)\noutput = patch * 0.5\n</code></pre> <p>For a full list of the operators that can be applied to a <code>Patch</code>, see Node operators.</p> <p>\u2192 Next: Patch properties</p>"},{"location":"patch/playback/","title":"Patch","text":""},{"location":"patch/playback/#playing-a-patch","title":"Playing a Patch","text":"<p>Once a <code>Patch</code> has been defined or imported, it can be instantiated in two different ways depending on how it was defined:</p> <ul> <li>From a Patch subclass</li> <li>From a PatchSpec</li> </ul>"},{"location":"patch/playback/#from-a-patch-subclass","title":"From a Patch subclass","text":"<p>The simplest way to instantiate a Patch is by defining it as a Patch subclass, and then instantiating it in the same way as a Node. </p> <pre><code>class Hat (Patch):\n    def __init__(self, duration=0.1):\n        super().__init__()\n        duration = self.add_input(\"duration\", duration)\n        noise = WhiteNoise()\n        env = ASREnvelope(0.0001, 0.0, duration, curve=2)\n        output = noise * env\n        self.set_output(output)\n        self.set_auto_free(True)\n\nhat = Hat()\nhat.play()\n</code></pre> <p>Once a Patch has finished, its state changes to <code>SIGNALFLOW_PATCH_STATE_STOPPED</code>.</p> <p>Just as with nodes, it is important to remember that playing a patch means \"connecting it to the graph\". For this reason, it is not possible to play the same patch more than once, as it is already connected to the graph.</p> <p>To play multiples of a particular <code>Patch</code> type, simply create and play multiple instances.</p>"},{"location":"patch/playback/#from-a-patchspec","title":"From a PatchSpec","text":"<p>Once a <code>PatchSpec</code> has been created or imported, it can be played by instantiating a <code>Patch</code> with the <code>PatchSpec</code> as an argument:</p> <pre><code>patch = Patch(patch_spec)\npatch.play()\n</code></pre>"},{"location":"patch/playback/#connecting-a-patch-to-another-patchs-input","title":"Connecting a Patch to another Patch's input","text":"<p>A <code>Patch</code> can be connected to the input of another <code>Patch</code> (or Node), in exactly the same way described in Connecting a Node to another Node's input.</p> <p>Once you have got to grips with this paradigm, it becomes simple to build up sophisticated processing graphs by abstracting complex functionality within individual <code>Patch</code> objects, and connecting them to one another. </p>"},{"location":"patch/playback/#stopping-a-patch","title":"Stopping a Patch","text":"<p>As in Node playback, stopping a Patch disconnects it from the AudioGraph. Patches with auto-free are automatically stopped when their lifetimes ends. Patches with an unlimited lifespan must be stopped manually, with:</p> <pre><code>patch.stop()\n</code></pre> <p>This disconnects the Patch from its output.</p> <p>\u2192 Next: Patch inputs</p>"},{"location":"patch/properties/","title":"Patch","text":""},{"location":"patch/properties/#patch-properties","title":"Patch properties","text":"Property Type Description nodes list A list of all of the Node objects that make up this Patch inputs dict A dict of key-value pairs corresponding to all of the (audio rate) inputs within the Patch state int The Patch's current playback state, which can be <code>SIGNALFLOW_PATCH_STATE_ACTIVE</code> or <code>SIGNALFLOW_PATCH_STATE_STOPPED</code>. graph AudioGraph A reference to the AudioGraph that the Patch is part of <p>\u2192 Next: Exporting and importing patches</p>"},{"location":"planning/NAMING/","title":"NAMING","text":""},{"location":"planning/NAMING/#nodes","title":"NODES","text":"<p>Generators  - Oscillators    - Wavetable    - Waveforms (all wrappers around Wavetable with band-limiting)      - SineOscillator      - SquareOscillator      - TriangleOscillator      - SawOscillator  - LFO (all wrappers around Wavetable)    - SineLFO    - SquareLFO    - TriangleLFO    - SawLFO  - Buffer    - BufferPlayer    - BufferRecorder  - Stochastic    -  Processors  - Panners    - ChannelMixer    - LinearPanner    - AzimuthPanner    - ObjectPanner  - Delay    - AllpassDelay    - Delay  - Effects    - EQ    - Gate    - Resampler    - Waveshaper</p> <p>Stochastic  - Random signal generators    - WhiteNoise    - PinkNoise     - BrownNoise    - PerlinNoise  - Random number generators (with clocked inputs)    - RandomUniform    - RandomLinear    - RandomBrownian    - RandomExponentialDist    - RandomGaussian    - RandomBeta  - Random event generators    - RandomImpulse</p> <p>-- PATCHES  - Patch  - PatchDef</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"SignalFlow: Explore sound synthesis and DSP with Python","text":"<p>SignalFlow is a sound synthesis framework whose goal is to make it quick and intuitive to explore complex sonic ideas. It has a simple Python API, allowing for rapid prototyping in Jupyter notebooks or on the command-line. It comes with over 100 signal processing classes for creative exploration, from filters and delays to FFT-based spectral processing and Euclidean rhythm generators.</p> <p>Its core is implemented in efficient C++11, with cross-platform hardware acceleration.  </p> <p>SignalFlow has robust support for macOS and Linux (including Raspberry Pi), and has work-in-progress support for Windows. The overall project is currently in alpha status, and interfaces may change without warning.</p>"},{"location":"#example","title":"Example","text":"<p>Let's take a look at a minimal SignalFlow example. Here, we create and immediately start the <code>AudioGraph</code>, construct a stereo sine oscillator with a short envelope, connect the oscillator to the graph's output, and run the graph indefinitely.</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope\noutput.play()\ngraph.wait()\n</code></pre> <p>This demo shows a few syntactical benefits that SignalFlow provides to make it easy to work with audio:</p> <ul> <li>The 2-item array of frequency values passed to <code>SineOscillator</code> is expanded to create a stereo, 2-channel output. If you passed a 10-item array, the output would have 10 channels. (Read more: Multichannel nodes)</li> <li>Mathematical operators like <code>*</code> can be used to multiply, add, subtract or divide the output of nodes, and creates a new output Node that corresponds to the output of the operation. This example uses an envelope to modulate the amplitude of an oscillator. (Read more: Node operators)</li> <li>Even through the envelope is mono and the oscillator is stereo, SignalFlow does the right thing and upmixes the envelope's values to create a stereo output, so that the same envelope shape is applied to the L and R channels of the oscillator, before creating a stereo output. This is called \"automatic upmixing\", and is handy when working with multichannel graphs. (Read more: Automatic upmixing)</li> </ul> <p>In subsequent examples, we will skip the <code>import</code> line and assume you have already imported everything from the <code>signalflow</code> namespace.</p> <p>Info</p> <p>If you want to enforce separation of namespaces, you might want to do something like the below. <pre><code>import signalflow as sf\n\ngraph = sf.AudioGraph()\nsine = sf.SineOscillator(440)\n...\n</code></pre></p>"},{"location":"#overview","title":"Overview","text":"<p>At its core, SignalFlow has a handful of key concepts.</p> <ul> <li>At the top level is the AudioGraph, which connects to the system's audio input/output hardware.</li> <li>The graph comprises of a network of Nodes, each of which performs a single function (for example, generating a cyclical waveform, or filtering an input node). Nodes are connected by input and output relationships: the output of one node may be used to control the frequency of another. As the output of the first node increases, the frequency of the second node increases correspondingly. This modulation is applied on a sample-by-sample basis: all modulation in SignalFlow happens at audio rate.</li> <li>Nodes may have multiple inputs, which determine which synthesis properties can be modulated at runtime.</li> <li>A node can also have Buffer properties, which contain audio waveform data that can be read and written to, for playback or recording of samples. </li> <li>Nodes can be grouped in a Patch, which is a user-defined configuration of nodes. A patch may have one or more named inputs that are defined by the user when creating the patch. Patches can be thought of like voices of a synthesizer. A patch can also be set to automatically remove itself from the graph when a specified node's playback is complete, which is important for automatic memory management.</li> </ul>"},{"location":"#documentation","title":"Documentation","text":"<ul> <li>Installation</li> <li>Example code</li> </ul>"},{"location":"examples/","title":"Examples","text":"<p>For various code examples using SignalFlow, see <code>examples</code> in GitHub:</p> <p>https://github.com/ideoforms/signalflow/tree/master/examples</p>"},{"location":"getting-started/","title":"Getting started","text":""},{"location":"getting-started/#requirements","title":"Requirements","text":"<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p>"},{"location":"getting-started/#installation","title":"Installation","text":""},{"location":"getting-started/#macos","title":"macOS","text":"<p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install SignalFlow from the command line</p> <p>If you're new to Python or getting started from scratch: </p> <p>macOS: Install SignalFlow with Visual Studio Code </p>"},{"location":"getting-started/#examples","title":"Examples","text":"<p>Several example scripts are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>"},{"location":"license/","title":"License","text":"<p>SignalFlow is under the MIT license.</p> <p>This means that you are welcome to use it for any purpose, including commercial usage, but must include the copyright notice above in any copies or derivative works.</p> <p>Please do let me know what you use it for! </p>"},{"location":"buffer/","title":"Buffer","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>A <code>Buffer</code> is an allocated area of memory that can be used to store single-channel or multi-channel data, which may represent an audio waveform or any other type of signal. </p> <ul> <li>A Buffer can be created from a sound file, an array of samples, or with an empty contents</li> <li>A Buffer can be passed to a Node or Patch as an input</li> <li>A Buffer can be exported to a sound file</li> <li>A Buffer's data can be directly accessed in memory as a numpy array, or by get/set methods</li> <li>The contents of a buffer can be combined with arithmetic operators</li> <li>Properties</li> <li>Buffer interpolation modes</li> <li>2D buffers</li> <li>Buffer applications: Sample recording and playback, control recording and playback, envelopes, waveshapers </li> <li>The total Buffer memory usage can be queried </li> </ul>"},{"location":"graph/","title":"The AudioGraph","text":"<p><code>AudioGraph</code> is the global audio processing system that schedules and performs audio processing. It is comprised of an interconnected network of Node and Patch objects, which audio flows through.</p> <p>Each time a new block of audio is requested by the system audio I/O layer, the <code>AudioGraph</code> object is responsible for traversing the tree of nodes and generating new samples by calling each <code>Node</code>'s <code>process</code> method.</p> <p>Why 'Graph'?</p> <p>You may be more familiar with \"graph\" being used to mean a data visualisation. In signal processing and discrete mathematics, the term \"graph\" is also used to denote a system of nodes (\"vertices\") related by connections (\"edges\"). Read more: Graph Theory Basics (Lumen Learning). </p> <p>\u2192 Next: Creating the graph</p>"},{"location":"graph/config/","title":"The AudioGraph","text":""},{"location":"graph/config/#graph-configuration","title":"Graph configuration","text":"<p>There are a number of graph configuration parameters that can be used to change the global behaviour of the audio system. This can be done programmatically, via a config file, or via environmental variables.</p> Parameter Description output_backend_name The name of the audio output backend to use, which can be one of: <code>jack</code>, <code>alsa</code>, <code>pulseaudio</code>, <code>coreaudio</code>, <code>wasapi</code>, <code>dummy</code>. Defaults to the first of these found on the system. Typically only required for Linux. output_device_name The name of the audio output device to use. This must precisely match the device's name in your system. If not found, <code>DeviceNotFoundException</code> is thrown when instantiating the graph. output_buffer_size The size of the hardware output audio buffer, in samples. A larger buffer reduces the chance of buffer overflows and glitches, but at the cost of higher latency. Note that this config option merely specifies the preferred output buffer size, which may not be available in the system hardware. To check the actual buffer size used by the AudioGraph, query <code>graph.output_buffer_size</code> after instantiation. input_device_name The name of the input device to use. input_buffer_size The size of the hardware input audio buffer. sample_rate The audio sample rate to use. cpu_usage_limit Imposes a hard limit on the CPU usage permitted by SignalFlow. If the estimated (single-core) CPU usage exceeds this value, no more nodes or patches can be created until it returns to below the limit. Floating-point value between 0..1, where 0.5 means 50% CPU."},{"location":"graph/config/#configuring-the-graph-programmatically","title":"Configuring the graph programmatically","text":"<p>To specify an alternative config, create and populate an <code>AudioGraphConfig</code> object before the graph is started:</p> <pre><code>config = AudioGraphConfig()\nconfig.output_device_name = \"MacBook Pro Speakers\"\nconfig.sample_rate = 44100\nconfig.output_buffer_size = 2048\n\ngraph = AudioGraph(config)\n</code></pre>"},{"location":"graph/config/#configuring-the-graph-via-signalflowconfig","title":"Configuring the graph via ~/.signalflow/config","text":"<p>To specify a configuration that is used by all future SignalFlow sessions, create a file <code>~/.signalflow/config</code>, containing one or more of the \"Graph configuration\" fields listed above.</p> <p>For example:</p> <pre><code>[audio]\nsample_rate = 48000\noutput_buffer_size = 256\ninput_buffer_size = 256\noutput_device_name = \"MacBook Pro Speakers\"\ninput_device_name = \"MacBook Pro Microphone\"\n</code></pre> <p>All fields are optional.</p> <p>A quick and easy way to edit your config, or create a new config file, is by using the <code>signalflow</code> command-line utility:</p> <pre><code>signalflow configure\n</code></pre> <p>This will use your default <code>$EDITOR</code> to open the configuration, or <code>pico</code> if no editor is specified.</p>"},{"location":"graph/config/#configuring-the-graph-via-environmental-variables","title":"Configuring the graph via environmental variables","text":"<p>SignalFlow config can also be set by setting an environmental variable in your shell. Variable names are identical to the upper-case version of the config string, prefixed with <code>SIGNALFLOW_</code>. For example:</p> <pre><code>export SIGNALFLOW_OUTPUT_DEVICE_NAME=\"MacBook Pro Speakers\"\nexport SIGNALFLOW_OUTPUT_BUFFER_SIZE=1024\n</code></pre>"},{"location":"graph/config/#printing-the-current-config","title":"Printing the current config","text":"<p>To print the current configuration to stdout:</p> <pre><code>graph.config.print()\n</code></pre> <p>\u2192 Next: Graph status and properties</p>"},{"location":"graph/creating/","title":"The AudioGraph","text":""},{"location":"graph/creating/#creating-the-graph","title":"Creating the graph","text":"<p>Creating the graph is simple: <code>graph = AudioGraph()</code></p> <p>By default, a new <code>AudioGraph</code> immediately connects to the system's default audio hardware device (via the integrated <code>libsoundio</code> library), using the system's default sample rate and buffer size.</p> <p>Info</p> <p>Note that the AudioGraph is a singleton object: only one AudioGraph can be created, which is shared globally.</p> <p>To prevent the graph from starting instantly (for example, if you want to use the graph in offline mode), pass <code>start=False</code> to the constructor.</p> <p>To configure graph playback or recording parameters, see AudioGraph: Configuration.</p> <p>\u2192 Next: Graph configuration</p>"},{"location":"graph/properties/","title":"The AudioGraph","text":""},{"location":"graph/properties/#status-and-properties","title":"Status and properties","text":"<p>A number of methods are provided to query the graph's current status and properties.</p>"},{"location":"graph/properties/#status","title":"Status","text":"<p>Querying <code>graph.status</code> returns a one-line description of the number of nodes and patches in the graph, and the estimated CPU and RAM usage:</p> <pre><code>&gt;&gt;&gt; graph.status\nAudioGraph: 235 active nodes, 6 patches, 13.95% CPU usage, 34.91MB memory usage\n</code></pre> <p>To automatically poll and print the graph's status periodically, call <code>graph.poll(interval)</code>, where <code>interval</code> is in seconds:</p> <pre><code>&gt;&gt;&gt; graph.poll(1)\nAudioGraph: 118 active nodes, 3 patches, 7.09% CPU usage, 34.91MB memory usage\nAudioGraph: 118 active nodes, 3 patches, 7.16% CPU usage, 34.91MB memory usage\nAudioGraph: 40 active nodes, 1 patch, 2.60% CPU usage, 34.91MB memory usage\n</code></pre> <p>To stop polling, call <code>graph.poll(0)</code>.</p>"},{"location":"graph/properties/#structure","title":"Structure","text":"<p>Querying <code>graph.structure</code> returns a multi-line string describing every Node in the graph, their parameter values, and their connectivity structure.</p> <pre><code>&gt;&gt;&gt; graph.structure\n * audioout-soundio\n   input0:\n    * linear-panner\n      pan: 0.000000\n      input:\n       * multiply\n         input1: 0.251189\n         input0:\n          * sine\n            frequency: 440.000000\n</code></pre>"},{"location":"graph/properties/#other-graph-properties","title":"Other graph properties","text":"<ul> <li><code>graph.node_count</code> (int): Returns the current number of Nodes in the graph (including within patches)</li> <li><code>graph.patch_count</code> (int): Returns the current number of Patches in the graph</li> <li><code>cpu_usage</code> (float): Returns the current CPU usage, between 0.0 (0%) and 1.0 (100%). CPU usage can be lowered by increasing the output buffer size.</li> <li><code>memory_usage</code> (int): Returns the current RAM usage, in bytes. This is typically mostly used by waveform data in Buffers.</li> <li><code>num_output_channels</code> (int): Returns the graph's current output channel count, which is typically identical to the number of channels supported by the audio output device.</li> <li><code>output_buffer_size</code> (int): Returns the current hardware output buffer size, in bytes.</li> </ul> <p>\u2192 Next: Recording graph output</p>"},{"location":"graph/recording/","title":"The AudioGraph","text":""},{"location":"graph/recording/#recording-the-audio-output-of-the-graph","title":"Recording the audio output of the graph","text":"<p>Convenience methods are provided to make it easy to record the global audio output when rendering audio in real-time:</p> <pre><code>graph.start_recording(\"filename.wav\")\n...\ngraph.stop_recording()\n</code></pre> <p>To record output in formats other than the default stereo, <code>start_recording</code> takes a <code>num_channels</code> argument that can be used to specify an alternative channel count.</p> <p>Note</p> <p>At present, only .wav is supported as an output format for global audio recordings. </p>"},{"location":"graph/recording/#offline-non-real-time-rendering","title":"Offline (non-real-time) rendering","text":"<p>It is also possible to perform non-real-time rendering of a synthesis graph,  by synthesizing audio output to a <code>Buffer</code> which can then be saved to disk:   </p> <pre><code># Create an AudioGraph with a dummy output device\ngraph = AudioGraph(output_device=AudioOut_Dummy(2))\n\n# Create a buffer that will be used to store the audio output\nbuffer = Buffer(2, graph.sample_rate * 4)\n\n# Create a synthesis graph to render\nfreq = SawLFO(1, 200, 400)\nsine = SineOscillator([freq, freq+10])\ngraph.play(sine)\n\n# Render to the buffer. Non-real-time, so happens instantaneously.\n# Note that the graph renders as many samples as needed to fill the buffer.\ngraph.render_to_buffer(buffer)\n\n# Write the buffer contents to a file\nbuffer.save(\"output.wav\")\n\n# Finally, tear down the buffer\ngraph.destroy()\n</code></pre> <p>\u2192 Next: Clearing and stopping the graph</p>"},{"location":"graph/stopping/","title":"The AudioGraph","text":""},{"location":"graph/stopping/#clearing-and-stopping-the-graph","title":"Clearing and stopping the graph","text":"<p>To clear all nodes and patches from the graph but leave it running for further audio synthesis:</p> <pre><code>&gt;&gt;&gt; graph.clear()\n</code></pre> <p>To stop the graph and pause audio I/O:</p> <pre><code>&gt;&gt;&gt; graph.stop()\n</code></pre> <p>To permanently destroy the graph:</p> <pre><code>&gt;&gt;&gt; graph.destroy()\n</code></pre>"},{"location":"howto/","title":"Howto","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>Tutorials on common tasks with SignalFlow.</p>"},{"location":"howto/midi/","title":"Howto: MIDI control","text":""},{"location":"installation/","title":"Getting started","text":""},{"location":"installation/#requirements","title":"Requirements","text":"<p>SignalFlow supports macOS, Linux (including Raspberry Pi), and has alpha support for Windows. </p>"},{"location":"installation/#installation","title":"Installation","text":""},{"location":"installation/#macos","title":"macOS","text":"<p>If you're new to Python or getting started from scratch:</p> <p>macOS: Easy install with Visual Studio Code </p> <p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install from the command line</p>"},{"location":"installation/#linux","title":"Linux","text":"<p>Linux: Install from the command line</p>"},{"location":"installation/#examples","title":"Examples","text":"<p>Several example scripts are included within the repo, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</p>"},{"location":"installation/command-line-generic/","title":"Command line generic","text":""},{"location":"installation/command-line-generic/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/command-line-generic/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/command-line-generic/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/command-line-generic/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/command-line-generic/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/next-steps/","title":"Next steps","text":""},{"location":"installation/next-steps/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/linux/","title":"Installation on Linux","text":"<p>Linux: Install from the command line</p>"},{"location":"installation/linux/buttons/","title":"Buttons","text":"<p>Linux: Install from the command line</p>"},{"location":"installation/linux/command-line/","title":"SignalFlow: Command-line installation for Linux","text":"<p>SignalFlow currently supports Linux x86_64 and Raspberry Pi.</p> <p>These instructions assume you have a working version of Python 3.8+.</p>"},{"location":"installation/linux/command-line/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/linux/command-line/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/linux/command-line/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/linux/command-line/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/linux/command-line/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/linux/command-line/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/macos/","title":"Installation on macOS","text":"<p>If you're new to Python or getting started from scratch:</p> <p>macOS: Easy install with Visual Studio Code </p> <p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install from the command line</p>"},{"location":"installation/macos/buttons/","title":"Buttons","text":"<p>If you're new to Python or getting started from scratch:</p> <p>macOS: Easy install with Visual Studio Code </p> <p>If you are an existing Python user and confident with the command line:</p> <p>macOS: Install from the command line</p>"},{"location":"installation/macos/command-line/","title":"SignalFlow: Command-line installation for macOS","text":"<p>These instructions assume you have a working version of Python 3.8+, installed either via Homebrew or from Python.org.</p>"},{"location":"installation/macos/command-line/#1-set-up-a-virtual-environment","title":"1. Set up a virtual environment","text":"<p>Creating a new virtual environment for SignalFlow minimises the chances of conflict with other local Python installs.</p> <pre><code>python3 -m venv signalflow-env\nsource signalflow-env/bin/activate\n</code></pre>"},{"location":"installation/macos/command-line/#2-install-signalflow","title":"2. Install SignalFlow","text":"<p>Installing SignalFlow with <code>pip</code>:</p> <pre><code>pip3 install signalflow\n</code></pre> <p>If the installation succeeds, you should see <code>Successfully installed signalflow</code>.</p>"},{"location":"installation/macos/command-line/#3-line-test","title":"3. Line test","text":"<p>The installation of SignalFlow includes a command-line tool, <code>signalflow</code>, that can be used to test and configure the framework. Check that the installation has succeeded by playing a test tone through your default system audio output:</p> <p>This may take a few seconds to run for the first time. To exit the test, press Ctrl-C (<code>^C</code>).</p> <pre><code>signalflow test\n</code></pre>"},{"location":"installation/macos/command-line/#4-hello-world","title":"4. Hello, world","text":"<p>In your text editor, create a new <code>.py</code> file containing the below code:</p> <pre><code>from signalflow import *\n\ngraph = AudioGraph()\nsine = SineOscillator([440, 880])\nenvelope = ASREnvelope(0.1, 0.1, 0.5)\noutput = sine * envelope * 0.1\noutput.play()\ngraph.wait()\n</code></pre> <p>When you run the script, you should hear a short stereo \"ping\".</p>"},{"location":"installation/macos/command-line/#5-optional-interactive-notebooks-in-jupyter","title":"5. (Optional) Interactive notebooks in Jupyter","text":"<p>A nice way to experiment with SignalFlow is by using Jupyter interactive notebooks.</p> <p>Install Jupyter and register this virtual environment as a Jupyter kernel: </p> <pre><code>pip3 install jupyter\npython3 -m ipykernel install --name signalflow-env\n</code></pre> <p>Open a Jupyter notebook:</p> <pre><code>jupyter notebook\n</code></pre>"},{"location":"installation/macos/command-line/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"installation/macos/easy/","title":"SignalFlow: Easy install for macOS","text":"<p>The simplest way to start exploring SignalFlow is with the free Visual Studio Code editor. Visual Studio Code can edit interactive \"Jupyter\" notebooks, which allow you to run and modify blocks of Python code in real-time, which is a great way to experiment live with audio synthesis.</p> <p>You'll only need to do this installation process once. Once setup, experimenting with SignalFlow is as simple as opening Visual Studio Code.  </p>"},{"location":"installation/macos/easy/#1-install-python","title":"1. Install Python","text":"<p>Download and install the latest version of Python (currently 3.12).</p> <p>Download Python</p>"},{"location":"installation/macos/easy/#2-download-and-install-visual-studio-code","title":"2. Download and install Visual Studio Code","text":"<p>Download and install the latest version of Visual Studio Code.</p> <p>Download Visual Studio Code</p> <p>Once installed, open <code>Applications</code> and run <code>Visual Studio Code</code>.</p>"},{"location":"installation/macos/easy/#3-install-the-python-and-jupyter-extensions","title":"3. Install the Python and Jupyter extensions","text":"<p>Visual Studio Code requires extensions to be installed to handle Python and Jupyter files.</p> <p>In Visual Studio Code, select the <code>Extensions</code> icon from in the far-left column (or press <code>\u21e7\u2318X</code>), and install the <code>Python</code> and <code>Jupyter</code> extensions by searching for their names and clicking \"Install\" on each.</p> <p>Once installation has finished, close the <code>Extensions</code> tab.</p>"},{"location":"installation/macos/easy/#4-create-a-new-workspace","title":"4. Create a new workspace","text":"<p>In Visual Studio code, create a new folder to contain your new SignalFlow project:</p> <ul> <li>Select <code>File \u2192 Open Folder...</code></li> <li>Select <code>New Folder</code>, and pick a name for your new project folder</li> </ul> <p>Where to put your workspace</p> <p>You can store your project workspace anywhere on your drive. The workspace can hold multiple notebooks, audio files, etc.</p> <p>Trusted workspaces</p> <p>If Visual Studio asks \"Do you trust the authors of the files in this folder?\", select \"Yes, I trust the authors\". This is a security mechanism to protect you against untrusted third-party code.</p>"},{"location":"installation/macos/easy/#5-create-a-notebook","title":"5. Create a notebook","text":"<p>Select <code>File \u2192 New File...</code> (<code>^\u2325\u2318N</code>), and select <code>Jupyter Notebook</code>. You should see the screen layout change to display an empty black text block (in Jupyter parlance, a \"cell\"). </p>"},{"location":"installation/macos/easy/#6-create-a-python-virtual-environment-to-use","title":"6. Create a Python virtual environment to use","text":"<p>Click the button marked <code>Select Kernel</code> in the top right. </p> <ul> <li>Select <code>Python Environments...</code></li> <li>Select <code>Create Python Environment</code></li> <li>Select <code>Venv</code></li> <li>Finally, select the version of Python you just installed (<code>3.12.x</code>).</li> </ul> <p>Visual Studio Code will launch into some activity, in which it is installing necessary libraries and creating a Python \"virtual environment\", which is an isolated area of the filesystem containing all of the packages needed for this working space. Working in different virtual environments for different projects is good practice to minimise the likelihood of conflicts and disruptions.</p> <p>When the setup is complete, the button in the top right should change to say <code>.venv (Python 3.12.x)</code>.</p> <p>Info</p> <p>New notebooks created within this workspace will share the same Python virtual environment.  </p>"},{"location":"installation/macos/easy/#7-install-signalflow","title":"7. Install SignalFlow","text":"<p>In the first block, copy and paste the below:</p> <pre><code>%pip install signalflow\n</code></pre> <p>To run the cell, press <code>^\u21b5</code> (control-enter). After a minute, you should see some output saying <code>Successfully installed signalflow</code>.</p> <p>You're now all set to start writing code!</p>"},{"location":"installation/macos/easy/#8-start-writing-code","title":"8. Start writing code","text":"<p>In a Jupyter interactive notebook, you can write and run multi-line blocks of Python code. Press <code>enter</code> to edit the cell, delete its contents, and paste the below.    </p> <pre><code>print(\"Hello\")\nprint(\"world!\")\n</code></pre> <p>Press <code>^\u21b5</code> (control-enter) to run the cell. You should see \"Hello world!\" appear below the cell. </p> <p>Keyboard shortcuts</p> <ul> <li>Navigate between cells with the arrow keys</li> <li>Press <code>enter</code> to begin editing a cell, and <code>escape</code> to end editing and move to select mode</li> <li>In select mode, use <code>b</code> to add a cell after the current cell, and <code>a</code> to add a cell before it </li> <li>To evaluate a cell and move on to the next cell, use <code>\u21e7\u21b5</code> (shift-enter)</li> </ul>"},{"location":"installation/macos/easy/#9-signalflow-import-the-library-and-start-audio-processing","title":"9. SignalFlow: Import the library and start audio processing","text":"<p>Clear the first cell, and replace it with:</p> <pre><code>from signalflow import *\n</code></pre> <p>Run the cell with <code>^\u21b5</code>. This command imports all of the SignalFlow commands and classes, and only needs to be run once per session.</p> <p>Create a new cell by pressing <code>b</code>, and in the new cell, run:</p> <pre><code>graph = AudioGraph()\n</code></pre> <p>This will create and start a new global audio processing graph, using the system's default audio output. You should see the name of the audio device printed to the notebook.</p> <p>This also needs to be run once per session. In fact, only one global <code>AudioGraph</code> object can be created.  </p>"},{"location":"installation/macos/easy/#10-signalflow-make-some-sound","title":"10. SignalFlow: Make some sound","text":"<p>We're finally ready to make some noise!</p> <p>In a new cell, copy and paste the below:</p> <pre><code>sine = SineOscillator(440)\npanner = StereoPanner(sine, 0.0)\noutput = panner * 0.1\noutput.play()\n</code></pre> <p>This will create a simple sine wave oscillator, pan it over a stereo pair, attenuate it, and play it from the system's audio output. Hopefully you should now hear a tone playing from your speaker or headphones.</p> <p>One of the benefits of coding interactively is that you can modify the parameters of a synthesis network while it is running. In a new cell, try modifying the <code>frequency</code> property of the oscillator:</p> <pre><code>sine.frequency = 880\n</code></pre> <p>You should hear it increase in pitch. Try changing the value to something different and re-running the cell.</p> <p>The <code>pan</code> property of <code>StereoPanner</code> controls its position in the stereo field from left to right, and can range from <code>-1</code> to <code>1</code>:</p> <pre><code>panner.pan = -1\n</code></pre> <p>Finally, to stop the playback:</p> <pre><code>output.stop()\n</code></pre>"},{"location":"installation/macos/easy/#next-steps","title":"Next steps","text":"<ul> <li>Examples: Several example scripts are available for SignalFlow, covering simple control and modulation, FM synthesis, sample granulation, MIDI control, chaotic functions, etc.</li> <li>Configuration: To configure your audio hardware, see AudioGraph configuration.</li> <li>Tutorials: Coming soon</li> </ul>"},{"location":"library/","title":"Node reference library","text":""},{"location":"library/#analysis","title":"Analysis","text":"<ul> <li>CrossCorrelate: Outputs the cross-correlation of the input signal with the given buffer. If hop_size is zero, calculates the cross-correlation every sample. <code>(input=nullptr, buffer=nullptr, hop_size=0)</code></li> <li>OnsetDetector: Simple time-domain onset detector. Outputs an impulse when an onset is detected in the input. Maintains short-time and long-time averages. An onset is registered when the short-time average is threshold x the long-time average. min_interval is the minimum interval between onsets, in seconds. <code>(input=0.0, threshold=2.0, min_interval=0.1)</code></li> <li>VampAnalysis: Feature extraction using the Vamp plugin toolkit. <code>(input=0.0, plugin_id=\"vamp-example-plugins:spectralcentroid:linearcentroid\")</code></li> </ul>"},{"location":"library/#buffer","title":"Buffer","text":"<ul> <li>BeatCutter: Cuts a buffer into segment_count segments, and stutters/jumps with the given probabilities. <code>(buffer=nullptr, segment_count=8, stutter_probability=0.0, stutter_count=1, jump_probability=0.0, duty_cycle=1.0, rate=1.0, segment_rate=1.0)</code></li> <li>BufferLooper: Read and write from a buffer concurrently, with controllable overdub. <code>(buffer=nullptr, input=0.0, feedback=0.0, loop_playback=false, loop_record=false)</code></li> <li>BufferPlayer: Plays the contents of the given buffer. start_time/end_time are in seconds. When a clock signal is receives, rewinds to the start_time. <code>(buffer=nullptr, rate=1.0, loop=0, start_time=nullptr, end_time=nullptr, clock=nullptr)</code></li> <li>BufferRecorder: Records the input to a buffer. feedback controls overdub. <code>(buffer=nullptr, input=0.0, feedback=0.0, loop=false)</code></li> <li>FeedbackBufferReader: Counterpart to FeedbackBufferWriter. <code>(buffer=nullptr)</code></li> <li>FeedbackBufferWriter: Counterpart to FeedbackBufferReader. <code>(buffer=nullptr, input=0.0, delay_time=0.1)</code></li> <li>GrainSegments: GrainSegments <code>(buffer=nullptr, clock=0, target=0, offsets={}, values={}, durations={})</code></li> <li>Granulator: Granulator. Generates a grain from the given buffer each time a clock signal is received, with the given duration/rate/pan parameters. The input buffer can be mono or stereo. <code>(buffer=nullptr, clock=0, pos=0, duration=0.1, pan=0.0, rate=1.0, max_grains=2048)</code></li> <li>SegmentPlayer: Trigger segments of a buffer at the given onset positions. <code>(buffer=nullptr, onsets={})</code></li> </ul>"},{"location":"library/#control","title":"Control","text":"<ul> <li>MouseX: Outputs the normalised cursor X position, from 0 to 1. Currently only supported on macOS. <code>()</code></li> <li>MouseY: Outputs the normalised cursor Y position, from 0 to 1. Currently only supported on macOS. <code>()</code></li> <li>MouseDown: Outputs 1 if the left mouse button is down, 0 otherwise. Currently only supported on macOS. <code>(button_index=0)</code></li> </ul>"},{"location":"library/#envelope","title":"Envelope","text":"<ul> <li>ADSREnvelope: Attack-decay-sustain-release envelope. Sustain portion is held until gate is zero. <code>(attack=0.1, decay=0.1, sustain=0.5, release=0.1, gate=0)</code></li> <li>ASREnvelope: Attack-sustain-release envelope. <code>(attack=0.1, sustain=0.5, release=0.1, curve=1.0, clock=nullptr)</code></li> <li>DetectSilence: Detects blocks of silence below the threshold value. Used as an auto-free node to terminate a Patch after processing is complete. <code>(input=nullptr, threshold=0.00001)</code></li> <li>Envelope: Generic envelope constructor, given an array of levels, times and curves. <code>(levels=std::vector&lt;NodeRef&gt; ( ), times=std::vector&lt;NodeRef&gt; ( ), curves=std::vector&lt;NodeRef&gt; ( ), clock=nullptr, loop=false)</code></li> <li>Line: Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal. <code>(from=0.0, to=1.0, time=1.0, loop=0, clock=nullptr)</code></li> <li>RectangularEnvelope: Rectangular envelope with the given sustain duration. <code>(sustain_duration=1.0, clock=nullptr)</code></li> </ul>"},{"location":"library/#fft","title":"Fft","text":"<ul> <li>FFTContinuousPhaseVocoder: Continuous phase vocoder. Requires an FFT* input. <code>(input=nullptr, rate=1.0)</code></li> <li>FFTConvolve: Frequency-domain convolution, using overlap-add. Useful for convolution reverb, with the input buffer containing an impulse response. Requires an FFT* input. <code>(input=nullptr, buffer=nullptr)</code></li> <li>FFT: Fast Fourier Transform. Takes a time-domain input, and generates a frequency-domain (FFT) output. <code>(input=0.0, fft_size=SIGNALFLOW_DEFAULT_FFT_SIZE, hop_size=SIGNALFLOW_DEFAULT_FFT_HOP_SIZE, window_size=0, do_window=true)</code></li> <li>FFTNode: FFTNode <code>(fft_size=None, hop_size=None, window_size=None, do_window=None)</code></li> <li>FFTOpNode: FFTOpNode <code>(input=nullptr)</code></li> <li>FFTFindPeaks: Find peaks in the FFT magnitude spectrum. Requires an FFT* input. <code>(input=0, prominence=1, threshold=0.000001, count=SIGNALFLOW_MAX_CHANNELS, interpolate=true)</code></li> <li>IFFT: Inverse Fast Fourier Transform. Requires an FFT* input, generates a time-domain output. <code>(input=nullptr, do_window=false)</code></li> <li>FFTLPF: FFT-based brick wall low pass filter. Requires an FFT* input. <code>(input=0, frequency=2000)</code></li> <li>FFTNoiseGate: FFT-based noise gate. Requires an FFT* input. <code>(input=0, threshold=0.5)</code></li> <li>FFTPhaseVocoder: Phase vocoder. Requires an FFT* input. <code>(input=nullptr)</code></li> <li>FFTTonality: Tonality filter. Requires an FFT* input. <code>(input=0, level=0.5, smoothing=0.9)</code></li> <li>FFTZeroPhase: Remove phase information from a frequency-domain input. Requires an FFT* input. <code>(input=0)</code></li> </ul>"},{"location":"library/#operators","title":"Operators","text":"<ul> <li>Add: Add each sample of a to each sample of b. Can also be written as a + b <code>(a=0, b=0)</code></li> <li>AmplitudeToDecibels: Map a linear amplitude value to decibels. <code>(a=0)</code></li> <li>DecibelsToAmplitude: DecibelsToAmplitude <code>(a=0)</code></li> <li>ChannelArray: Takes an array of inputs and spreads them across multiple channels of output. <code>()</code></li> <li>ChannelCrossfade: Given a multichannel input, crossfades between channels based on the given position within the virtual array, producing a single-channel output. <code>(input=nullptr, index=nullptr, num_output_channels=1)</code></li> <li>ChannelMixer: Downmix a multichannel input to a lower-channel output. If num_channels is greater than one, spreads the input channels across the field. If amplitude_compensation is enabled, scale down the amplitude based on the ratio of input to output channels. <code>(num_channels=1, input=0, amplitude_compensation=true)</code></li> <li>ChannelSelect: Select a subset of channels from a multichannel input, starting at offset, up to a maximum of maximum, with the given step. <code>(input=nullptr, offset=0, maximum=0, step=1)</code></li> <li>Equal: Compares the output of a to the output of b. Outputs 1 when equal, 0 otherwise. Can also be written as a == b <code>(a=0, b=0)</code></li> <li>NotEqual: Compares the output of a to the output of b. Outputs 0 when equal, 1 otherwise. Can also be written as a != b <code>(a=0, b=0)</code></li> <li>GreaterThan: Compares the output of a to the output of b. Outputs 1 when a &gt; b, 0 otherwise. Can also be written as a &gt; b <code>(a=0, b=0)</code></li> <li>GreaterThanOrEqual: Compares the output of a to the output of b. Outputs 1 when a &gt;= b, 0 otherwise. Can also be written as a &gt;= b <code>(a=0, b=0)</code></li> <li>LessThan: Compares the output of a to the output of b. Outputs 1 when a &lt; b, 0 otherwise. Can also be written as a &lt; b <code>(a=0, b=0)</code></li> <li>LessThanOrEqual: Compares the output of a to the output of b. Outputs 1 when a &lt;= b, 0 otherwise. Can also be written as a &lt;= b <code>(a=0, b=0)</code></li> <li>Modulo: Outputs the value of a modulo b, per sample. Supports fractional values. Can also be written as a % b <code>(a=0, b=0)</code></li> <li>Abs: Outputs the absolute value of a, per sample. Can also be written as abs(a) <code>(a=0)</code></li> <li>If: Outputs value_if_true for each non-zero value of a, value_if_false for all other values. <code>(a=0, value_if_true=0, value_if_false=0)</code></li> <li>Divide: Divide each sample of a by each sample of b. Can also be written as a / b <code>(a=1, b=1)</code></li> <li>FrequencyToMidiNote: Map a frequency to a MIDI note (where 440Hz = A4 = 69), with floating-point output. <code>(a=0)</code></li> <li>MidiNoteToFrequency: Map a MIDI note to a frequency (where 440Hz = A4 = 69), supporting floating-point input. <code>(a=0)</code></li> <li>Multiply: Multiply each sample of a by each sample of b. Can also be written as a * b <code>(a=1.0, b=1.0)</code></li> <li>Pow: Outputs a to the power of b, per sample. Can also be written as a ** b <code>(a=0, b=0)</code></li> <li>RoundToScale: Given a frequency input, generates a frequency output that is rounded to the nearest MIDI note. (TODO: Not very well named) <code>(a=0)</code></li> <li>Round: Round the input to the nearest integer value. <code>(a=0)</code></li> <li>ScaleLinExp: Scales the input from a linear range (between a and b) to an exponential range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li> <li>ScaleLinLin: Scales the input from a linear range (between a and b) to a linear range (between c and d). <code>(input=0, a=0, b=1, c=1, d=10)</code></li> <li>Subtract: Subtract each sample of b from each sample of a. Can also be written as a - b <code>(a=0, b=0)</code></li> <li>Sum: Sums the output of all of the input nodes, by sample. <code>()</code></li> <li>Sin: Outputs sin(a), per sample. <code>(a=0)</code></li> <li>Cos: Outputs cos(a), per sample. <code>(a=0)</code></li> <li>Tan: Outputs tan(a), per sample. <code>(a=0)</code></li> <li>Tanh: Outputs tanh(a), per sample. Can be used as a soft clipper. <code>(a=0)</code></li> </ul>"},{"location":"library/#oscillators","title":"Oscillators","text":"<ul> <li>Constant: Produces a constant value. <code>(value=0)</code></li> <li>Impulse: Produces a value of 1 at the given frequency, with output of 0 at all other times. If frequency is 0, produces a single impulse. <code>(frequency=1.0)</code></li> <li>LFO: LFO <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SawLFO: Produces a sawtooth LFO, with output ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SawOscillator: Produces a (non-band-limited) sawtooth wave, with the given frequency and phase offset. When a reset or trigger is received, resets the phase to zero. <code>(frequency=440, phase=nullptr, reset=nullptr)</code></li> <li>SineLFO: Produces a sinusoidal LFO at the given frequency and phase offset, with output ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>SineOscillator: Produces a sine wave at the given frequency. <code>(frequency=440)</code></li> <li>SquareLFO: Produces a pulse wave LFO with the given frequency and pulse width, ranging from min to max, where width=0.5 is a square wave. <code>(frequency=1.0, min=0.0, max=1.0, width=0.5, phase=0.0)</code></li> <li>SquareOscillator: Produces a pulse wave with the given frequency and pulse width, where width=0.5 is a square wave. <code>(frequency=440, width=0.5)</code></li> <li>TriangleLFO: Produces a triangle LFO with the given frequency, ranging from min to max. <code>(frequency=1.0, min=0.0, max=1.0, phase=0.0)</code></li> <li>TriangleOscillator: TriangleOscillator <code>(frequency=440)</code></li> <li>Wavetable: Plays the wavetable stored in buffer at the given frequency. <code>(buffer=nullptr, frequency=440, phase=0, sync=0, phase_map=nullptr)</code></li> <li>Wavetable2D: Wavetable2D <code>(buffer=nullptr, frequency=440, crossfade=0.0, phase=0.0, sync=0)</code></li> </ul>"},{"location":"library/#processors","title":"Processors","text":"<ul> <li>Clip: Clip the input to min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> <li>Fold: Fold the input beyond min/max, reflecting the excess back. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> <li>Smooth: Smooth the input with a given smoothing coefficient. When smooth = 0, applies no smoothing. <code>(input=nullptr, smooth=0.99)</code></li> <li>WetDry: Takes wet and dry inputs, and outputs a mix determined by wetness. <code>(dry_input=nullptr, wet_input=nullptr, wetness=0.0)</code></li> <li>Wrap: Wrap the input beyond min/max. <code>(input=nullptr, min=-1.0, max=1.0)</code></li> </ul>"},{"location":"library/#processors-delays","title":"Processors: Delays","text":"<ul> <li>AllpassDelay: All-pass delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li> <li>CombDelay: Comb delay, with feedback between 0 and 1. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, feedback=0.5, max_delay_time=0.5)</code></li> <li>OneTapDelay: Single-tap delay line. delay_time must be less than or equal to max_delay_time. <code>(input=0.0, delay_time=0.1, max_delay_time=0.5)</code></li> <li>Stutter: Stutters the input whenever a signal is received on clock. Generates stutter_count repeats, with duration stutter_time. <code>(input=0.0, stutter_time=0.1, stutter_count=1, clock=nullptr, max_stutter_time=1.0)</code></li> </ul>"},{"location":"library/#processors-distortion","title":"Processors: Distortion","text":"<ul> <li>Resample: Resampler and bit crusher. sample_rate is in Hz, bit_rate is an integer between 0 and 16. <code>(input=0, sample_rate=44100, bit_rate=16)</code></li> <li>SampleAndHold: Samples and holds the input each time a clock signal is received. <code>(input=nullptr, clock=nullptr)</code></li> <li>Squiz: Implementation of Dan Stowell's Squiz algorithm, a kind of downsampler. <code>(input=0.0, rate=2.0, chunk_size=1)</code></li> <li>WaveShaper: Applies wave-shaping as described in buffer. <code>(input=0.0, buffer=nullptr)</code></li> </ul>"},{"location":"library/#processors-dynamics","title":"Processors: Dynamics","text":"<ul> <li>Compressor: Dynamic range compression, with optional sidechain input. <code>(input=0.0, threshold=0.1, ratio=2, attack_time=0.01, release_time=0.1, sidechain=nullptr)</code></li> <li>Gate: Outputs the input value when it is above the given threshold, otherwise zero. <code>(input=0.0, threshold=0.1)</code></li> <li>Maximiser: Gain maximiser. <code>(input=0.0, ceiling=0.5, attack_time=1.0, release_time=1.0)</code></li> <li>RMS: Outputs the root-mean-squared value of the input, in buffers equal to the graph's current buffer size. <code>(input=0.0)</code></li> </ul>"},{"location":"library/#processors-filters","title":"Processors: Filters","text":"<ul> <li>BiquadFilter: Biquad filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. Not recommended for real-time modulation; for this, use SVFilter. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0, peak_gain=0.0)</code></li> <li>EQ: Three-band EQ. <code>(input=0.0, low_gain=1.0, mid_gain=1.0, high_gain=1.0, low_freq=500, high_freq=5000)</code></li> <li>MoogVCF: Moog ladder low-pass filter. <code>(input=0.0, cutoff=200.0, resonance=0.0)</code></li> <li>SVFilter: State variable filter. filter_type can be 'low_pass', 'band_pass', 'high_pass', 'notch', 'peak', 'low_shelf', 'high_shelf'. <code>(input=0.0, filter_type=SIGNALFLOW_FILTER_TYPE_LOW_PASS, cutoff=440, resonance=0.0)</code></li> </ul>"},{"location":"library/#processors-panning","title":"Processors: Panning","text":"<ul> <li>AzimuthPanner: Pan input around an equally-spaced ring of num_channels speakers. pan is the pan position from -1..+1, where 0 = centre front. width is the source's width, where 1.0 spans exactly between an adjacent pair of channels. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li> <li>ChannelPanner: Pan the input between a linear series of channels, where pan 0 = channel 0, 1 = channel 1, etc. No wrapping is applied. <code>(num_channels=2, input=0, pan=0.0, width=1.0)</code></li> <li>SpatialPanner: Implements a spatial panning algorithm, applied to a given SpatialEnvironment. Currently, only DBAP is supported. <code>(env=nullptr, input=0.0, x=0.0, y=0.0, z=0.0, radius=1.0, algorithm=\"dbap\")</code></li> <li>StereoBalance: Takes a stereo input and rebalances it, where 0 is unchanged, -1 is hard left, and 1 is hard right. <code>(input=0, balance=0)</code></li> <li>StereoPanner: Pans a mono input to a stereo output. Pans from -1 (hard left) to +1 (hard right), with 0 = centre. <code>(input=0, pan=0.0)</code></li> <li>StereoWidth: Reduces the width of a stereo signal. When width = 1, input is unchanged. When width = 0, outputs a pair of identical channels both containing L+R. <code>(input=0, width=1)</code></li> </ul>"},{"location":"library/#sequencing","title":"Sequencing","text":"<ul> <li>ClockDivider: When given a clock input (e.g., an Impulse), divides the clock by the given factor. factor must be an integer greater than or equal to 1. <code>(clock=0, factor=1)</code></li> <li>Counter: Count upwards from min, driven by clock. <code>(clock=0, min=0, max=2147483647)</code></li> <li>Euclidean: Euclidean rhythm as described by Toussaint, with sequence_length (n) and num_events (k), driven by clock. <code>(clock=0, sequence_length=0, num_events=0)</code></li> <li>FlipFlop: Flips from 0/1 on each clock. <code>(clock=0)</code></li> <li>ImpulseSequence: Each time a clock or trigger is received, outputs the next value in the sequence. At all other times, outputs zero. <code>(sequence=std::vector&lt;int&gt; ( ), clock=nullptr)</code></li> <li>Index: Outputs the value in list corresponding to index. <code>(list={}, index=0)</code></li> <li>Latch: Initially outputs 0. When a trigger is received at set, outputs 1. When a trigger is subsequently received at reset, outputs 0, until the next set. <code>(set=0, reset=0)</code></li> <li>Sequence: Outputs the elements in sequence, incrementing position on each clock. <code>(sequence=std::vector&lt;float&gt; ( ), clock=nullptr)</code></li> </ul>"},{"location":"library/#stochastic","title":"Stochastic","text":"<ul> <li>Logistic: Logistic noise. <code>(chaos=3.7, frequency=0.0)</code></li> <li>PinkNoise: Pink noise, with specified low/high cutoffs. <code>(low_cutoff=20.0, high_cutoff=20000.0, reset=nullptr)</code></li> <li>RandomBrownian: Outputs Brownian noise between min/max, with a mean change of delta between samples. If a clock is passed, only generates a new value on a clock tick. <code>(min=-1.0, max=1.0, delta=0.01, clock=nullptr, reset=nullptr)</code></li> <li>RandomChoice: Pick a random value from the given array. If a clock is passed, only picks a new value on a clock tick. <code>(values=std::vector&lt;float&gt; ( ), clock=nullptr, reset=nullptr)</code></li> <li>RandomCoin: Flip a coin with the given probability. If a clock is passed, only picks a new value on a clock tick. <code>(probability=0.5, clock=nullptr, reset=nullptr)</code></li> <li>RandomExponentialDist: Generate an random value following the exponential distribution. If a clock is passed, only picks a new value on a clock tick. <code>(scale=0.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomExponential: Generate an random exponential value between min/max. If a clock is passed, only picks a new value on a clock tick. <code>(min=0.001, max=1.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomGaussian: Generate an random Gaussian value, with given mean and sigma. If a clock is passed, only picks a new value on a clock tick. <code>(mean=0.0, sigma=0.0, clock=nullptr, reset=nullptr)</code></li> <li>RandomImpulseSequence: Generates a random sequence of 0/1 bits with the given length, and the given probability each each bit = 1. The position of the sequence is incremented on each clock signal. explore and generate are trigger inputs which cause the sequence to mutate and re-generate respectively. <code>(probability=0.5, length=8, clock=nullptr, explore=nullptr, generate=nullptr, reset=nullptr)</code></li> <li>RandomImpulse: Generate random impulses at the given frequency, with either uniform or poisson distribution. <code>(frequency=1.0, distribution=SIGNALFLOW_EVENT_DISTRIBUTION_UNIFORM, reset=nullptr)</code></li> <li>RandomUniform: Generates a uniformly random value between min/max. If a clock is passed, only picks a new value on a clock tick. <code>(min=0.0, max=1.0, clock=nullptr, reset=nullptr)</code></li> <li>StochasticNode: StochasticNode <code>(reset=nullptr)</code></li> <li>WhiteNoise: Generates whitenoise between min/max. If frequency is zero, generates at audio rate. For frequencies lower than audio rate, interpolate applies linear interpolation between values, and random_interval specifies whether new random values should be equally-spaced or randomly-spaced. <code>(frequency=0.0, min=-1.0, max=1.0, interpolate=true, random_interval=true, reset=nullptr)</code></li> </ul>"},{"location":"node/","title":"Nodes","text":"<p>A <code>Node</code> object is an audio processing unit that performs one single function. For example, a Node's role may be to synthesize a waveform, read from a buffer, or take two input Nodes and sum their values.</p> <ul> <li>Nodes are played and stopped by connecting them to the AudioGraph </li> <li>A node has one or more audio-rate inputs, which can be modulated by other nodes</li> <li>Some nodes can be triggered with trigger inputs \u2014 for example, to restart playback, or set the position of an envelope</li> <li>Some nodes can be used to play back the contents of buffer inputs, or can use buffer data as a source of modulation</li> <li>The output of multiple nodes can be combined and modulated with use of the standard Python operators (<code>+</code>, <code>-</code>, <code>*</code>, <code>%</code>, etc)</li> <li>The output of a node can be mono (single-channel) or multichannel</li> <li>A Node's status and output can be examined by querying its properties</li> <li>Some Nodes generate unpredictable stochastic output, which can be controlled via its internal random number generator </li> <li>Details of how to create a new Node type are detailed in Developing a new Node class</li> <li>For an overview of every type of Node available in SignalFlow, see the Node Reference Library</li> </ul> <p>\u2192 Next: Node playback</p>"},{"location":"node/developing/","title":"Nodes","text":""},{"location":"node/developing/#developing-new-node-classes","title":"Developing new Node classes","text":"<p>See CONTRIBUTING.md</p>"},{"location":"node/inputs/","title":"Nodes","text":""},{"location":"node/inputs/#node-inputs","title":"Node inputs","text":"<p>A node has three different classes of input:</p> <ul> <li>Audio-rate inputs: Takes the output of another node as an input, for continuous modulation of synthesis parameters</li> <li>Trigger inputs: Used to trigger discrete control events \u2014 for example, restarting buffer playback</li> <li>Buffer inputs: Used to pass the contents of an audio buffer to a node \u2014 for example, as a source of audio samples, or an envelope shape</li> </ul>"},{"location":"node/inputs/#audio-rate-inputs","title":"Audio-rate inputs","text":"<p>Virtually every node has one or more audio-rate inputs. Put simply, an audio-rate input is the output of another node. Let's look at a short example:</p> <pre><code>lfo = SineLFO()\nsignal = SquareOscillator(frequency=200, width=lfo)\n</code></pre> <p>In this case, we are passing the output of a <code>SineLFO</code> as the pulse width of a <code>SquareOscillator</code>. This is an audio-rate input.</p> <p>Although it's not obvious, the <code>frequency</code> parameter is also an audio-rate input. Any constant value (such as the <code>200</code> here) is behind the scenes implemented as a <code>Constant</code> node, which continuously outputs the value at an audio rate.</p> <p>All audio-rate inputs can be modified just like a normal Python property. For example:</p> <pre><code>signal.frequency = TriangleOscillator(0.5, 100, 1000)\n</code></pre>"},{"location":"node/inputs/#variable-input-nodes","title":"Variable input nodes","text":"<p>Some nodes have a variable number of inputs, which can change over the Node's lifetime. For example, <code>Sum()</code> takes an arbitrary number of input Nodes, and generates an output which is the sum of all of its inputs.</p> <p>For variable-input nodes such as this, audio-rate inputs are added with <code>add_input()</code>, and can be removed with <code>remove_input()</code>.</p> <pre><code>a = Constant(1)\nb = Constant(2)\nc = Constant(3)\nsum = Sum()\nsum.add_input(a)\nsum.add_input(b)\nsum.add_input(c)\n# sum will now generate an output of 6.0\n</code></pre> <p>It is possible to check whether a Node object takes variable inputs by querying <code>node.has_variable_inputs</code>.</p>"},{"location":"node/inputs/#triggers","title":"Triggers","text":"<p>When working with sequencing and timing, it is often useful be able to trigger discrete events within a node. This is where trigger inputs come in handy.</p> <p>There are two different ways to handle trigger inputs:</p> <ul> <li>by calling the <code>trigger()</code> method on a <code>Node</code></li> <li>by passing a Node to an input that corresponds to an audio-rate trigger</li> </ul>"},{"location":"node/inputs/#calling-trigger","title":"Calling trigger()","text":"<p>To generate trigger events at arbitrary times, call <code>node.trigger()</code>. For example:</p> <pre><code>freq_env = Line(10000, 100, 0.5)\nsine = SineOscillator(freq_env)\nsine.play()\nwhile True:\n    freq_env.trigger()\n    graph.wait(1)\n</code></pre> <p>This is useful because it can be done outside the audio thread. For example, <code>trigger()</code> could be called each time a MIDI note event is received. </p> <p>The <code>trigger()</code> method takes an optional <code>name</code> parameter, which is used by <code>Node</code> classes containing more than one type of trigger. This example uses the <code>set_position</code> trigger of <code>BufferPlayer</code> to seek to a new location in the sample every second. </p> <pre><code>buffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True)\nplayer.play()\nwhile True:\n    player.trigger(\"set_position\", random_uniform(0, buffer.duration))\n    graph.wait(1)\n</code></pre> <p>Note</p> <p>Because the <code>trigger</code> method happens outside the audio thread, it will take effect at the start of the next audio block. This means that, if you are running at 44.1kHz with an audio buffer size of 1024 samples, this could introduce a latency of up to <code>1024/44100 = 0.023s</code>.   For time-critical events like drum triggers, this can be minimised by reducing the hardware output buffer size.</p> <p>This constraint also means that only one event can be triggered per audio block. To trigger events at a faster rate than the hardware buffer size allows, see Audio-rate triggers below.  </p>"},{"location":"node/inputs/#audio-rate-triggers","title":"Audio-rate triggers","text":"<p>It is often desirable to trigger events using the audio-rate output of another Node object as a source of trigger events, to give sample-level precision in timing. Most nodes that support <code>trigger</code> inputs can also be triggered by a corresponding audio-rate input. </p> <p>Triggers happen at zero-crossings \u2014 that is, when the output of the node passes above zero (i.e., from <code>&lt;= 0</code> to <code>&gt;0</code>). For example, to create a clock with an oscillating tempo to re-trigger buffer playback: </p> <pre><code>clock = Impulse(SineLFO(0.2, 1, 10))\nbuffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True, clock=clock)\nplayer.play()\n</code></pre> <p>This can be used to your advantage with the boolean operator nodes. </p> <pre><code>on_the_right = MouseX() &gt; 0.5\nenvelope = ASREnvelope(0, 0, 0.5, clock=on_the_right)\nsquare = SquareOscillator(100)\noutput = envelope * square * 0.1\noutput.play()\n</code></pre> <p>TODO: Should the name of the trigger() event always be identical to the trigger input name? So <code>clock</code> for envelopes, buffer player, etc...?</p>"},{"location":"node/inputs/#buffer-inputs","title":"Buffer inputs","text":"<p>The third type of input supported by nodes is the buffer. Nodes often take buffer inputs as sources of audio samples. They are also useful as sources of envelope shape data (for example, to shape the grains of a Granulator), or general control data (for example, recording motion patterns from a <code>MouseX</code> input).</p> <pre><code>buffer = Buffer(\"../audio/stereo-count.wav\")\nplayer = BufferPlayer(buffer, loop=True)\n</code></pre> <p>\u2192 Next: Operators</p>"},{"location":"node/multichannel/","title":"Nodes","text":""},{"location":"node/multichannel/#multichannel-nodes","title":"Multichannel nodes","text":"<p>When passing a value to audio-rate input of a Node, the signal is by default monophonic (single-channel). For example, <code>SquareOscillator(440)</code> generates a 1-channel output.</p> <p>It is possible to generate multi-channel output by passing an array of values in the place of a constant. For example, <code>SquareOscillator([440, 880])</code> generates stereo output with a different frequency in the L and R channels. </p> <p>There is no limit to the number of channels that can be generated by a node. For example, <code>SquareOscillator(list(100 + 50 * n for n in range(100)))</code> will create a node with 100-channel output, each with its own frequency. </p> <pre><code>&gt;&gt;&gt; sq = SquareOscillator([100 + 50 * n for n in range(100)])\n&gt;&gt;&gt; print(sq.num_output_channels)\n100\n</code></pre>"},{"location":"node/multichannel/#automatic-upmixing","title":"Automatic upmixing","text":"<p>There are generally multiple inputs connected to a node, which may themselves have differing number of channels. For example, <code>SquareOscillator(frequency=[100, 200, 300, 400, 500], width=0.7)</code> has a 5-channel input and a 1-channel input. In cases like this, the output of the nodes with fewer channels is upmixed to match the higher-channel inputs.</p> <p>Upmixing here means simply duplicating the output until it reaches the desired number of channels. In the above case, the <code>width</code> input will be upmixed to generate 5 channels, all containing <code>0.7</code>.</p> <p>If <code>width</code> were a stereo input with L and R channels, the output would be tiled, alternating between the channels. Each frame of stereo input would then be upmixed to contain <code>[L, R, L, R, L]</code>, where <code>L</code> and <code>R</code> are the samples corresponding to the L and R channels.</p> <p>The key rule is that, for nodes that support upmixing, the output signal has as many channels as the input signal with the highest channel count. </p> <p>This process percolates through the signal chain. For example:</p> <pre><code>SquareOscillator(frequency=SineLFO([1, 3, 5], min=440, max=880),\n                 width=SawLFO([0.5, 0.6], min=0.25, max=0.75))\n</code></pre> <ul> <li>The <code>min</code> and <code>max</code> inputs of the <code>frequency</code> LFO would be upmixed to 3 channels each</li> <li>The <code>min</code> and <code>max</code> inputs of the <code>width</code> LFO would be upmixed to 2 channels each</li> <li>Then, the output of the <code>width</code> node would be upmixed from 2 to 3 channels</li> </ul>"},{"location":"node/multichannel/#nodes-with-fixed-inputoutput-channels","title":"Nodes with fixed input/output channels","text":"<p>Some nodes have immutable numbers of input/output channels. For example:</p> <ul> <li><code>StereoPanner</code> has 1 input channel and 2 output channels</li> <li><code>StereoBalance</code> has 2 input channels and 2 output channels</li> <li><code>ChannelMixer</code> has an arbitrary number of input channels, but a fixed, user-specified number of output channels</li> </ul> <p>Even Nodes that do not have an obvious input (e.g. <code>BufferPlayer</code>) have input channels, for modulation inputs (for example, modulating the rate of the buffer).</p> <p>When two nodes are connected together with incompatible channel counts (for example, connecting a <code>StereoBalance</code> into a <code>StereoMixer</code>), an <code>InvalidChannelCountException</code> will be raised.</p>"},{"location":"node/multichannel/#the-channel-node-classes","title":"The Channel* node classes","text":"<p>There are a number of Node subclasses dedicated to channel handling.</p> <ul> <li>ChannelArray: Concatenates the channels of multiple nodes, so that calling <code>ChannelMix</code> with nodes of <code>N</code> and <code>M</code> channels will produce an output of <code>N + M</code> channels.</li> <li>ChannelMixer: Reduces or expands the number of channels by evenly spreading the audio across the output channels.</li> <li>ChannelSelect: Selects sub-channels of the input, either individually or by group. </li> </ul>"},{"location":"node/multichannel/#querying-channel-subsets-with-the-index-operator","title":"Querying channel subsets with the index operator","text":"<p>Single channels of a multi-channel node can be accessed using the index <code>[]</code> operator. For example:</p> <pre><code>square = SquareOscillator([440, 441, 442, 443])\noutput = square[0]\n# output now contains a mono output, with a frequency of 440Hz.\n</code></pre> <p>Slice syntax can be used to query multiple subchannels:</p> <pre><code>square = SquareOscillator([440, 441, 442, 880])\noutput = square[0:2]\n# now contains a two-channel square wave\n</code></pre> <p>\u2192 Next: Status and properties</p>"},{"location":"node/operators/","title":"Nodes","text":""},{"location":"node/operators/#node-operators","title":"Node operators","text":""},{"location":"node/operators/#arithmetic","title":"Arithmetic","text":"<p>The output of multiple nodes can be combined using Python's mathematical operators. For example, to sum two sine waves together to create harmonics, use the <code>+</code> operator:</p> <pre><code>output = SineOscillator(440) + SineOscillator(880)\noutput.play()\n</code></pre> <p>To modulate the amplitude of one node with another, use the <code>*</code> operator:</p> <pre><code>sine = SineOscillator(440)\nenvelope = ASREnvelope(0.1, 1, 0.1)\noutput = sine * envelope\n</code></pre> <p>You can use constant values in place of <code>Node</code> objects:</p> <pre><code>sine = SineOscillator(440)\nattenuated = sine * 0.5\n</code></pre> <p>Operators can be chained together in the normal way:</p> <pre><code># Create an envelope that rises from 0.5 to 1.0 and back to 0.5\nenv = (ASREnvelope(0.1, 1, 0.1) * 0.5) + 0.5\n</code></pre> <p>Behind the scenes, these operators are actually creating composites of <code>Node</code> subclasses. The last example could alternatively be written as:</p> <pre><code>Add(Multiply(ASREnvelope(0.1, 1, 0.1), 0.5), 0.5)\n</code></pre>"},{"location":"node/operators/#comparison","title":"Comparison","text":"<p>Comparison operators can also be used to compare two Node output values, generating a binary (1/0) output. For example:</p> <pre><code># Generates an output of 1 when the sinusoid is above 0, and 0 otherwise \nSineOscillator(440) &gt; 0\n</code></pre> <p>This can then be used as an input to other nodes. The below will generate a half-wave-rectified sine signal (that is, a sine wave with all negative values set to zero). </p> <pre><code>sine = SineOscillator(440)\nrectified = sine * (sine &gt; 0)\n</code></pre>"},{"location":"node/operators/#index-of-operators","title":"Index of operators","text":"<p>Below is a full list of operators supported by SignalFlow.</p>"},{"location":"node/operators/#arithmetic-operators","title":"Arithmetic operators","text":"Operator Node class <code>+</code> Add <code>-</code> Subtract <code>*</code> Multiply <code>/</code> Divide <code>**</code> Power <code>%</code> Modulo"},{"location":"node/operators/#comparison-operators","title":"Comparison operators","text":"Operator Node class <code>==</code> Equal <code>!=</code> NotEqual <code>&lt;</code> LessThan <code>&lt;=</code> LessThanOrEqual <code>&gt;</code> GreaterThan <code>&gt;=</code> GreaterThanOrEqual <p>\u2192 Next: Multichannel</p>"},{"location":"node/playback/","title":"Nodes","text":""},{"location":"node/playback/#playing-and-stopping-a-node","title":"Playing and stopping a node","text":""},{"location":"node/playback/#starting-playback","title":"Starting playback","text":"<p>To start a node playing, simply call the <code>play()</code> method:</p> <pre><code>graph = AudioGraph()\nnode = SineOscillator(440)\nnode.play()\n</code></pre> <p>This connects the node to the <code>output</code> endpoint of the current global <code>AudioGraph</code>. The next time the graph processes a block of samples, the graph's <code>output</code> node then calls upon the sine oscillator to generate a block.</p> <p>It is important to remember that playing a node means \"connecting it to the graph\". For this reason, it is not possible to play the same node more than once, as it is already connected to the graph. To play multiples of a particular Node type, simply create and play multiple instances.</p>"},{"location":"node/playback/#connecting-a-node-to-another-nodes-input","title":"Connecting a Node to another Node's input","text":"<p>It is often the case that you want to connect a Node to the input of another Node for playback, rather than simply wiring it to the output of a graph -- for example, to pass an oscillator through a processor. In this case, you do not need to call <code>play()</code> (which means \"connect this node to the graph\"). Instead, it is sufficient to simply connect the Node to the input of another Node that is already playing.</p> <p>For example:</p> <pre><code># create and begin playback of a variable input summer, passed through a filter\nsum = Sum()\nflt = SVFilter(sum, \"low_pass\", 200)\nflt.play()\n</code></pre> <p>Now, let's create an oscillator. Observe that connecting the oscillator to the filter's input begins playback immediately.</p> <pre><code>square = SquareOscillator(100)\nsum.add_input(square)\n</code></pre>"},{"location":"node/playback/#stopping-playback","title":"Stopping playback","text":"<p>To stop a node playing:</p> <pre><code>node.stop()\n</code></pre> <p>This disconnects the node from the output device that it is connected to. </p> <p>\u2192 Next: Inputs</p>"},{"location":"node/properties/","title":"Nodes","text":""},{"location":"node/properties/#node-properties","title":"Node properties","text":"<p>A <code>Node</code> has a number of read-only properties which can be used to query its status at a given moment in time.</p> Property Type Description name str Short alphanumeric string that identifies the type of node (for example, <code>asr-envelope</code>) num_output_channels int The number of output channels that the node generates. num_input_channels int The number of input channels that the node takes. Note that most nodes have <code>matches_input_channels</code> set, meaning that their <code>num_input_channels</code> will be automatically increased according to their inputs. To learn more, see Nodes: Multichannel. matches_input_channels bool Whether the node automatically increases its <code>num_input_channels</code> based on its inputs. To learn more, see Nodes: Multichannel. has_variable_inputs bool Whether the node supports an arbitrary number of audio-rate inputs output_buffer numpy.ndarray Contains the Node's most recent audio output, in <code>float32</code> samples. The buffer is indexed by <code>channel</code> x <code>frame</code>, so to obtain the 32nd sample in the first channel, query: <code>node.output_buffer[0][31]</code>. inputs dict A dict containing all of the <code>Node</code>'s audio-rate inputs. Note that buffer inputs are not currently included within this dict. state int The Node's current playback state, which can be one of <code>SIGNALFLOW_NODE_STATE_ACTIVE</code> and <code>SIGNALFLOW_NODE_STATE_STOPPED</code>. The <code>STOPPED</code> state only applies to those nodes which have a finite duration (e.g. <code>ASREnvelope</code>, or <code>BufferPlayer</code> with looping disabled) and have reached the end of playback. Nodes continue to have a state of <code>ACTIVE</code> whether or not they are connected to the graph. patch Patch Indicates the Patch that the node is part of, or None if the Node does not belong to a Patch."},{"location":"node/properties/#monitoring-a-nodes-output","title":"Monitoring a node's output","text":"<p>To monitor the output of a node, call <code>node.poll(num_seconds)</code>, where <code>num_seconds</code> is the interval between messages. This will print the last sample generated by the node to <code>stdout</code>. In the case of multichannel nodes, only the first channel's value is printed.</p> <pre><code>&gt;&gt;&gt; a = Counter(Impulse(1))\n&gt;&gt;&gt; a.poll(1)\n&gt;&gt;&gt; a.play()\ncounter: 0.00000\ncounter: 1.00000\ncounter: 2.00000\n</code></pre> <p>To stop polling a node, call <code>node.poll(0)</code>.</p>"},{"location":"node/properties/#node-specific-properties","title":"Node-specific properties","text":"<p>Some <code>Node</code> classes have additional properties, containing information on implementation-specific states. These can be accessed via the <code>get_property</code> method.</p> <p>For example, the <code>BufferPlayer</code> node exposes a <code>position</code> property, which returns the playhead's current position, in seconds.</p> <pre><code>&gt;&gt;&gt; buffer = Buffer(\"audio.wav\")\n&gt;&gt;&gt; player = BufferPlayer(buffer)\n&gt;&gt;&gt; player.play()\n...\n&gt;&gt;&gt; player.get_property(\"position\")\n5.984000205993652\n</code></pre> <p>\u2192 Next: Stochastic nodes</p>"},{"location":"node/stochastic/","title":"Nodes","text":""},{"location":"node/stochastic/#chance-and-stochastic-nodes","title":"Chance and stochastic nodes","text":"<p>SignalFlow has a number of stochastic nodes, which make use of a pseudo-random number generator (RNG) to produce unpredictable output values.</p> <p>Each object of these <code>StochasticNode</code> subclasses stores its own RNG. By default, the RNG is seeded with a random value, so that each run will generate a different set of outputs. However, to create a repeatable pseudo-random output, the <code>seed</code> of the node's RNG can be set to a known value:</p> <pre><code>&gt;&gt;&gt; r = RandomUniform(0, 1)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.48836085, 0.64326525, 0.79819506, 0.8489549 ], dtype=float32)\n&gt;&gt;&gt; r.set_seed(123)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.7129553 , 0.42847094, 0.6908848 , 0.7191503 ], dtype=float32)\n&gt;&gt;&gt; r.set_seed(123)\n&gt;&gt;&gt; r.process(1024)\n&gt;&gt;&gt; r.output_buffer[0][:4]\narray([0.7129553 , 0.42847094, 0.6908848 , 0.7191503 ], dtype=float32)\n</code></pre> <p>Note the identical sequences generated after repeatedly setting the seed to a known value. </p> <p>Warning</p> <p>Calling <code>node.process()</code> is generally not good practice, as it does not recursively process all of the node's inputs (unlike when a node is embedded within an AudioGraph, which correctly handles recursion and cyclical loops). Please use at your peril!</p> <p>\u2192 Next: Node reference library</p>"},{"location":"patch/","title":"Patch","text":"<p>Warning</p> <p>This documentation is a work-in-progress and may have sections that are missing or incomplete.</p> <p>A <code>Patch</code> represents a connected group of <code>Nodes</code>, analogous to a synthesizer. Defining patches makes it easy to create higher-level structures, which can then be reused and instantiated with a single line of code, in much the same way as a Node.</p> <p>Behind the scenes, the structure of a <code>Patch</code> is encapsulated by a <code>PatchSpec</code>, a template which can be instantiated or serialised to a JSON file for later use.  </p> <ul> <li>A Patch structure is defined either by declaring a Patch subclass or with a JSON specification file</li> <li>Play and stop a Patch by connecting it to the AudioGraph or the input of another Patch or Node </li> <li>Similar to nodes, a Patch can be modulated by audio-rate inputs, triggered by trigger inputs, and access sample data via buffer inputs </li> <li>The outputs of Patches can be altered or combined by normal Python operators</li> <li>The status of a Patch can be queried via its properties </li> <li>Patches can be exported and imported to JSON</li> <li>The auto-free mechanism allows Patches to automatically stop and free their memory after playback is complete </li> </ul> <p>\u2192 Next: Defining a Patch</p>"},{"location":"patch/auto-free/","title":"Patch","text":""},{"location":"patch/auto-free/#auto-free-and-memory-management","title":"Auto-free and memory management","text":"<p>Auto-free.</p>"},{"location":"patch/defining/","title":"Patch","text":""},{"location":"patch/defining/#defining-a-patch","title":"Defining a Patch","text":"<p>A Patch is made up of a connected network of Nodes, together with a set of properties that determine how the Patch can be controlled.</p> <p>There are two general ways to define the structure of a Patch:</p> <ul> <li>Create a new class that subclasses <code>Patch</code>. In general, this is the recommended approach for defining new Patches.</li> <li>Create a JSON file that can be loaded as a <code>PatchSpec</code>, which describes the structure of a patch </li> </ul>"},{"location":"patch/defining/#creating-a-patch-subclass","title":"Creating a Patch subclass","text":"<p>The quickest and most intuitive way to define a <code>Patch</code> is by subclassing the <code>Patch</code> class itself. Let's look at an example.</p> <pre><code>class Bleep (Patch):\n    def __init__(self, frequency=880, duration=0.1):\n        super().__init__()\n        frequency = self.add_input(\"frequency\", frequency)\n        duration = self.add_input(\"duration\", duration)\n        sine = SineOscillator(frequency)\n        env = ASREnvelope(0.001, duration, 0.001)\n        output = sine * env\n        self.set_output(output)\n        self.set_auto_free(True)\n</code></pre> <p>In the above example:</p> <ul> <li>At the very start of the <code>__init__</code> function, <code>super().__init__()</code> must be called to initialise the Patch and its storage. This is vital! Without it, your program will crash. </li> <li>Two audio-rate input parameters are defined. The <code>add_input()</code> method is used to define them as inputs of the <code>Patch</code>, which can then be subsequently modulated. Note that the <code>add_input()</code> method returns a reference to the frequency node, which then acts as a pointer to the input node.</li> <li><code>self.set_output()</code> is used to define the Patch's output. A Patch can only have one single output.</li> <li>Finally, <code>self.set_auto_free()</code> is used to automatically stop and free the Patch after playback of the envelope is completed. More about auto-free... </li> </ul> <p>You can now instantiate a <code>Bleep</code> object in just the same way as you would instantiate and play a Node:</p> <pre><code>b = Bleep(frequency=440, duration=0.2)\nb.play()\n</code></pre> <p>If you query <code>graph.status</code> after playback has finished, you should see that the <code>Patch</code> is automatically freed and the number of nodes returns to 0. </p>"},{"location":"patch/defining/#creating-a-patchspec-from-json","title":"Creating a PatchSpec from JSON","text":"<p>The structure of a <code>Patch</code> is described by a <code>PatchSpec</code>, which can in turn be imported/exported in the JSON text-based data interchange format. </p> <p>For information on loading or saving PatchSpecs as JSON, see Exporting and importing patches.</p> <p>\u2192 Next: Playing and stopping a Patch</p>"},{"location":"patch/exporting/","title":"Patch","text":""},{"location":"patch/exporting/#exporting-and-importing-patches","title":"Exporting and importing patches","text":"<p>A Patch can be exported or imported.</p> <p>\u2192 Next: Auto-free and memory management</p>"},{"location":"patch/inputs/","title":"Patch","text":""},{"location":"patch/inputs/#patch-inputs","title":"Patch inputs","text":"<p>Just like a Node, a Patch supports three different classes of input:</p> <ul> <li>Audio-rate inputs: Takes the output of another Node or Patch as an input, for continuous modulation of synthesis parameters</li> <li>Trigger inputs: Used to trigger discrete control events \u2014 for example, restarting buffer playback</li> <li>Buffer inputs: Used to pass the contents of an audio buffer to a patch \u2014 for example, as a source of audio samples, or an envelope shape</li> </ul>"},{"location":"patch/inputs/#audio-rate-inputs","title":"Audio-rate inputs","text":"<p>A Patch supports any number of user-defined named inputs, which can be used to modulate the nodes within the patch.</p> <p>Each input must be defined by calling <code>add_input()</code> when the Patch is first defined, with an optional default value.</p> <p>Info</p> <p>Note that Patches do not yet support variable inputs.</p> <p>When a Patch is playing, the value of its inputs can be set using <code>patch.set_input()</code>:</p> <pre><code>class Bloop (Patch):\n    def __init__(self, frequency=880, duration=0.1):\n        super().__init__()\n        frequency = self.add_input(\"frequency\", frequency)\n        sine = SineOscillator(frequency)\n        self.set_output(sine)\n        self.set_auto_free(True)\n\nbloop = Bloop()\nbloop.play()\n...\nbloop.set_input(\"frequency\", 100)\n</code></pre> <p>Info</p> <p>Note that Patches do not yet support setting inputs with Python properties (e.g. <code>patch.prop_name = 123</code>), as is possible with node inputs.</p>"},{"location":"patch/inputs/#triggers","title":"Triggers","text":"<p>When defining a <code>Patch</code>, it is possible to define which Node should receive <code>trigger()</code> events sent to the Patch. This is done with <code>patch.set_trigger_node()</code>:</p> <pre><code>class Hat (Patch):\n    def __init__(self, duration=0.1):\n        super().__init__()\n        duration = self.add_input(\"duration\", duration)\n        noise = WhiteNoise()\n        env = ASREnvelope(0.0001, 0.0, duration, curve=2)\n        output = noise * env\n        self.set_trigger_node(env)\n        self.set_output(output)\n\nh = Hat()\nh.play()\n...\nh.trigger() # triggers a hit, resetting the ASREnvelope to its start point\n</code></pre> <p>This can be used to create a <code>Patch</code> that stays connected to the AudioGraph and can be retriggered to play a hit.</p> <p>Info</p> <p>Note that Patches only presently support trigger events directed to a single node within the patch, and cannot route triggers to multiple different nodes.</p>"},{"location":"patch/inputs/#buffer-inputs","title":"Buffer inputs","text":"<p>Buffer inputs can be declared at define time by calling <code>self.add_buffer_input()</code>. Similar to <code>add_input</code>, the return value is a placeholder <code>Buffer</code> that can be used wherever you would normally pass a <code>Buffer</code>:</p> <pre><code>class WobblyPlayer (Patch):\n    def __init__(self, buffer):\n        super().__init__()\n        buffer = self.add_buffer_input(\"buffer\", buffer)\n        rate = SineLFO(0.2, 0.5, 1.5)\n        player = BufferPlayer(buffer, rate=rate, loop=True)\n        self.set_output(player)\n\nbuffer = Buffer(\"examples/audio/stereo-count.wav\")\nplayer = WobblyPlayer(buffer)\nplayer.play()\n</code></pre> <p>The buffer can then be replaced at runtime by calling <code>set_input()</code>:</p> <pre><code>player.set_input(\"buffer\", another_buffer)\n</code></pre> <p>\u2192 Next: Operators</p>"},{"location":"patch/operators/","title":"Patch","text":""},{"location":"patch/operators/#operators","title":"Operators","text":"<p>The output of a Patch can be amplified, attenuated, combined, modulated and compared using Python operators, in much the same way as Node:</p> <pre><code>patch = Patch(patch_spec)\noutput = patch * 0.5\n</code></pre> <p>For a full list of the operators that can be applied to a <code>Patch</code>, see Node operators.</p> <p>\u2192 Next: Patch properties</p>"},{"location":"patch/playback/","title":"Patch","text":""},{"location":"patch/playback/#playing-a-patch","title":"Playing a Patch","text":"<p>Once a <code>Patch</code> has been defined or imported, it can be instantiated in two different ways depending on how it was defined:</p> <ul> <li>From a Patch subclass</li> <li>From a PatchSpec</li> </ul>"},{"location":"patch/playback/#from-a-patch-subclass","title":"From a Patch subclass","text":"<p>The simplest way to instantiate a Patch is by defining it as a Patch subclass, and then instantiating it in the same way as a Node. </p> <pre><code>class Hat (Patch):\n    def __init__(self, duration=0.1):\n        super().__init__()\n        duration = self.add_input(\"duration\", duration)\n        noise = WhiteNoise()\n        env = ASREnvelope(0.0001, 0.0, duration, curve=2)\n        output = noise * env\n        self.set_output(output)\n        self.set_auto_free(True)\n\nhat = Hat()\nhat.play()\n</code></pre> <p>Once a Patch has finished, its state changes to <code>SIGNALFLOW_PATCH_STATE_STOPPED</code>.</p> <p>Just as with nodes, it is important to remember that playing a patch means \"connecting it to the graph\". For this reason, it is not possible to play the same patch more than once, as it is already connected to the graph.</p> <p>To play multiples of a particular <code>Patch</code> type, simply create and play multiple instances.</p>"},{"location":"patch/playback/#from-a-patchspec","title":"From a PatchSpec","text":"<p>Once a <code>PatchSpec</code> has been created or imported, it can be played by instantiating a <code>Patch</code> with the <code>PatchSpec</code> as an argument:</p> <pre><code>patch = Patch(patch_spec)\npatch.play()\n</code></pre>"},{"location":"patch/playback/#connecting-a-patch-to-another-patchs-input","title":"Connecting a Patch to another Patch's input","text":"<p>A <code>Patch</code> can be connected to the input of another <code>Patch</code> (or Node), in exactly the same way described in Connecting a Node to another Node's input.</p> <p>Once you have got to grips with this paradigm, it becomes simple to build up sophisticated processing graphs by abstracting complex functionality within individual <code>Patch</code> objects, and connecting them to one another. </p>"},{"location":"patch/playback/#stopping-a-patch","title":"Stopping a Patch","text":"<p>As in Node playback, stopping a Patch disconnects it from the AudioGraph. Patches with auto-free are automatically stopped when their lifetimes ends. Patches with an unlimited lifespan must be stopped manually, with:</p> <pre><code>patch.stop()\n</code></pre> <p>This disconnects the Patch from its output.</p> <p>\u2192 Next: Patch inputs</p>"},{"location":"patch/properties/","title":"Patch","text":""},{"location":"patch/properties/#patch-properties","title":"Patch properties","text":"Property Type Description nodes list A list of all of the Node objects that make up this Patch inputs dict A dict of key-value pairs corresponding to all of the (audio rate) inputs within the Patch state int The Patch's current playback state, which can be <code>SIGNALFLOW_PATCH_STATE_ACTIVE</code> or <code>SIGNALFLOW_PATCH_STATE_STOPPED</code>. graph AudioGraph A reference to the AudioGraph that the Patch is part of <p>\u2192 Next: Exporting and importing patches</p>"},{"location":"planning/NAMING/","title":"NAMING","text":""},{"location":"planning/NAMING/#nodes","title":"NODES","text":"<p>Generators  - Oscillators    - Wavetable    - Waveforms (all wrappers around Wavetable with band-limiting)      - SineOscillator      - SquareOscillator      - TriangleOscillator      - SawOscillator  - LFO (all wrappers around Wavetable)    - SineLFO    - SquareLFO    - TriangleLFO    - SawLFO  - Buffer    - BufferPlayer    - BufferRecorder  - Stochastic    -  Processors  - Panners    - ChannelMixer    - LinearPanner    - AzimuthPanner    - ObjectPanner  - Delay    - AllpassDelay    - Delay  - Effects    - EQ    - Gate    - Resampler    - Waveshaper</p> <p>Stochastic  - Random signal generators    - WhiteNoise    - PinkNoise     - BrownNoise    - PerlinNoise  - Random number generators (with clocked inputs)    - RandomUniform    - RandomLinear    - RandomBrownian    - RandomExponentialDist    - RandomGaussian    - RandomBeta  - Random event generators    - RandomImpulse</p> <p>-- PATCHES  - Patch  - PatchDef</p>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index d2083ce8..453e67eb 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ