Compare commits

..

17 Commits

Author SHA1 Message Date
alex 24baaf7933 Merge branch 'websocket-client' of ssh://codeberg.org/uzu/strudel into websocket-client 2026-11-19 16:03:32 +00:00
alex 55dc8650f1 minor change to kick codeberg into action 2026-11-19 16:00:43 +00:00
Alex McLean 3b2208bc36 Merge branch 'main' into websocket-client 2026-11-19 16:58:43 +01:00
alex d6e231a9fd copy + paste error 2026-11-19 15:57:49 +00:00
alex 6c345ed827 simple websocket client thingie 2026-11-19 15:55:40 +00:00
Alex McLean 84ef32eec8 Merge pull request 'feat: Add print widget and docs - by @dtricks' (#2187) from dtricks-feat/print_widget into main
Reviewed-on: https://codeberg.org/uzu/strudel/pulls/2187
2026-11-19 16:40:51 +01:00
alex f111271d40 snapshot and fix test (add _print to mock) 2026-11-19 15:34:35 +00:00
Alex McLean 6e1a5126df Merge branch 'main' into feat/print_widget 2026-11-19 16:13:23 +01:00
Alex McLean cac73dc558 Merge pull request 'Merging the Getting Started documentation from two sources (learn and workshop) into one (workshop) and adding redirections.' (#2179) from clpa/strudel:merging-getting-started-doc into main
Reviewed-on: https://codeberg.org/uzu/strudel/pulls/2179
2026-11-15 13:48:16 +01:00
clpa 4068d85e2d prettier 2026-11-14 22:52:30 +01:00
clpa 47a500ca33 updated link to superdirt on Codeberg 2026-11-13 22:58:57 +01:00
clpa 63aeb31644 Merging the Getting Started documentation from two sources (learn and workshop) into one (workshop) and adding redirections 2026-11-13 22:36:56 +01:00
Alex McLean 0cb6341299 Merge pull request 'website/workshop/first-sounds: fix typo' (#2175) from acidbong/first-sounds-typo into main
Reviewed-on: https://codeberg.org/uzu/strudel/pulls/2175
2026-11-08 02:32:27 +01:00
Acid Bong 3b06afdc9c website/workshop/first-sounds: fix typo 2026-11-07 12:25:05 +02:00
yaxu 530e9630bf Update README.md 2026-11-01 12:26:55 +01:00
dtricks 8408af21a6 link font size to global setting 2026-09-17 13:18:44 +02:00
dtricks b1bb29e040 add print widget and docs 2026-09-17 13:03:21 +02:00
29 changed files with 401 additions and 328 deletions
+2
View File
@@ -41,6 +41,8 @@ Licensing info for the default sound banks can be found over on the [dough-sampl
There are many ways to contribute to this project! See [contribution guide](./CONTRIBUTING.md). You can find the full list of contributors [here](https://codeberg.org/uzu/strudel/activity/contributors).
Please see [POLICY.md](POLICY.md) for our code of conduct and humane AI/LLM policy.
## Community
Strudel is a member of the 'Uzu' family of pattern-based live coding languages, along with TidalCycles and friends.
+32
View File
@@ -104,6 +104,32 @@ function getCanvasWidget(id, options = {}) {
return canvas;
}
function getListWidget(id, options = {}) {
const { width = 600, height = 100 } = options;
let el = document.getElementById(id) || document.createElement('div');
el.style.width = width + 'px';
el.style.height = height + 'px';
el.style.overflowY = 'auto';
el.style.overflowX = 'auto';
el.style.boxSizing = 'border-box';
el.style.padding = '4px';
el.style.fontFamily = 'monospace';
el.style.lineHeight = '1.4';
el.style.whiteSpace = 'pre';
el.style.background = 'var(--background)';
el.style.color = 'var(--foreground)';
el.style.border = '1px solid var(--lineHighlight)';
// reset on every (re-)evaluation instead of persisting scroll state across it
el.replaceChildren();
el.scrollTop = 0;
el.follow = true;
el.onscroll = () => {
el.follow = el.scrollHeight - el.scrollTop - el.clientHeight < 4;
};
setWidget(id, el);
return el;
}
registerWidget('_pianoroll', (id, options = {}, pat) => {
const ctx = getCanvasWidget(id, options).getContext('2d');
return pat.tag(id).pianoroll({ fold: 1, ...options, ctx, id });
@@ -140,3 +166,9 @@ registerWidget('_spectrum', (id, options = {}, pat) => {
const ctx = getCanvasWidget(id, options).getContext('2d');
return pat.spectrum({ ...options, ctx, id });
});
registerWidget('_print', (id, options = {}, pat) => {
options = { width: 600, height: 100, maxLines: 500, ...options };
const el = getListWidget(id, options);
return pat.print({ ...options, el, id });
});
-25
View File
@@ -2702,32 +2702,7 @@ export const { seconds } = registerControl('seconds');
export const { songPtr } = registerControl('songPtr');
export const { uid } = registerControl('uid');
export const { val } = registerControl('val');
/**
* Plays the pattern at the given cycles per second. The cps can be patterned. This changes the global tempo, so it generally
* makes sense to have either `cps` (or `cpm` - cycles per minute) set by only one of your patterns.
* Note that this currently does not work when the 'Sync across Browser Tabs / Windows' setting is switched on.
* @tags temporal
* @example
* s("bd hh sd hh").cps(0.5) // = 1 cycle every 2 seconds
* @example
* // a smooth change over 4 cycles
* s("bd hh sd hh").cps(sine.slow(4).range(0.5,1.5))
*/
export const { cps } = registerControl('cps');
/**
* Plays the pattern at the given cycles per minute. The cpm can be patterned. This changes the global tempo, so it generally
* makes sense to have either `cpm` (or `cps` - cycles per second) set by only one of your patterns.
* Note that this currently does not work when the 'Sync across Browser Tabs / Windows' setting is switched on.
* @tags temporal
* @example
* s("bd hh sd hh").cpm(90) // = feels like 180 bpm
* // a smooth change over 4 cycles
* s("bd hh sd hh").cpm(sine.slow(4).range(30,70))
*/
export const { cpm } = registerControl('cpm');
/**
* Multiplies the duration with the given number. Also cuts samples off at the end if they exceed the duration.
*
+6 -8
View File
@@ -84,10 +84,10 @@ export class Cyclist {
// cps changes first, so the durations of the simultaneous haps
// are adjusted accordingly.
if (aBegin.eq(bBegin)) {
if (a.value.cps !== undefined || a.value.cpm !== undefined) {
return b.value.cps !== undefined || b.value.cpm !== undefined ? 0 : -1;
if (a.value.cps !== undefined) {
return b.value.cps !== undefined ? 0 : -1;
}
if (b.value.cps !== undefined || b.value.cpm !== undefined) {
if (b.value.cps !== undefined) {
return 1;
}
return 0;
@@ -97,8 +97,6 @@ export class Cyclist {
haps.forEach((hap) => {
const targetTime = (hap.whole.begin - this.checkpoint.cycles) / this.cps + this.checkpoint.seconds;
let hapCps = hap.value.cps;
hapCps ??= hap.value.cpm != null ? hap.value.cpm / 60 : undefined;
if (tickEndTime < targetTime) {
// If the targetTime exceeds the tickEndTime, this means
// the cps has slowed down, and the latter haps from the query
@@ -106,10 +104,10 @@ export class Cyclist {
// They'll be scheduled during the next tick.
return;
}
onSchedule?.(hap, targetTime + this.latency, hapCps ?? this.cps);
if (hapCps !== undefined && this.cps != hapCps) {
onSchedule?.(hap, targetTime + this.latency, hap.value.cps ?? this.cps);
if (hap.value.cps !== undefined && this.cps != hap.value.cps) {
cpsChanged = true;
this.cps = hapCps;
this.cps = hap.value.cps;
this.num_ticks_since_checkpoint = 0;
this.checkpoint = {
cycles: hap.whole.begin,
+12
View File
@@ -2476,6 +2476,18 @@ export const apply = register('apply', function (func, pat) {
return func(pat);
});
/**
* Plays the pattern at the given cycles per minute.
* @tags temporal
* @deprecated
* @example
* s("<bd sd>,hh*2").cpm(90) // = 90 bpm
*/
// this is redefined in repl.mjs, using the current cps as divisor
export const cpm = register('cpm', function (cpm, pat) {
return pat._fast(cpm / 60 / 1);
});
/**
* Nudge a pattern to start earlier in time. Equivalent of Tidal's <~ operator
*
+4
View File
@@ -217,10 +217,14 @@ export function repl({
} catch (err) {
console.warn('injectPatternMethods: error:', err);
}
const cpm = register('cpm', function (cpm, pat) {
return pat._fast(cpm / 60 / scheduler.cps);
});
return evalScope({
all,
each,
hush,
cpm,
setCps,
setcps: setCps,
setCpm,
+1
View File
@@ -4,3 +4,4 @@ export * from './draw.mjs';
export * from './pianoroll.mjs';
export * from './spiral.mjs';
export * from './pitchwheel.mjs';
export * from './print.mjs';
+98
View File
@@ -0,0 +1,98 @@
/*
print.mjs - prints hap values to the console or a scrollable inline widget
Copyright (C) 2022 Strudel contributors - see
<https://codeberg.org/uzu/strudel/src/branch/main/packages/draw/print.mjs> This
program is free software: you can redistribute it and/or modify it under the
terms of the GNU Affero General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version. This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for
more details. You should have received a copy of the GNU Affero General Public
License along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
import { logger, Pattern, stringifyValues } from '@strudel/core';
const printed = {};
// counts .print() calls within one synchronous evaluation, then resets for the
// next
let printIndex = 0;
let printIndexResetQueued = false;
function nextPrintIndex() {
const index = printIndex++;
if (!printIndexResetQueued) {
printIndexResetQueued = true;
queueMicrotask(() => {
printIndex = 0;
printIndexResetQueued = false;
});
}
return index;
}
function formatTime(hap, round, padding) {
const begin = hap.wholeOrPart().begin;
if (round === 0) {
return String(begin.sam().valueOf()).padEnd(padding);
}
const factor = 10 ** round;
const time = Math.round(begin.valueOf() * factor) / factor;
return String(time).padEnd(padding + round + 1);
}
function appendLine(el, text, maxLines) {
const line = document.createElement('div');
line.textContent = text;
el.appendChild(line);
while (el.childElementCount > maxLines) {
el.removeChild(el.firstChild);
}
if (el.follow) {
el.scrollTop = el.scrollHeight;
}
}
/**
* Prints the values of a pattern's events. Without a leading underscore, prints
* to the existing console panel, labeled with its position among other
* `print()` calls, e.g. `[print(line:1)]`. With the `_` prefix, it shows a
* scrollable widget inside the code instead, and its content resets on
* every (re-)evaluation.
*
* @name print
* @tags visualization
* @param {number} width widget width in px, `_print` only. defaults to 600
* @param {number} height widget height in px, `_print` only. defaults to 100
* @param {number} maxLines max lines kept, `_print` only. defaults to 500
* @param {number} round decimal digits for the event time. defaults to 4. `0`
* shows only the cycle
* @param {number} padding integer digits reserved for the cycle, so it stays
* aligned once cycles reach 10 or 100. defaults to 3
* @example
* s("bd sd hh cp").print()
* @example
* s("bd sd hh*2 cp")._print({ round: 5 })
*/
Pattern.prototype.print = function (options = {}) {
const { el, id = 1, maxLines = 500, round = 4, padding = 3 } = options;
if (!el) {
const label = `print(line:${nextPrintIndex() + 1})`;
return this.onTrigger((hap) => {
logger(`[${label}] ${formatTime(hap, round, padding)}: ${stringifyValues(hap.value, true)}`);
}, false);
}
printed[id] = new WeakSet();
return this.draw(
(haps) => {
haps
.filter((hap) => !printed[id].has(hap))
.forEach((hap) => {
printed[id].add(hap);
appendLine(el, `${formatTime(hap, round, padding)}: ${stringifyValues(hap.value, true)}`, maxLines);
});
},
{ lookbehind: 0, lookahead: 0, id },
);
};
+2 -1
View File
@@ -43,7 +43,8 @@
"@strudel/soundfonts": "workspace:*",
"@strudel/tonal": "workspace:*",
"@strudel/transpiler": "workspace:*",
"@strudel/webaudio": "workspace:*"
"@strudel/webaudio": "workspace:*",
"@strudel/websocket": "workspace:*"
},
"devDependencies": {
"@rollup/plugin-replace": "^6.0.2",
+1
View File
@@ -15,6 +15,7 @@ export async function prebake() {
import('@strudel/hydra'),
import('@strudel/soundfonts'),
import('@strudel/midi'),
import('@strudel/websocket'),
// import('@strudel/xen'),
// import('@strudel/serial'),
// import('@strudel/csound'),
+6
View File
@@ -0,0 +1,6 @@
# @strudel/websocket
This package adds websocket input to strudel Patterns.
It connects to a websocket server and exposes the latest received value (parsed as JSON) as a pattern.
+3
View File
@@ -0,0 +1,3 @@
import './websocket.mjs';
export * from './websocket.mjs';
+40
View File
@@ -0,0 +1,40 @@
{
"name": "@strudel/websocket",
"version": "1.0.0",
"description": "Websocket input for strudel",
"main": "index.mjs",
"type": "module",
"publishConfig": {
"main": "dist/index.mjs"
},
"scripts": {
"build": "vite build",
"prepublishOnly": "npm run build"
},
"repository": {
"type": "git",
"url": "git+https://codeberg.org/uzu/strudel.git"
},
"keywords": [
"titdalcycles",
"strudel",
"pattern",
"livecoding",
"algorave"
],
"author": "Alex McLean <alex@slab.org>",
"license": "AGPL-3.0-or-later",
"bugs": {
"url": "https://codeberg.org/uzu/strudel/issues"
},
"homepage": "https://codeberg.org/uzu/strudel#readme",
"dependencies": {
"@strudel/core": "workspace:*"
},
"devDependencies": {
"vite": "^6.0.11"
},
"engines": {
"node": ">=18.0.0"
}
}
+19
View File
@@ -0,0 +1,19 @@
import { defineConfig } from 'vite';
import { dependencies } from './package.json';
import { resolve } from 'path';
// https://vitejs.dev/config/
export default defineConfig({
plugins: [],
build: {
lib: {
entry: resolve(__dirname, 'index.mjs'),
formats: ['es'],
fileName: (ext) => ({ es: 'index.mjs' })[ext],
},
rollupOptions: {
external: [...Object.keys(dependencies)],
},
target: 'esnext',
},
});
+43
View File
@@ -0,0 +1,43 @@
/*
websocket.mjs - simple websocket client as a pattern
Copyright (C) 2026 Strudel contributors -- see <https://codeberg.org/uzu/strudel/src/branch/main/packages/websocket/websocket.mjs>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
import { logger, signal } from '@strudel/core';
const connections = {};
const values = {};
function connect(addr) {
if (connections[addr]) {
return connections[addr];
}
const ws = new WebSocket(addr);
connections[addr] = ws;
ws.addEventListener('open', () => {
logger(`[websocket] connected to ${addr}`);
});
ws.addEventListener('message', (event) => {
try {
console.log(event.data);
values[addr] = JSON.parse(event.data);
} catch {
logger(`[websocket] received invalid json on ${addr}`);
}
});
ws.addEventListener('close', () => {
logger(`[websocket] disconnected from ${addr}`);
delete connections[addr];
});
ws.addEventListener('error', () => {
logger(`[websocket] failed to connect to ${addr}`);
delete connections[addr];
});
return ws;
}
export function websocket(addr) {
connect(addr);
return signal(() => values[addr] ?? {});
}
+16
View File
@@ -538,6 +538,9 @@ importers:
'@strudel/webaudio':
specifier: workspace:*
version: link:../webaudio
'@strudel/websocket':
specifier: workspace:*
version: link:../websocket
devDependencies:
'@rollup/plugin-replace':
specifier: ^6.0.2
@@ -722,6 +725,16 @@ importers:
specifier: ^6.0.11
version: 6.0.11(@types/node@22.10.10)(jiti@2.4.2)(lightningcss@1.29.1)(terser@5.37.0)(yaml@2.7.0)
packages/websocket:
dependencies:
'@strudel/core':
specifier: workspace:*
version: link:../core
devDependencies:
vite:
specifier: ^6.0.11
version: 6.0.11(@types/node@22.10.10)(jiti@2.4.2)(lightningcss@1.29.1)(terser@5.37.0)(yaml@2.7.0)
packages/xen:
dependencies:
'@strudel/core':
@@ -857,6 +870,9 @@ importers:
'@strudel/webaudio':
specifier: workspace:*
version: link:../packages/webaudio
'@strudel/websocket':
specifier: workspace:*
version: link:../packages/websocket
'@strudel/xen':
specifier: workspace:*
version: link:../packages/xen
+69 -63
View File
@@ -1,68 +1,5 @@
// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
exports[`runs examples > example "" example index 0 1`] = `
[
"[ 0/1 → 1/4 | s:bd cps:0.5 ]",
"[ 1/4 → 1/2 | s:hh cps:0.5 ]",
"[ 1/2 → 3/4 | s:sd cps:0.5 ]",
"[ 3/4 → 1/1 | s:hh cps:0.5 ]",
"[ 1/1 → 5/4 | s:bd cps:0.5 ]",
"[ 5/4 → 3/2 | s:hh cps:0.5 ]",
"[ 3/2 → 7/4 | s:sd cps:0.5 ]",
"[ 7/4 → 2/1 | s:hh cps:0.5 ]",
"[ 2/1 → 9/4 | s:bd cps:0.5 ]",
"[ 9/4 → 5/2 | s:hh cps:0.5 ]",
"[ 5/2 → 11/4 | s:sd cps:0.5 ]",
"[ 11/4 → 3/1 | s:hh cps:0.5 ]",
"[ 3/1 → 13/4 | s:bd cps:0.5 ]",
"[ 13/4 → 7/2 | s:hh cps:0.5 ]",
"[ 7/2 → 15/4 | s:sd cps:0.5 ]",
"[ 15/4 → 4/1 | s:hh cps:0.5 ]",
]
`;
exports[`runs examples > example "" example index 0 2`] = `
[
"[ 0/1 → 1/4 | s:bd cpm:50 ]",
"[ 1/4 → 1/2 | s:hh cpm:57.6536686473018 ]",
"[ 1/2 → 3/4 | s:sd cpm:64.14213562373095 ]",
"[ 3/4 → 1/1 | s:hh cpm:68.47759065022574 ]",
"[ 1/1 → 5/4 | s:bd cpm:70 ]",
"[ 5/4 → 3/2 | s:hh cpm:68.47759065022574 ]",
"[ 3/2 → 7/4 | s:sd cpm:64.14213562373095 ]",
"[ 7/4 → 2/1 | s:hh cpm:57.6536686473018 ]",
"[ 2/1 → 9/4 | s:bd cpm:50 ]",
"[ 9/4 → 5/2 | s:hh cpm:42.34633135269821 ]",
"[ 5/2 → 11/4 | s:sd cpm:35.85786437626905 ]",
"[ 11/4 → 3/1 | s:hh cpm:31.52240934977427 ]",
"[ 3/1 → 13/4 | s:bd cpm:30 ]",
"[ 13/4 → 7/2 | s:hh cpm:31.522409349774268 ]",
"[ 7/2 → 15/4 | s:sd cpm:35.85786437626905 ]",
"[ 15/4 → 4/1 | s:hh cpm:42.34633135269819 ]",
]
`;
exports[`runs examples > example "" example index 1 1`] = `
[
"[ 0/1 → 1/4 | s:bd cps:1 ]",
"[ 1/4 → 1/2 | s:hh cps:1.1913417161825448 ]",
"[ 1/2 → 3/4 | s:sd cps:1.3535533905932737 ]",
"[ 3/4 → 1/1 | s:hh cps:1.4619397662556435 ]",
"[ 1/1 → 5/4 | s:bd cps:1.5 ]",
"[ 5/4 → 3/2 | s:hh cps:1.4619397662556435 ]",
"[ 3/2 → 7/4 | s:sd cps:1.3535533905932737 ]",
"[ 7/4 → 2/1 | s:hh cps:1.1913417161825448 ]",
"[ 2/1 → 9/4 | s:bd cps:1 ]",
"[ 9/4 → 5/2 | s:hh cps:0.8086582838174552 ]",
"[ 5/2 → 11/4 | s:sd cps:0.6464466094067263 ]",
"[ 11/4 → 3/1 | s:hh cps:0.5380602337443567 ]",
"[ 3/1 → 13/4 | s:bd cps:0.5 ]",
"[ 13/4 → 7/2 | s:hh cps:0.5380602337443567 ]",
"[ 7/2 → 15/4 | s:sd cps:0.6464466094067262 ]",
"[ 15/4 → 4/1 | s:hh cps:0.8086582838174547 ]",
]
`;
exports[`runs examples > example "_euclidRot" example index 0 1`] = `
[
"[ 0/1 → 1/5 | note:c3 ]",
@@ -2852,6 +2789,29 @@ exports[`runs examples > example "cosine" example index 0 1`] = `
]
`;
exports[`runs examples > example "cpm" example index 0 1`] = `
[
"[ 0/1 → 1/3 | s:hh ]",
"[ 0/1 → 2/3 | s:bd ]",
"[ 1/3 → 2/3 | s:hh ]",
"[ 2/3 → 1/1 | s:hh ]",
"[ 2/3 → 4/3 | s:sd ]",
"[ 1/1 → 4/3 | s:hh ]",
"[ 4/3 → 5/3 | s:hh ]",
"[ 4/3 → 2/1 | s:bd ]",
"[ 5/3 → 2/1 | s:hh ]",
"[ 2/1 → 7/3 | s:hh ]",
"[ 2/1 → 8/3 | s:sd ]",
"[ 7/3 → 8/3 | s:hh ]",
"[ 8/3 → 3/1 | s:hh ]",
"[ 8/3 → 10/3 | s:bd ]",
"[ 3/1 → 10/3 | s:hh ]",
"[ 10/3 → 11/3 | s:hh ]",
"[ 10/3 → 4/1 | s:sd ]",
"[ 11/3 → 4/1 | s:hh ]",
]
`;
exports[`runs examples > example "crush" example index 0 1`] = `
[
"[ 0/1 → 1/6 | s:hh crush:16 ]",
@@ -10044,6 +10004,52 @@ exports[`runs examples > example "pressBy" example index 0 1`] = `
]
`;
exports[`runs examples > example "print" example index 0 1`] = `
[
"[ 0/1 → 1/4 | s:bd ]",
"[ 1/4 → 1/2 | s:sd ]",
"[ 1/2 → 3/4 | s:hh ]",
"[ 3/4 → 1/1 | s:cp ]",
"[ 1/1 → 5/4 | s:bd ]",
"[ 5/4 → 3/2 | s:sd ]",
"[ 3/2 → 7/4 | s:hh ]",
"[ 7/4 → 2/1 | s:cp ]",
"[ 2/1 → 9/4 | s:bd ]",
"[ 9/4 → 5/2 | s:sd ]",
"[ 5/2 → 11/4 | s:hh ]",
"[ 11/4 → 3/1 | s:cp ]",
"[ 3/1 → 13/4 | s:bd ]",
"[ 13/4 → 7/2 | s:sd ]",
"[ 7/2 → 15/4 | s:hh ]",
"[ 15/4 → 4/1 | s:cp ]",
]
`;
exports[`runs examples > example "print" example index 1 1`] = `
[
"[ 0/1 → 1/4 | s:bd ]",
"[ 1/4 → 1/2 | s:sd ]",
"[ 1/2 → 5/8 | s:hh ]",
"[ 5/8 → 3/4 | s:hh ]",
"[ 3/4 → 1/1 | s:cp ]",
"[ 1/1 → 5/4 | s:bd ]",
"[ 5/4 → 3/2 | s:sd ]",
"[ 3/2 → 13/8 | s:hh ]",
"[ 13/8 → 7/4 | s:hh ]",
"[ 7/4 → 2/1 | s:cp ]",
"[ 2/1 → 9/4 | s:bd ]",
"[ 9/4 → 5/2 | s:sd ]",
"[ 5/2 → 21/8 | s:hh ]",
"[ 21/8 → 11/4 | s:hh ]",
"[ 11/4 → 3/1 | s:cp ]",
"[ 3/1 → 13/4 | s:bd ]",
"[ 13/4 → 7/2 | s:sd ]",
"[ 7/2 → 29/8 | s:hh ]",
"[ 29/8 → 15/4 | s:hh ]",
"[ 15/4 → 4/1 | s:cp ]",
]
`;
exports[`runs examples > example "progNum" example index 0 1`] = `
[
"[ 0/1 → 1/1 | note:c4 progNum:10 midichan:1 ]",
+1
View File
@@ -97,6 +97,7 @@ const toneHelpersMocked = {
'_pitchwheel',
'_pianoroll',
'_spectrum',
'_print',
'markcss',
'p',
'dough',
+1
View File
@@ -48,6 +48,7 @@
"@strudel/tonal": "workspace:*",
"@strudel/transpiler": "workspace:*",
"@strudel/webaudio": "workspace:*",
"@strudel/websocket": "workspace:*",
"@strudel/mondo": "workspace:*",
"@strudel/xen": "workspace:*",
"@supabase/supabase-js": "^2.48.1",
@@ -0,0 +1,3 @@
<script is:inline>
window.location.pathname = `/workshop/getting-started`;
</script>
@@ -1,90 +0,0 @@
---
title: Getting Started
layout: ../../layouts/MainLayout.astro
---
import { MiniRepl } from '../../docs/MiniRepl';
import { JsDoc } from '../../docs/JsDoc';
# Welcome
Welcome to the Strudel documentation pages!
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.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://froos.cc/) in 2022, quickly growing into a collective free/open source project with major [contributors and maintainers](https://codeberg.org/uzu/strudel/activity/contributors) including [Jade Rowland](https://www.instagram.com/_switch_angel/) and [Aria](https://www.instagram.com/gglossingg/).
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.
To make sound, it has to be connected to a sound engine, and by default this is a [SuperCollider](https://supercollider.github.io/) plugin called [SuperDirt](https://github.com/musikinformatik/SuperDirt/).
As such, it can be difficult for first-time users to install both Tidal Cycles and SuperDirt, as there are many small details to get right.
Strudel however runs directly in your web browser, does not require any custom software installation, and can make sound all by itself.
# Strudel REPL and MiniREPL
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 />
Then edit the text so it reads `s("bd sd cp hh")` and click the refresh icon.
Congratulations, you have now live coded your first Strudel pattern!
With Strudel, you can expressively write dynamic music pieces.
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.
# Show me some demos!
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).
Alternatively, you can get a taste of what Strudel can do by clicking play on this track:
<MiniRepl
client:idle
tune={`samples({
bd: ['bd/BT0AADA.wav','bd/BT0AAD0.wav','bd/BT0A0DA.wav','bd/BT0A0D3.wav','bd/BT0A0D0.wav','bd/BT0A0A7.wav'],
sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
}, 'github:tidalcycles/dirt-samples');
stack(
s("bd,[~ <sd!3 sd(3,4,2)>],hh*8") // drums
.speed(perlin.range(.7,.9)) // random sample speed variation
,"<a1 b1\*2 a1(3,8) e2>" // bassline
.off(1/8,x=>x.add(12).degradeBy(.5)) // random octave jumps
.add(perlin.range(0,.5)) // random pitch variation
.superimpose(add(.05)) // add second, slightly detuned voice
.note() // wrap in "note"
.decay(.15).sustain(0) // make each note of equal length
.s('sawtooth') // waveform
.gain(.4) // turn down
.cutoff(sine.slow(7).range(300,5000)) // automate cutoff
,"<Am7!3 <Em7 E7b13 Em7 Ebm7b5>>".voicings('lefthand') // chords
.superimpose(x=>x.add(.04)) // add second, slightly detuned voice
.add(perlin.range(0,.5)) // random pitch variation
.note() // wrap in "note"
.s('sawtooth') // waveform
.gain(.16) // turn down
.cutoff(500) // fixed cutoff
.attack(1) // slowly fade in
)
.slow(3/2)`}
/>
# Strudel is a work in progress 🚧
Please note that this project is still in its experimental state.
In the future, parts of it might change significantly.
This tutorial is also far from complete.
You can contribute to it clicking 'Edit this page' in the top right, or by visiting the [Strudel GitHub page](https://codeberg.org/uzu/strudel/).
# What's next?
Head on over to the [Notes](/learn/notes) page.
<br />
+3
View File
@@ -0,0 +1,3 @@
<script is:inline>
window.location.pathname = `/workshop/first-notes`;
</script>
-90
View File
@@ -1,90 +0,0 @@
---
title: Notes
layout: ../../layouts/MainLayout.astro
---
import { MiniRepl } from '../../docs/MiniRepl';
import { JsDoc } from '../../docs/JsDoc';
# Notes
Pitches are an important building block in many musical traditions.
In Strudel, pitches can be expressed as note names, note numbers or frequencies.
Here's the same pattern written in three different ways:
- `note`: letter notation, good for those who are familiar with western music theory:
<MiniRepl client:idle tune={`note("a3 c#4 e4 a4")`} />
- `note`: number notation, good for those who want to use recognisable pitches, but don't care about music theory:
<MiniRepl client:idle tune={`note("57 61 64 69")`} />
- `freq`: frequency notation, good for those who want to go beyond standardised tuning systems:
<MiniRepl client:idle tune={`freq("220 275 330 440")`} />
Let's look at those in more detail...
## `note` names
Notes names can be notated with the note letter, followed by the octave number. You can notate flats with `b` and sharps with `#`.
<MiniRepl client:idle tune={`note("a3 c#4 e4 a4")`} />
By the way, you can edit the contents of the player, and press "update" to hear your change!
You can also press "play" on the next player without needing to stop the last one.
## `note` numbers
If you prefer, you can also use numbers with `note` instead:
<MiniRepl client:idle tune={`note("57 61 64 69")`} />
These numbers are interpreted as so called [MIDI numbers](https://www.inspiredacoustics.com/en/MIDI_note_numbers_and_center_frequencies), where adjacent whole numbers are one 'semitone' apart.
You could also write decimal numbers to get 'microtonal' pitches (in between the black and white piano notes):
<MiniRepl client:idle tune={`note("74.5 75 75.5 76")`} />
## `freq`
To get maximum freedom, you can also use `freq` to directly control the frequency:
<MiniRepl client:idle tune={`freq("220 275 330 440")`} />
## Hearing and frequency
In the above example, we play A3 (220Hz), C#4 natural (275Hz), E4 (330Hz) and A4 (440Hz), mirroring our previous examples.
But can you hear the difference between these individual frequencies?
<MiniRepl client:idle tune={`freq("220 221 223 224")`} />
How about these?
<MiniRepl client:idle tune={`freq("2020 2021 2023 2024")`} />
The higher we go up...
<MiniRepl client:idle tune={`freq("5020 5021 5023 5024")`} />
The less distance we can hear between the frequencies!
<MiniRepl client:idle tune={`freq("10020 10021 10023 10024")`} />
Why is this? [Human hearing operates logarithmically](https://www.audiocheck.net/soundtests_nonlinear.php).
## From notes to sounds
In this page, when we played a pattern of notes like this:
<MiniRepl client:idle tune={`note("a3 c#4 e4 a4")`} />
We heard a simple synthesised sound, in fact we heard a [triangle wave oscillator](https://en.wikipedia.org/wiki/Triangle_wave).
This is the default synthesiser used by Strudel, but how do we then make different sounds in Strudel?
Let's find out in the next page on [Sounds](/learn/sounds).
<br />
+3
View File
@@ -0,0 +1,3 @@
<script is:inline>
window.location.pathname = `/workshop/first-sounds`;
</script>
-40
View File
@@ -1,40 +0,0 @@
---
title: Sounds
layout: ../../layouts/MainLayout.astro
---
import { MiniRepl } from '../../docs/MiniRepl';
import { JsDoc } from '../../docs/JsDoc';
# Sounds
We can play sounds with `s`, in two different ways:
- `s` can trigger audio samples, where a sound file is loaded in the background and played back:
<MiniRepl client:idle tune={`s("bd hh sd hh")`} />
- `s` can trigger audio synthesisers, which are synthesised in real-time using code also running in the background:
<MiniRepl client:idle tune={`s("sawtooth square triangle sine")`} />
You can learn more about both of these approaches in the pages [Synths](/learn/synths) and [Samples](/learn/samples).
# Combining notes and sounds
In both of the above cases, we are no longer directly controlling the `note`/`freq` of the sound heard via `s`, as we were in the [Notes](/workshop/first-notes/) page.
So how can we both control the sound and the pitch? We can _combine_ `note`/`freq` with `s` to change the sound of our pitches:
<MiniRepl client:idle tune={`note("a3 c#4 e4 a4").s("sawtooth")`} />
<MiniRepl client:idle tune={`note("57 61 64 69").s("sine")`} />
<MiniRepl client:idle tune={`freq("220 275 330 440").s("triangle")`} />
The last example will actually sound the same with or without `s`, because `triangle` is the default value for `s`.
What about combining different notes with different sounds at the same time?
<MiniRepl client:idle tune={`freq("220 275 330 440 550").s("triangle sawtooth sine")`} />
Hmm, something interesting is going on there, related to there being five notes and three sounds.
Let's now take a step back and think about the Strudel [Code](/learn/code/) we've been hearing so far.
@@ -103,6 +103,10 @@ What follows is the API doc of all the options you can pass:
<JsDoc client:idle name="spectrum" h={0} />
## Print
<JsDoc client:idle name="print" h={0} />
## markcss
<JsDoc client:idle name="markcss" h={0} />
+1 -1
View File
@@ -186,7 +186,7 @@ But don't worry if you don't know these terms, as they are not required to make
</Box>
**Add a rests in a sequence with '-' or '~'**
**Add a rest in a sequence with '-' or '~'**
<MiniRepl client:visible tune={`sound("bd hh - rim - bd hh rim")`} punchcard />
+30 -9
View File
@@ -13,24 +13,41 @@ import { examples } from '../../examples.mjs';
Welcome to the Strudel documentation pages!
You've come to the right place if you want to learn how to make music with code.
These pages will introduce you to [Strudel](https://strudel.cc/), a web-based [live coding](https://codeberg.org/toplap/awesome-livecoding/) environment that implements the [Tidal Cycles](https://tidalcycles.org) algorithmic pattern language.
## What is Strudel?
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/>
[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://froos.cc/) in 2022, quickly growing into a collective free/open source project with major [contributors and maintainers](https://codeberg.org/uzu/strudel/activity/contributors) including [Jade Rowland](https://www.instagram.com/_switch_angel/) and [Aria](https://www.instagram.com/gglossingg/).
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.
To make sound, it has to be connected to a sound engine, and by default this is a [SuperCollider](https://supercollider.github.io/) plugin called [SuperDirt](https://codeberg.org/musikinformatik/SuperDirt).
As such, it can be difficult for first-time users to install both Tidal Cycles and SuperDirt, as there are many small details to get right.
Strudel however runs directly in your web browser, does not require any custom software installation, and can make sound all by itself.
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.cc/)
<div className="clear-both" />
## What can you do with Strudel?
- live code music: make music with code in real time
- algorithmic composition: compose music using tidal's unique approach to pattern manipulation
- teaching: focussing on a low barrier of entry, Strudel is a good fit for teaching music and code at the same time.
- integrate into your existing music setup: either via MIDI or OSC, you can use Strudel as a really flexible sequencer
- Live code music: make music with code in real time.
- Algorithmic composition: compose music using tidal's unique approach to pattern manipulation.
- Teaching: focussing on a low barrier of entry, Strudel is a good fit for teaching music and code at the same time.
- Integrate into your existing music setup: either via MIDI or OSC, you can use Strudel as a really flexible sequencer.
## Examples
## Strudel REPL and MiniREPL
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 />
Then edit the text so it reads `s("bd sd cp hh")` and click the refresh icon.
Congratulations, you have now live coded your first Strudel pattern!
## Show me some demos!
Here are some examples of how strudel can sound:
@@ -38,6 +55,10 @@ Here are some examples of how strudel can sound:
These examples cannot fully encompass the variety of things you can do, so [check out the showcase](/intro/showcase/) for some videos of how people use Strudel.
## Contribute to Strudel
You can contribute to it clicking 'Edit this page' in the top right, or by visiting the [Strudel Codeberg page](https://codeberg.org/uzu/strudel/).
## Getting Started
The best way to start learning Strudel is the workshop.
+1 -1
View File
@@ -97,7 +97,7 @@ export function loadModules() {
import('@strudel/desktopbridge/oscbridge.mjs'),
]);
} else {
modules = modules.concat([import('@strudel/midi'), import('@strudel/osc')]);
modules = modules.concat([import('@strudel/midi'), import('@strudel/osc'), import('@strudel/websocket')]);
}
return evalScope(settingPatterns, ...modules);