add moar

docs/content/attrib.rst

@@ -30,7 +30,9 @@ SousaFX Max Patches
 
 - `Rusty Allred <https://web.archive.org/web/20071003115434/http://www.planetanalog.com/article/printableArticle.jhtml?articleID=12802683>`_, `Trond Lossius <https://github.com/jamoma/JamomaCore/blob/master/DSP/extensions/FilterLib/source/TTLowpassLinkwitzRiley4.cpp>`_, `Timothy Place <https://cycling74.com/tutorials/crossover-filter-design-video-tutorial>`_, `J Curtis <https://cycling74.com/tutorials/crossover-filter-design-video-tutorial#reply-5e4377db8a6f416613deaf7c>`_ // 4th-order `Linkwitz Riley <https://www.linkwitzlab.com/publications.htm#17%20-%20Active%20Crossover%20Networks%20for%20Noncoincident%20Drivers>`_ Crossover Filter
 
-- `nik gaffney <https://github.com/zzkt/oblique-strategies>`_ // `do it home <https://curatorsintl.org/records/20290-do-it-home>`_ & `Prompts for Programmers <https://web.archive.org/web/20230817122306/https://kevinlawler.com/prompts>`_
+- `zzkt <https://github.com/zzkt/oblique-strategies>`_ // `do it home <https://curatorsintl.org/records/20290-do-it-home>`_ & `Prompts for Programmers <https://web.archive.org/web/20230817122306/https://kevinlawler.com/prompts>`_
+
+- Christopher Dobrian // `taptempo max patch <https://cycling74.com/forums/how-to-create-a-tap-tempo-in-max?replyPage=1#reply-58ed2104c2991221d9cc65fd>`_
 
 
 SousaVFX Max Patches

docs/content/install.rst

@@ -6,13 +6,13 @@ Required
 
 1. `Download Max <https://cycling74.com/downloads>`_ from Cycling '74. 
 
-2. Open Max, click "Menubar > Max > Preferences...", and set the following preferences:
+2. Open Max, click ``Menubar > Max > Preferences...``, and set the following preferences:
 
     - Interface > Restore Windows on Launch [uncheck]
 
     - Mixer > Enable Mixer Parallel Processing [check]
 
-3. Click "Menubar > File > Show Package Manager", and install the following packages:
+3. Click ``Menubar > File > Show Package Manager``, and install the following packages:
 
     - ease
 
@@ -24,7 +24,7 @@ Required
 
 4. There will probably be a bunch of operating system security settings that you have to enable for Max as well.
 
-5. `Download sousastep <https://github.com/Sousastep/sousastep/releases/latest>`_ to your `~/Documents/Max 8/Projects/` folder. `sousastep` contains SousaFX, SousaVFX, and SousaPlayback.
+5. `Download sousastep <https://github.com/Sousastep/sousastep/releases/latest>`_ to your ``~/Documents/Max 8/Projects/`` folder. ``sousastep`` contains SousaFX, SousaVFX, and SousaPlayback.
 
 .. note::
 
@@ -33,9 +33,9 @@ Required
 Optional
 --------
 
-6. To open the SousaPlayback template project "~/Documents/Max 8/Projects/sousastep/default/SousaPlayback template Project/SousaPlayback template.als", `download Live Suite <https://www.ableton.com/en/trial/>`_ from Ableton.
+6. To open the SousaPlayback template project ``~/Documents/Max 8/Projects/sousastep/default/SousaPlayback template Project/SousaPlayback template.als``, `download Live Suite <https://www.ableton.com/en/trial/>`_ from Ableton.
 
-    Open Live, click "Menubar > Live > Settings...", and set the following preferences:
+    Open Live, click ``Menubar > Live > Settings...``, and set the following preferences:
 
     - Audio > Audio Device [set preferred interface]
 
@@ -53,16 +53,16 @@ Optional
 
     The SousaPlayback template project will not work after Ableton Live's `free trial <https://www.ableton.com/en/trial/>`_ ends. The template uses a few Max for live devices that require Ableton Live 11/12 `Suite or Standard with the Max for Live addon <https://help.ableton.com/hc/en-us/articles/360000036850-Max-for-Live-bundled-in-Live>`_.
 
-7. Download Black Octopus Sound's `excellent free samples <https://blackoctopus-sound.com/product/free-1gb-of-black-octopus-samples/>`_ and place `Black Octopus Sound - Free Samples Bundle` into "~/Documents/Max 8/Projects/sousastep/SousaFX/default/SousaPlayback template Project/Clips/"
+7. Download Black Octopus Sound's `excellent free samples <https://blackoctopus-sound.com/product/free-1gb-of-black-octopus-samples/>`_ and place `Black Octopus Sound - Free Samples Bundle` into ``~/Documents/Max 8/Projects/sousastep/SousaFX/default/SousaPlayback template Project/Clips/``
 
 Updating
 --------
 
 .. important::
 
     When updating to new versions of SousaFX, 
