Merge branch 'main' into patterns-tab

2023-10-29 13:05:25 +01:00 · 2023-10-29 13:05:25 +01:00 · b15f7bcf45
commit b15f7bcf45
parent dc254bd562 f16cb8f7d2
86 changed files with 4701 additions and 2624 deletions
--- a/website/README.md
+++ b/website/README.md
@ -1,6 +1,6 @@
 # Strudel Website

-This is the website for Strudel, deployed at [strudel.tidalcycles.org](https://strudel.tidalcycles.org/).
+This is the website for Strudel, deployed at [strudel.cc](https://strudel.cc).
 It includes the REPL live coding editor and the documentation site.

 ## Run locally
--- a/website/agpl-header.txt
+++ b/website/agpl-header.txt
@ -1,7 +1,7 @@
 /* 

 Strudel - javascript-based environment for live coding algorithmic (musical) patterns
-https://strudel.tidalcycles.org / https://github.com/tidalcycles/strudel/
+https://strudel.cc / https://github.com/tidalcycles/strudel/

 Copyright (C) Strudel contributors 
 https://github.com/tidalcycles/strudel/graphs/contributors
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@ -11,7 +11,7 @@ import tailwind from '@astrojs/tailwind';
 import AstroPWA from '@vite-pwa/astro';
 // import { visualizer } from 'rollup-plugin-visualizer';

-const site = `https://strudel.tidalcycles.org/`; // root url without a path
+const site = `https://strudel.cc/`; // root url without a path
 const base = '/'; // base path of the strudel site

 // this rehype plugin converts relative anchor links to absolute ones
--- a/website/package.json
+++ b/website/package.json
@ -34,6 +34,8 @@
    "@strudel.cycles/transpiler": "workspace:*",
    "@strudel.cycles/webaudio": "workspace:*",
    "@strudel.cycles/xen": "workspace:*",
+    "@strudel/hydra": "workspace:*",
+    "@strudel/codemirror": "workspace:*",
    "@strudel/desktopbridge": "workspace:*",
    "@supabase/supabase-js": "^2.21.0",
    "@tailwindcss/forms": "^0.5.3",
@ -58,9 +60,9 @@
    "tailwindcss": "^3.3.2"
  },
  "devDependencies": {
-    "@vite-pwa/astro": "^0.0.5",
+    "@vite-pwa/astro": "file:vite-pwa-astro-0.1.3.tgz",
    "html-escaper": "^3.0.3",
-    "vite-plugin-pwa": "^0.14.7",
-    "workbox-window": "^6.5.4"
+    "vite-plugin-pwa": "^0.16.5",
+    "workbox-window": "^7.0.0"
  }
 }
--- a/website/public/CNAME
+++ b/website/public/CNAME
@ -1 +1 @@
-strudel.tidalcycles.org
+strudel.cc
--- a/website/src/config.ts
+++ b/website/src/config.ts
@ -6,7 +6,7 @@ export const SITE = {

 export const OPEN_GRAPH = {
  image: {
-    src: 'https://strudel.tidalcycles.org/icon.png',
+    src: 'https://strudel.cc/icon.png',
    alt: 'Strudel Logo',
  },
 };
@ -70,14 +70,13 @@ export const SIDEBAR: Sidebar = {
      { text: 'MIDI & OSC', link: 'learn/input-output' },
    ],
    More: [
+      { text: 'Recipes', link: 'recipes/recipes' },
      { text: 'Mini-Notation', link: 'learn/mini-notation' },
-      { text: 'Coding syntax', link: 'learn/code' },
      { text: 'Offline', link: 'learn/pwa' },
      { text: 'Patterns', link: 'technical-manual/patterns' },
-      { text: 'Pattern Alignment', link: 'technical-manual/alignment' },
-      { text: 'Strudel vs Tidal', link: 'learn/strudel-vs-tidal' },
      { text: 'Music metadata', link: 'learn/metadata' },
      { text: 'CSound', link: 'learn/csound' },
+      { text: 'Hydra', link: 'learn/hydra' },
    ],
    'Pattern Functions': [
      { text: 'Introduction', link: 'functions/intro' },
@ -89,7 +88,13 @@ export const SIDEBAR: Sidebar = {
      { text: 'Accumulation', link: 'learn/accumulation' },
      { text: 'Tonal Functions', link: 'learn/tonal' },
    ],
-    Understand: [{ text: 'Pitch', link: 'understand/pitch' }],
+    Understand: [
+      { text: 'Coding syntax', link: 'learn/code' },
+      { text: 'Pitch', link: 'understand/pitch' },
+      { text: 'Cycles', link: 'understand/cycles' },
+      { text: 'Pattern Alignment', link: 'technical-manual/alignment' },
+      { text: 'Strudel vs Tidal', link: 'learn/strudel-vs-tidal' },
+    ],
    Development: [
      { text: 'REPL', link: 'technical-manual/repl' },
      { text: 'Sounds', link: 'technical-manual/sounds' },
--- a/website/src/docs/MiniRepl.jsx
+++ b/website/src/docs/MiniRepl.jsx
@ -20,6 +20,7 @@ if (typeof window !== 'undefined') {
    import('@strudel.cycles/osc'),
    import('@strudel.cycles/csound'),
    import('@strudel.cycles/soundfonts'),
+    import('@strudel/hydra'),
  );
 }

--- a/website/src/pages/de/workshop/getting-started.mdx
+++ b/website/src/pages/de/workshop/getting-started.mdx
@ -22,7 +22,7 @@ in der Muster eine Rolle spielen.

 Du brauchst keine Erfahrung in JavaScript oder Tidal Cycles um mit Strudel Musik zu machen.
 Dieser interaktive Workshop leitet dich spielerisch durch die Grundlagen von Strudel.
-Der beste Ort um mit Strudel Musik zu machen ist das [Strudel REPL](https://strudel.tidalcycles.org/).
+Der beste Ort um mit Strudel Musik zu machen ist das [Strudel REPL](https://strudel.cc/).

 ## Was kann man mit Strudel machen?

@ -66,7 +66,7 @@ Hier ist ein Beispiel wie Strudel klingen kann:

 Mehr Beispiele gibt es [hier](/examples).

-Du kannst auch im [Strudel REPL](https://strudel.tidalcycles.org/) auf `shuffle` klicken um ein zufälliges Beispiel zu hören.
+Du kannst auch im [Strudel REPL](https://strudel.cc/) auf `shuffle` klicken um ein zufälliges Beispiel zu hören.

 ## Workshop

--- a/website/src/pages/learn/effects.mdx
+++ b/website/src/pages/learn/effects.mdx
@ -144,6 +144,14 @@ There is one filter envelope for each filter type and thus one set of envelope f

 <JsDoc client:idle name="velocity" h={0} />

+## compressor
+
+<JsDoc client:idle name="compressor" h={0} />
+
+## postgain
+
+<JsDoc client:idle name="postgain" h={0} />
+
 # Panning

 ## jux
@ -183,24 +191,44 @@ global effects use the same chain for all events of the same orbit:

 <JsDoc client:idle name="orbit" h={0} />

-## delay
+## Delay
+
+### delay

 <JsDoc client:idle name="delay" h={0} />

-## delaytime
+### delaytime

 <JsDoc client:idle name="delaytime" h={0} />

-## delayfeedback
+### delayfeedback

 <JsDoc client:idle name="delayfeedback" h={0} />

-## room
+## Reverb
+
+### room

 <JsDoc client:idle name="room" h={0} />

-## roomsize
+### roomsize

 <JsDoc client:idle name="roomsize" h={0} />

+### roomfade
+
+<JsDoc client:idle name="roomfade" h={0} />
+
+### roomlp
+
+<JsDoc client:idle name="roomlp" h={0} />
+
+### roomdim
+
+<JsDoc client:idle name="roomdim" h={0} />
+
+### iresponse
+
+<JsDoc client:idle name="iresponse" h={0} />
+
 Next, we'll look at strudel's support for [Csound](/learn/csound).
--- a/website/src/pages/learn/getting-started.mdx
+++ b/website/src/pages/learn/getting-started.mdx
@ -10,11 +10,11 @@ import { JsDoc } from '../../docs/JsDoc';

 Welcome to the Strudel documentation pages!

-These pages will introduce you to [Strudel](https://strudel.tidalcycles.org/), a web-based [live coding](https://github.com/toplap/awesome-livecoding/) environment that implements the [Tidal Cycles](https://tidalcycles.org) algorithmic pattern language.
+These pages will introduce you to [Strudel](https://strudel.cc/), a web-based [live coding](https://github.com/toplap/awesome-livecoding/) environment that implements the [Tidal Cycles](https://tidalcycles.org) algorithmic pattern language.

 # What is Strudel?

-[Strudel](https://strudel.tidalcycles.org/) is a version of [Tidal Cycles](https://tidalcycles.org) written in [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript), initiated by [Alex McLean](https://slab.org) and [Felix Roos](https://github.com/felixroos) in 2022.
+[Strudel](https://strudel.cc/) is a version of [Tidal Cycles](https://tidalcycles.org) written in [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript), initiated by [Alex McLean](https://slab.org) and [Felix Roos](https://github.com/felixroos) in 2022.
 Tidal Cycles, also known as Tidal, is a language for [algorithmic pattern](https://algorithmicpattern.org), and though it is most commonly used for [making music](https://tidalcycles.org/docs/showcase), it can be used for any kind of pattern making activity, including [weaving](https://www.youtube.com/watch?v=TfEmEsusXjU).

 Tidal was first implemented as a library written in the [Haskell](https://www.haskell.org/) functional programming language, and by itself it does not make any sound.
@ -24,7 +24,7 @@ Strudel however runs directly in your web browser, does not require any custom s

 # Strudel REPL and MiniREPL

-The main place to actually make music with Strudel is the [Strudel REPL](https://strudel.tidalcycles.org/) ([what is a REPL?](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop)), but in these pages you will also encounter interactive "MiniREPLs" where you can listen to and edit Strudel patterns.
+The main place to actually make music with Strudel is the [Strudel REPL](https://strudel.cc/) ([what is a REPL?](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop)), but in these pages you will also encounter interactive "MiniREPLs" where you can listen to and edit Strudel patterns.
 Try clicking the play icon below:

 <MiniRepl client:idle tune={`s("bd sd")`} punchcard />
@ -38,7 +38,7 @@ This interactive tutorial will guide you through the basics of Strudel.

 # Show me some demos!

-To see and hear what Strudel can do, visit the [Strudel REPL](https://strudel.tidalcycles.org/) and click the Shuffle icon in the top menu bar.
+To see and hear what Strudel can do, visit the [Strudel REPL](https://strudel.cc/) and click the Shuffle icon in the top menu bar.
 You can get a feel for Strudel by browsing and editing these examples and clicking the Refresh icon to update.

 You can also browse through the examples [here](./examples).
--- a/website/src/pages/learn/hydra.mdx
+++ b/website/src/pages/learn/hydra.mdx
@ -0,0 +1,55 @@
+---
+title: Hydra
+layout: ../../layouts/MainLayout.astro
+---
+
+import { MiniRepl } from '../../docs/MiniRepl';
+
+# Using Hydra inside Strudel
+
+You can write [hydra](https://hydra.ojack.xyz/) code in strudel! All you have to do is to call `await initHydra()` at the top:
+
+<MiniRepl
+  client:only="react"
+  tune={`await initHydra()
+// licensed with CC BY-NC-SA 4.0 https://creativecommons.org/licenses/by-nc-sa/4.0/
+// by Zach Krall
+// http://zachkrall.online/
+
+osc(10, 0.9, 300)
+.color(0.9, 0.7, 0.8)
+.diff(
+osc(45, 0.3, 100)
+.color(0.9, 0.9, 0.9)
+.rotate(0.18)
+.pixelate(12)
+.kaleid()
+)
+.scrollX(10)
+.colorama()
+.luma()
+.repeatX(4)
+.repeatY(4)
+.modulate(
+osc(1, -0.9, 300)
+)
+.scale(2)
+.out()
+
+note("[a,c,e,<a4 ab4 g4 gb4>,b4]/4").s("sawtooth").vib(2)
+.lpf(600).lpa(2).lpenv(6)
+`}
+/>
+
+There is a special function `H` that allows you to use a pattern as an input to hydra:
+
+<MiniRepl
+  client:only="react"
+  tune={`await initHydra()
+let pattern = "3 4 5 [6 7]*2"
+shape(H(pattern)).out(o0)
+n(pattern).scale("A:minor").piano().room(1) 
+`}
+/>
+
+You might now be able to see this properly here: [open in REPL](/#YXdhaXQgaW5pdEh5ZHJhKCkKbGV0IHBhdHRlcm4gPSAiMyA0IDUgWzYgN10qMiIKc2hhcGUoSChwYXR0ZXJuKSkub3V0KG8wKQpuKHBhdHRlcm4pLnNjYWxlKCJBOm1pbm9yIikucGlhbm8oKS5yb29tKDEpIA%3D%3D)
--- a/website/src/pages/learn/input-output.mdx
+++ b/website/src/pages/learn/input-output.mdx
@ -71,7 +71,7 @@ Now you're all set!
 ## Usage

 1. Start SuperCollider, either using SuperCollider IDE or by running `sclang` in a terminal
-2. Open the [Strudel REPL](https://strudel.tidalcycles.org/#cygiYmQgc2QiKS5vc2MoKQ%3D%3D)
+2. Open the [Strudel REPL](https://strudel.cc/#cygiYmQgc2QiKS5vc2MoKQ%3D%3D)

 ...or test it here:

--- a/website/src/pages/learn/metadata.mdx
+++ b/website/src/pages/learn/metadata.mdx
@ -18,7 +18,7 @@ You can optionally add some music metadata in your Strudel code, by using tags i

 Like other comments, those are ignored by Strudel, but it can be used by other tools to retrieve some information about the music.

-It is for instance used by the [swatch tool](https://github.com/tidalcycles/strudel/tree/main/my-patterns) to display pattern titles in the [examples page](https://strudel.tidalcycles.org/examples/).
+It is for instance used by the [swatch tool](https://github.com/tidalcycles/strudel/tree/main/my-patterns) to display pattern titles in the [examples page](https://strudel.cc/examples/).

 ## Alternative syntax

--- a/website/src/pages/learn/pwa.mdx
+++ b/website/src/pages/learn/pwa.mdx
@ -5,7 +5,7 @@ layout: ../../layouts/MainLayout.astro

 # Using Strudel Offline

-You can use Strudel even without a network! When you first visit the [Strudel REPL](strudel.tidalcycles.org/),
+You can use Strudel even without a network! When you first visit the [Strudel REPL](https://strudel.cc/),
 your browser will download the whole web app including documentation.
 When the download is finished (&lt;1MB), you can visit the website even when offline,
 getting the downloaded website instead of the online one.
@ -32,7 +32,7 @@ You can view all cached files in your browser.
 ### Firefox

 - Open the Developer Tools (`Tools > Web Developer > Web Developer Tools`)
- go to `Storage` tab and expand `Cache Storage > https://strudel.tidalcycles.org`.
+- go to `Storage` tab and expand `Cache Storage > https://strudel.cc`.
 - or go to the `Application` tab and view the latest updates in `Service Workers`

 ### Chromium based Browsers
@ -57,14 +57,14 @@ without the browser ui.

 With a chromium based browser:

-1. go to the [Strudel REPL](strudel.tidalcycles.org/).
+1. go to the [Strudel REPL](https://strudel.cc).
 2. on the right of the adress bar, click `install Strudel REPL`
 3. the REPL should now run as a standalone chromium app

 Without a chromium based browser, you can use [nativefier](https://github.com/nativefier/nativefier) to generate a desktop app:

 1. make sure you have NodeJS installed
-2. run `npx nativefier strudel.tidalcycles.org`
+2. run `npx nativefier strudel.cc`

 <figure>
  <img src="./pwa/strudel-linux.png" alt="Strudel on Linux" />
@ -73,13 +73,13 @@ Without a chromium based browser, you can use [nativefier](https://github.com/na

 ### iOS

-1. open to the [Strudel REPL](strudel.tidalcycles.org/) in safari
+1. open to the [Strudel REPL](https://strudel.cc/) in safari
 2. press the share icon and tab `Add to homescreen`
 3. You should now have a strudel app icon that opens the repl in full screen

 ### Android

-1. open to the [Strudel REPL](strudel.tidalcycles.org/)
+1. open to the [Strudel REPL](https://strudel.cc/)
 2. Tab the install button at the bottom

 Ok, what are [Patterns](/technical-manual/patterns) all about?
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@ -46,7 +46,7 @@ For drum sounds, strudel uses the comprehensive [tidal-drum-machines](https://gi

 Furthermore, strudel also loads instrument samples from [VCSL](https://github.com/sgossner/VCSL) by default.

-To see which sample names are available, open the `sounds` tab in the [REPL](https://strudel.tidalcycles.org/).
+To see which sample names are available, open the `sounds` tab in the [REPL](https://strudel.cc/).

 Note that only the sample maps (mapping names to URLs) are loaded initially, while the audio samples themselves are not loaded until they are actually played.
 This behaviour of loading things only when they are needed is also called `lazy loading`.
@ -283,7 +283,7 @@ With it, you can enter any sample name(s) to query from [freesound.org](https://

 <MiniRepl
  client:idle
-  tune={`await samples('https://shabda.ndre.gr/bass:4,hihat:4,rimshot:2.json?strudel=1')
+  tune={`await samples('shabda:bass:4,hihat:4,rimshot:2')
 stack(
  n("0 1 2 3").s('bass').slow(2),
  n("0 1*2 2 3*2").s('hihat'),
@ -291,6 +291,19 @@ stack(
 ).clip(1)`}
 />

+You can also generate artificial voice samples with any text, in multiple languages.
+Note that the language code and the gender parameters are optional and default to `en-GB` and `f`
+
+<MiniRepl
+  client:idle
+  tune={`await samples('shabda/speech:the_drum,forever')
+await samples('shabda/speech/fr-FR/m:magnifique')
+stack(
+  s("the_drum").chop(16).speed(rand.range(0.85,1.1)),
+  s("forever magnifique").slow(8).late(0.25)
+)`}
+/>
+
 # Sampler Effects

 Sampler effects are functions that can be used to change the behaviour of sample playback.
@ -335,6 +348,10 @@ Sampler effects are functions that can be used to change the behaviour of sample

 <JsDoc client:idle name="Pattern.chop" h={0} />

+### striate
+
+<JsDoc client:idle name="Pattern.striate" h={0} />
+
 ### slice

 <JsDoc client:idle name="Pattern.slice" h={0} />
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@ -23,6 +23,25 @@ The basic waveforms are `sine`, `sawtooth`, `square` and `triangle`, which can b

 If you don't set a `sound` but a `note` the default value for `sound` is `triangle`!

+## Noise
+
+You can also use noise as a source by setting the waveform to: `white`, `pink` or `brown`. These are different
+flavours of noise, here written from hard to soft.
+
+<MiniRepl client:idle tune={`sound("<white pink brown>/2").scope()`} />
+
+Here's a more musical example of how to use noise for hihats:
+
+<MiniRepl
+  client:idle
+  tune={`sound("bd*2,<white pink brown>*8")
+.decay(.04).sustain(0).scope()`}
+/>
+
+Some amount of pink noise can also be added to any oscillator by using the `noise` paremeter:
+
+<MiniRepl client:idle tune={`note("c3").noise("<0.1 0.25 0.5>").scope()`} />
+
 ### Additive Synthesis

 To tame the harsh sound of the basic waveforms, we can set the `n` control to limit the overtones of the waveform:
--- a/website/src/pages/recipes/microrhythms.mdx
+++ b/website/src/pages/recipes/microrhythms.mdx
@ -7,7 +7,7 @@ import { MiniRepl } from '../../docs/MiniRepl';
 import { JsDoc } from '../../docs/JsDoc';
 import { samples } from '@strudel.cycles/webaudio';

-see https://strudel.tidalcycles.org?zMEo5kowGrFc
+see https://strudel.cc/?zMEo5kowGrFc

 # Microrhythms

@ -73,4 +73,4 @@ This is the second example of the video:
 s('hh').micro(0, 1/6, 2/5, 2/3, 3/4)`}
 />

-with bass: https://strudel.tidalcycles.org?sTglgJJCPIeY
+with bass: https://strudel.cc/?sTglgJJCPIeY
--- a/website/src/pages/recipes/recipes.mdx
+++ b/website/src/pages/recipes/recipes.mdx
@ -0,0 +1,312 @@
+---
+title: Recipes
+layout: ../../layouts/MainLayout.astro
+---
+
+import { MiniRepl } from '../../docs/MiniRepl';
+
+# Recipes
+
+This page shows possible ways to achieve common (or not so common) musical goals.
+There are often many ways to do a thing and there is no right or wrong.
+The fun part is that each representation will give you different impulses when improvising.
+
+## Arpeggios
+
+An arpeggio is when the notes of a chord are played in sequence.
+We can either write the notes by hand:
+
+<MiniRepl
+  client:visible
+  tune={`note("c eb g c4")
+.clip(2).s("gm_electric_guitar_clean")`}
+  punchcard
+/>
+
+...or use scales:
+
+<MiniRepl
+  client:visible
+  tune={`n("0 2 4 7").scale("C:minor")
+.clip(2).s("gm_electric_guitar_clean")`}
+  punchcard
+/>
+
+...or chord symbols:
+
+<MiniRepl
+  client:visible
+  tune={`n("0 1 2 3").chord("Cm").mode("above:c3").voicing()
+.clip(2).s("gm_electric_guitar_clean")`}
+  punchcard
+/>
+
+...using off:
+
+<MiniRepl
+  client:visible
+  tune={`"0"
+  .off(1/3, add(2))
+  .off(1/2, add(4))
+  .n()
+  .scale("C:minor")
+  .s("gm_electric_guitar_clean")`}
+  punchcard
+/>
+
+## Chopping Breaks
+
+A sample can be looped and chopped like this:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:yaxu/clean-breaks/main')
+s("amen/8").fit().chop(16)`}
+  punchcard
+/>
+
+This fits the break into 8 cycles + chops it in 16 pieces.
+The chops are not audible yet, because we're not doing any manipulation.
+Let's add randmized doubling + reversing:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:yaxu/clean-breaks/main')
+s("amen/8").fit().chop(16).cut(1)
+.sometimesBy(.5, ply(2))
+.sometimesBy(.25, mul(speed(-1)))`}
+  punchcard
+/>
+
+If we want to specify the order of samples, we can replace `chop` with `slice`:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:yaxu/clean-breaks/main')
+s("amen/8").fit()
+  .slice(8, "<0 1 2 3 4*2 5 6 [6 7]>")
+  .cut(1).rarely(ply(2))`}
+  punchcard
+/>
+
+If we use `splice` instead of `slice`, the speed adjusts to the duration of the event:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:yaxu/clean-breaks/main')
+s("amen")
+  .splice(8, "<0 1 2 3 4*2 5 6 [6 7]>")
+  .cut(1).rarely(ply(2))`}
+  punchcard
+/>
+
+Note that we don't need `fit`, because `splice` will do that by itself.
+
+## Filter Envelopes
+
+A minimal filter envelope looks like this:
+
+<MiniRepl
+  client:visible
+  tune={`note("g1 bb1 <c2 eb2> d2")
+  .s("sawtooth")
+  .lpf(400).lpa(.2).lpenv(4)
+  .scope()`}
+/>
+
+We can flip the envelope by setting `lpenv` negative + add some resonance `lpq`:
+
+<MiniRepl
+  client:visible
+  tune={`note("g1 bb1 <c2 eb2> d2")
+  .s("sawtooth").lpq(8)
+  .lpf(400).lpa(.2).lpenv(-4)
+  .scope()`}
+/>
+
+## Layering Sounds
+
+We can layer sounds by separating them with ",":
+
+<MiniRepl
+  client:visible
+  tune={`note("<g1 bb1 d2 f1>")
+.s("sawtooth, square") // <------
+.scope()`}
+/>
+
+We can control the gain of individual sounds like this:
+
+<MiniRepl
+  client:visible
+  tune={`note("<g1 bb1 d2 f1>")
+.s("sawtooth, square:0:.5") // <--- "name:number:gain"
+.scope()`}
+/>
+
+For more control over each voice, we can use `layer`:
+
+<MiniRepl
+  client:visible
+  tune={`note("<g1 bb1 d2 f1>").layer(
+  x=>x.s("sawtooth").vib(4),
+  x=>x.s("square").add(note(12))
+).scope()`}
+/>
+
+Here, we give the sawtooth a vibrato and the square is moved an octave up.
+With `layer`, you can use any pattern method available on each voice, so sky is the limit..
+
+## Oscillator Detune
+
+We can fatten a sound by adding a detuned version to itself:
+
+<MiniRepl
+  client:visible
+  tune={`note("<g1 bb1 d2 f1>")
+.add(note("0,.1")) // <------ chorus
+.s("sawtooth").scope()`}
+  punchcard
+/>
+
+Try out different values, or add another voice!
+
+## Polyrhythms
+
+Here is a simple example of a polyrhythm:
+
+<MiniRepl client:visible tune={`s("bd*2,hh*3")`} punchcard />
+
+A polyrhythm is when 2 different tempos happen at the same time.
+
+## Polymeter
+
+This is a polymeter:
+
+<MiniRepl client:visible tune={`s("<bd rim>,<hh hh oh>").fast(2)`} punchcard />
+
+A polymeter is when 2 different bar lengths play at the same tempo.
+
+## Phasing
+
+This is a phasing:
+
+<MiniRepl client:visible tune={`note("<C D G A Bb D C A G D Bb A>*[6,6.1]").piano()`} punchcard />
+
+Phasing happens when the same sequence plays at slightly different tempos.
+
+## Running through samples
+
+Using `run` with `n`, we can rush through a sample bank:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:Bubobubobubobubo/Dough-Fox/main')
+  n(run(8)).s("ftabla")`}
+  punchcard
+/>
+
+This works great with sample banks that contain similar sounds, like in this case different recordings of a tabla.
+Often times, you'll hear the beginning of the phrase not where the pattern begins.
+In this case, I hear the beginning at the third sample, which can be accounted for with `early`.
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:Bubobubobubobubo/Dough-Fox/main')
+  n(run(8)).s("ftabla").early(2/8)`}
+/>
+
+Let's add some randomness:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:Bubobubobubobubo/Dough-Fox/main')
+n(run(8)).s("ftabla").early(2/8)
+.sometimes(mul(speed(1.5)))`}
+/>
+
+## Tape Warble
+
+We can emulate a pitch warbling effect like this:
+
+<MiniRepl
+  client:visible
+  tune={`note("c4 bb f eb")
+.add(note(perlin.range(0,.5))) // <------ warble
+.clip(2).s("gm_electric_guitar_clean")`}
+/>
+
+## Sound Duration
+
+There are a number of ways to change the sound duration. Using clip:
+
+<MiniRepl
+  client:visible
+  tune={`note("f ab bb c")
+.clip("<2 1 .5 .25>/2")`}
+/>
+
+The value of clip is relative to the duration of each event.
+We can also create overlaps using release:
+
+<MiniRepl
+  client:visible
+  tune={`note("f ab bb c")
+.release("<2 1 .5 .002>/2")`}
+/>
+
+This will smoothly fade out each sound for the given number of seconds.
+We could also make the notes shorter with decay / sustain:
+
+<MiniRepl
+  client:visible
+  tune={`note("f ab bb c")
+.decay("<.2 .1 .02>/2").sustain(0)`}
+/>
+
+For now, there is a limitation where decay values that exceed the event duration may cause little cracks, so use higher numbers with caution..
+
+When using samples, we also have `.end` to cut relative to the sample length:
+
+<MiniRepl client:visible tune={`s("oh*4").end("<1 .5 .25 .1>")`} />
+
+Compare that to clip:
+
+<MiniRepl client:visible tune={`s("oh*4").clip("<1 .5 .25 .1>")`} />
+
+or decay / sustain
+
+<MiniRepl client:visible tune={`s("oh*4").decay("<.2 .12 .06 .01>").sustain(0)`} />
+
+## Wavetable Synthesis
+
+You can loop a sample with `loop` / `loopEnd`:
+
+<MiniRepl client:visible tune={`note("<c eb g f>").s("bd").loop(1).loopEnd(.05).gain(.2)`} />
+
+This allows us to play the first 5% of the bass drum as a synth!
+To simplify loading wavetables, any sample that starts with `wt_` will be looped automatically:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+note("c eb g bb").s("wt_dbass").clip(2)`}
+/>
+
+Running through different wavetables can also give interesting variations:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+note("c2*8").s("wt_dbass").n(run(8))`}
+/>
+
+...adding a filter envelope + reverb:
+
+<MiniRepl
+  client:visible
+  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+note("c2*8").s("wt_dbass").n(run(8))
+.lpf(perlin.range(200,2000).slow(8))
+.lpenv(-3).lpa(.1).room(.5)`}
+/>
--- a/website/src/pages/technical-manual/docs.mdx
+++ b/website/src/pages/technical-manual/docs.mdx
@ -9,7 +9,7 @@ The docs page is built ontop of astro's [docs site](https://github.com/withastro

 ## Adding a new Docs Page

-1. add a `.mdx` file in a path under `website/src/pages/`, e.g. [website/src/pages/learn/code.mdx](https://raw.githubusercontent.com/tidalcycles/strudel/main/website/src/pages/learn/code.mdx) will be available under https://strudel.tidalcycles.org/learn/code (or locally under `http://localhost:3000/learn/code`)
+1. add a `.mdx` file in a path under `website/src/pages/`, e.g. [website/src/pages/learn/code.mdx](https://raw.githubusercontent.com/tidalcycles/strudel/main/website/src/pages/learn/code.mdx) will be available under https://strudel.cc/learn/code (or locally under `http://localhost:3000/learn/code`)
 2. make sure to copy the top part of another existing docs page. Adjust the title accordingly
 3. To add a link to the sidebar, add a new entry to `SIDEBAR` to [`config.ts`](https://github.com/tidalcycles/strudel/blob/main/website/src/config.ts)

--- a/website/src/pages/technical-manual/repl.mdx
+++ b/website/src/pages/technical-manual/repl.mdx
@ -7,7 +7,7 @@ import { MiniRepl } from '../../docs/MiniRepl';

 # REPL

-{/* The [REPL](https://strudel.tidalcycles.org/) is the place where all packages come together to form a live coding system. It can also be seen as a reference implementation for users of the library. */}
+{/* The [REPL](https://strudel.cc/) is the place where all packages come together to form a live coding system. It can also be seen as a reference implementation for users of the library. */}

 While Strudel can be used as a library in any JavaScript codebase, its main, reference user interface is the Strudel REPL^[REPL stands for read, evaluate, print/play, loop. It is friendly jargon for an interactive programming interface from computing heritage, usually for a commandline interface but also applied to live coding editors.], which is a browser-based live coding environment. This live code editor is dedicated to manipulating Strudel patterns while they play. The REPL features built-in visual feedback, highlighting which elements in the patterned (mini-notation) sequences are influencing the event that is currently being played. This feedback is designed to support both learning and live use of Strudel.

--- a/website/src/pages/technical-manual/sounds.mdx
+++ b/website/src/pages/technical-manual/sounds.mdx
@ -64,7 +64,7 @@ registerSound(
 freq(220, 440, 330).s('mysaw');
 ```

-You can actually use this code in the [REPL](https://strudel.tidalcycles.org/) and it'll work.
+You can actually use this code in the [REPL](https://strudel.cc/) and it'll work.
 After evaluating the code, you should see `mysaw` in listed in the sounds tab.

 ## Playing sounds
--- a/website/src/pages/understand/cycles.mdx
+++ b/website/src/pages/understand/cycles.mdx
@ -0,0 +1,130 @@
+---
+title: Understanding Cycles
+layout: ../../layouts/MainLayout.astro
+---
+
+import { MiniRepl } from '../../docs/MiniRepl';
+import { PitchSlider } from '../../components/PitchSlider';
+import Box from '@components/Box.astro';
+
+# Understanding Cycles
+
+The concept of cycles is very central to be able to understand how Strudel works.
+Strudel's mother language, TidalCycles, even has it in its name.
+
+## Cycles and BPM
+
+In most music software, the unit BPM (beats per minute) is used to set the tempo.
+Strudel expresses tempo as CPS (cycles per second), with a default of 1CPS:
+
+<MiniRepl client:visible tune={`s("bd")`} />
+
+Here we can hear the 1CPS in action: The kick repeats once per second like a clock.
+We could say 1CPS = 1BPS (beats per second) = 60BPM. Let's add another kick:
+
+<MiniRepl client:visible tune={`s("bd bd")`} />
+
+Now we have 2 kicks per second, but the whole pattern still plays at 1CPS.
+In terms of BPM, most musicians would tell you this is playing at 120bpm.
+What about this one:
+
+<MiniRepl client:visible tune={`s("bd hh")`} />
+
+Because the second sound is now a hihat, the tempo feels slower again.
+This brings us to an important realization:
+
+<Box>
+
+Tempo is based on perception.
+The choice of sounds also has an impact on the tempo feel.
+This is why the same CPS can produce different perceived tempos.
+
+</Box>
+
+## Setting CPM
+
+If you're familiar with BPM, you can use the `cpm` method to set the tempo in cycles per minute:
+
+<MiniRepl client:visible tune={`s("bd hh").cpm(110)`} />
+
+If you want to add more beats per cycle, you might want to divide the cpm:
+
+<MiniRepl client:visible tune={`s("bd sd bd rim, hh*8").cpm(110/4)`} />
+
+Or using 2 beats per cycle:
+
+<MiniRepl client:visible tune={`s("bd sd, hh*4").cpm(110/2)`} />
+
+<Box>
+
+To set a specific bpm, use `.cpm(bpm/bpc)`
+
+- bpm: the target beats per minute
+- bpc: the number of perceived beats per cycle
+
+</Box>
+
+## Cycles and Bars
+
+Also in most music software, multiple beats form a bar (or measure).
+The so called time signature specifies how many beats are in each bar.
+In many types of music, it is common to use 4 beats per bar, also known as 4/4 time.
+Many music programs use it as a default.
+
+Strudel does not a have concept of bars or measures, there are only cycles.
+How you use them is up to you. Above, we've had this example:
+
+<MiniRepl client:visible tune={`s("bd sd bd rim, hh*8").cpm(110/4)`} />
+
+This could be interpreted as 4/4 time with a tempo of 110bpm.
+We could write out multiple bars like this:
+
+<MiniRepl
+  client:visible
+  tune={`s(\`<
+[bd sd bd rim, hh*8] 
+[bd sd bd rim*2, hh*8]
+>\`).cpm(110/4)`}
+/>
+
+Instead of writing out each bar separately, we could express this much shorter:
+
+<MiniRepl client:visible tune={`s("bd <sd rim*<1 2>>,hh*4").cpm(110/2)`} />
+
+Here we can see that thinking in cycles rather than bars simplifies things a lot!
+These types of simplifications work because of the repetitive nature of rhythm.
+In computational terms, you could say the former notation has a lot of redundancy.
+
+## Time Signatures
+
+To get a time signature, just change the number of elements per bar. Here is a rhythm with 7 beats:
+
+<MiniRepl client:visible tune={`s("bd ~ rim bd bd rim ~")`} />
+
+or with 5:
+
+<MiniRepl client:visible tune={`s("<bd hh hh bd hh hh bd rim bd hh>*5")`} />
+
+We could also write multiple bars with different time signatures:
+
+<MiniRepl
+  client:visible
+  tune={`s(\`<
+[bd hh rim]@3
+[bd hh rim sd]@4
+>\`).cpm(110*2)`}
+/>
+
+Here we switch between 3/4 and 4/4, keeping the same tempo.
+
+If we don't specify the length, we get what's called a metric modulation:
+
+<MiniRepl
+  client:visible
+  tune={`s(\`<
+[bd hh rim]
+[bd hh rim sd]
+>\`).cpm(110/2)`}
+/>
+
+Now the 3 elements get the same time as the 4 elements, which is why the tempo changes.
--- a/website/src/pages/workshop/getting-started.mdx
+++ b/website/src/pages/workshop/getting-started.mdx
@ -18,7 +18,7 @@ With Strudel, you can expressively write dynamic music pieces.<br/>
 It is an official port of the [Tidal Cycles](https://tidalcycles.org/) pattern language to JavaScript.<br/>
 You don't need to know JavaScript or Tidal Cycles to make music with Strudel.
 This interactive tutorial will guide you through the basics of Strudel.<br/>
-The best place to actually make music with Strudel is the [Strudel REPL](https://strudel.tidalcycles.org/)
+The best place to actually make music with Strudel is the [Strudel REPL](https://strudel.cc/)

 <div className="clear-both" />

@ -62,7 +62,7 @@ Here is an example of how strudel can sound:
 .slow(3/2)`}
 />

-To hear more, go to the [Strudel REPL](https://strudel.tidalcycles.org/) and press shuffle to hear a random example pattern.
+To hear more, go to the [Strudel REPL](https://strudel.cc/) and press shuffle to hear a random example pattern.

 ## Getting Started

--- a/website/src/repl/Repl.jsx
+++ b/website/src/repl/Repl.jsx
@ -22,6 +22,7 @@ import Loader from './Loader';
 import { settingPatterns } from '../settings.mjs';
 import { code2hash, hash2code } from './helpers.mjs';
 import { isTauri } from '../tauri.mjs';
+import { useWidgets } from '@strudel.cycles/react/src/hooks/useWidgets.mjs';

 const { latestCode } = settingsMap.get();

@ -33,25 +34,26 @@ const supabase = createClient(
  'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InBpZHhkc3hwaGxoempuem1pZnRoIiwicm9sZSI6ImFub24iLCJpYXQiOjE2NTYyMzA1NTYsImV4cCI6MTk3MTgwNjU1Nn0.bqlw7802fsWRnqU5BLYtmXk_k-D1VFmbkHMywWc15NM',
 );

-const modules = [
+let modules = [
  import('@strudel.cycles/core'),
  import('@strudel.cycles/tonal'),
  import('@strudel.cycles/mini'),
  import('@strudel.cycles/xen'),
  import('@strudel.cycles/webaudio'),
-
+  import('@strudel/codemirror'),
+  import('@strudel/hydra'),
  import('@strudel.cycles/serial'),
  import('@strudel.cycles/soundfonts'),
  import('@strudel.cycles/csound'),
 ];
 if (isTauri()) {
-  modules.concat([
+  modules = modules.concat([
    import('@strudel/desktopbridge/loggerbridge.mjs'),
    import('@strudel/desktopbridge/midibridge.mjs'),
    import('@strudel/desktopbridge/oscbridge.mjs'),
  ]);
 } else {
-  modules.concat([import('@strudel.cycles/midi'), import('@strudel.cycles/osc')]);
+  modules = modules.concat([import('@strudel.cycles/midi'), import('@strudel.cycles/osc')]);
 }

 const modulesLoading = evalScope(
@ -76,9 +78,9 @@ async function initCode() {
    const initialUrl = window.location.href;
    const hash = initialUrl.split('?')[1]?.split('#')?.[0];
    const codeParam = window.location.href.split('#')[1] || '';
-    // looking like https://strudel.tidalcycles.org/?J01s5i1J0200 (fixed hash length)
+    // looking like https://strudel.cc/?J01s5i1J0200 (fixed hash length)
    if (codeParam) {
-      // looking like https://strudel.tidalcycles.org/#ImMzIGUzIg%3D%3D (hash length depends on code length)
+      // looking like https://strudel.cc/#ImMzIGUzIg%3D%3D (hash length depends on code length)
      return hash2code(codeParam);
    } else if (hash) {
      return supabase
@ -125,10 +127,11 @@ export function Repl({ embedded = false }) {
    isAutoCompletionEnabled,
    isLineWrappingEnabled,
    panelPosition,
+    isZen,
  } = useSettings();

  const paintOptions = useMemo(() => ({ fontFamily }), [fontFamily]);
-
+  const { setWidgets } = useWidgets(view);
  const { code, setCode, scheduler, evaluate, activateCode, isDirty, activeCode, pattern, started, stop, error } =
    useStrudel({
      initialCode: '// LOADING...',
@ -142,6 +145,7 @@ export function Repl({ embedded = false }) {
      },
      afterEval: ({ code, meta }) => {
        setMiniLocations(meta.miniLocations);
+        setWidgets(meta.widgets);
        setPending(false);
        setLatestCode(code);
        window.location.hash = '#' + code2hash(code);
@ -149,7 +153,14 @@ export function Repl({ embedded = false }) {
      onEvalError: (err) => {
        setPending(false);
      },
-      onToggle: (play) => !play && cleanupDraw(false),
+      onToggle: (play) => {
+        if (!play) {
+          cleanupDraw(false);
+          window.postMessage('strudel-stop');
+        } else {
+          window.postMessage('strudel-start');
+        }
+      },
      drawContext,
      // drawTime: [0, 6],
      paintOptions,
@ -312,7 +323,7 @@ export function Repl({ embedded = false }) {
          </button>
        )}
        <div className="grow flex relative overflow-hidden">
-          <section className="text-gray-100 cursor-text pb-0 overflow-auto grow" id="code">
+          <section className={'text-gray-100 cursor-text pb-0 overflow-auto grow' + (isZen ? ' px-10' : '')} id="code">
            <CodeMirror
              theme={currentTheme}
              value={code}
--- a/website/src/repl/drawings.mjs
+++ b/website/src/repl/drawings.mjs
@ -23,7 +23,7 @@ angle(saw)
  .animate({smear:0})
 `;

-// https://strudel.tidalcycles.org/?C31_NrcMfZEO
+// https://strudel.cc/?C31_NrcMfZEO
 export const spiralflower = `const {innerWidth:ww,innerHeight:wh} = window;
 const ctx = getDrawContext()
 const piDiv180 = Math.PI / 180;
--- a/website/vite-pwa-astro-0.1.3.tgz
+++ b/website/vite-pwa-astro-0.1.3.tgz