-    copy all files from "~/Documents/Max 8/Projects/sousastep/SousaFX/data/" 
-    to the new version's "sousastep/SousaFX/data/" folder 
+    copy all files from ``~/Documents/Max 8/Projects/sousastep/SousaFX/data/`` 
+    to the new version's ``sousastep/SousaFX/data/`` folder 
     to ensure that your presets are carried over.
 
 Recommended Free Plugins

docs/content/menubar.rst

@@ -0,0 +1,30 @@
+Menubar
+=======
+
+	- About SousaFX…
+
+	- 🔊 SousaFX
+	- 🌊 Modulation
+	- 🦅 Attack
+	- 🪴 Sustain
+	- ⚔️ Envelope Crossfade
+	- 📬 Post-Crossfade
+	- ⏳ Delay & Reverb Sends
+	- ♻️ Loopers
+	- 🥾 Kick Ducker
+	- 🎧 Monitor Mix
+	- ⚙️ Settings
+	- 🎮 Controller Bindings/B
+	- ☠️ Deadzones
+
+	- 🥁 Tempo/T
+
+	- 🎛 MIDI IO/{
+	- 🎙 Audio IO/}
+	- 🔈 Audio Status.../|
+	- 🛟 Support
+
+	- 📙 Documentation
+	- 🐞 Report a Bug;
+	- 👾 Join the Discord;
+	- 🥺 Donate;

docs/content/metro.rst

@@ -4,4 +4,60 @@ Metronome
 .. image:: media/metro.png
    :width: 60%
    :align: center
-   :alt: metro
+   :alt: metro
+
+Tempo Source
+------------
+
+- Tap Tempo: Tempo set by tapping. Metronome resets when unmuted, so be sure to unmute on the downbeat. LFO retriggered by "transient detection", and by unmuting the metronome
+
+   This is best when playing freely, without a click.
+
+- Ableton's Tempo: Tempo, LFO, and Metronome all locked to Ableton Live.
+
+   This is best when playing along with clips in Live.
+
+- Metronome's Tempo When On: When the metronome's muted, the LFO is retriggered by transient detection. When metronome is active, the LFO is locked to the metronome. The metronome resets when unmuted, so be sure to unmute on the downbeat. 
+
+   This is best when playing with folks who can monitor a click. 
+   For example: The drummer can improvise a groove at any tempo, 
+   and you can tap tempo along. Then you can unmute the metronome 
+   on the downbeat, the LFO will lock to the metronome, 
+   and the drummer can listen to the click.
+
+- Metronome's tempo always: The metronome is free-running and isn't reset when unmuted. The LFO is locked to the metronome while muted and unmuted.
+
+   tbh i never use this one
+
+Audio Input or Live Link
+------------------------
+
+When the Tempo Source is Ableton's Tempo, this setting picks wether Ableton's sync signal comes from the "phasor1n" Max For Live device, or Live Link.
+
+Live Link is simple to set up, but gets offbeat if the tempo changes suddenly.
+
+The "phasor1n" Max For Live device sends a 1-bar-long phasor audio signal out of Live and into Max. It's always in time, but you have to set up the audio route from Live to Max yourself, and you have to be sure to never route this signal to a speaker, or else you'll hear a pop once per bar.
+
+Which Beats
+-----------
+
+Pick which beats the metronome should emit a click on.
+
+- click on 1 & 3
+
+- click on 1 2 3 & 4
+
+Continuous Accelerando
+----------------------
+
+The continuous accelerando affects the Metronome, Modulation, Loopers, and Drum Clips.
+
+"Bars Per Accel Loop" sets how long it takes for a continuous accelerando to reach its original tempo
+
+When Continuous Accelerando is toggled off, the number of seconds remaining in the accel loop is displayed, and the accel ceases once the original tempo is reached.
+
+My two favorite examples of continuous accelerandos:
+
+ - `Autechre Fold4 Wrap5 <https://www.youtube.com/watch?v=vUioVGqfu6s>`_
+
+ - `Vijay Iyer Historicity <https://www.youtube.com/watch?v=PG6UwES2laU&t=371s>`_

docs/content/startup.rst

@@ -8,7 +8,7 @@
    :align: center
    :alt: startup
 
-Select your preferred audio interface, then uncheck the pause button. :ref:`SousaFX will appear momentarily <SousaFX Main Window>`. It takes a couple minutes to boot, but while it does, you may ponder a randomly selected prompt from :ref:`"Do It (Home)", or "Prompts for Programmers" <prompts>`.
+Select your preferred audio interface, then uncheck the pause button. :ref:`SousaFX will appear momentarily <SousaFX Main Window>`. It takes a couple minutes to boot, but while it does, you may ponder a randomly selected prompt from :ref:`"Do It (Home)", or "Prompts for Programmers" <SousaFX Max Patches>`.
 
 .. note::