From 66aa3ac1da2d1151d5bf50222152ec21966376ae Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 21 Aug 2025 20:30:02 +0200
Subject: [PATCH 1/4] add --json flag to strudel sampler

---
 packages/sampler/README.md         | 10 ++++++++++
 packages/sampler/sample-server.mjs | 26 ++++++++++++++++++--------
 2 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/packages/sampler/README.md b/packages/sampler/README.md
index c495c2ad..c7b44610 100644
--- a/packages/sampler/README.md
+++ b/packages/sampler/README.md
@@ -20,3 +20,13 @@ samples('http://localhost:5432')
 LOG=1 npx @strudel/sampler # adds logging
 PORT=5555 npx @strudel/sampler # changes port
 ```
+
+## static json
+
+when running with `--json`, you will simply get the json logged back:
+
+```sh
+npx @strudel/sampler --json > strudel.json
+```
+
+this is useful if you want to create a sample pack from the current folder.
\ No newline at end of file
diff --git a/packages/sampler/sample-server.mjs b/packages/sampler/sample-server.mjs
index d1e56108..08456add 100644
--- a/packages/sampler/sample-server.mjs
+++ b/packages/sampler/sample-server.mjs
@@ -10,14 +10,6 @@ import os from 'os';
 // eslint-disable-next-line
 const LOG = !!process.env.LOG || false;
 
-console.log(
-  cowsay.say({
-    text: 'welcome to @strudel/sampler',
-    e: 'oO',
-    T: 'U ',
-  }),
-);
-
 async function getFilesInDirectory(directory) {
   let files = [];
   const dirents = await readdir(directory, { withFileTypes: true });
@@ -60,8 +52,26 @@ async function getBanks(directory) {
   return { banks, files };
 }
 
+const args = process.argv.slice(2);
+
 // eslint-disable-next-line
 const directory = process.cwd();
+
+if (args.includes('--json')) {
+  const { banks, files } = await getBanks(directory);
+  const json = JSON.stringify(banks);
+  console.log(json);
+  process.exit(0);
+}
+
+console.log(
+  cowsay.say({
+    text: 'welcome to @strudel/sampler',
+    e: 'oO',
+    T: 'U ',
+  }),
+);
+
 const server = http.createServer(async (req, res) => {
   res.setHeader('Access-Control-Allow-Origin', '*');
   const { banks, files } = await getBanks(directory);

From b12707316ac2c0493d9330a9cec9a3a349b7a326 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 21 Aug 2025 20:30:32 +0200
Subject: [PATCH 2/4] bump @strudel/sampler to 0.2.1

---
 packages/sampler/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/sampler/package.json b/packages/sampler/package.json
index b0f27f86..765f2962 100644
--- a/packages/sampler/package.json
+++ b/packages/sampler/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/sampler",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "",
   "keywords": [
     "tidalcycles",

From da283eb55a94d4ee9ba9bd68a12c850be6eba439 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 21 Aug 2025 20:36:17 +0200
Subject: [PATCH 3/4] doc: generate strudel.json

---
 website/src/pages/learn/samples.mdx | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index 0deb6070..a87b8f7d 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -178,6 +178,16 @@ the version number).
 It is also possible, of course, to just remove it from cache (deleting cache in browser Privacy settings,
 or from the dev console if you're technically minded, or by using a cache deleting extension).
 
+## Generating strudel.json
+
+You can use [@strudel/sampler](https://www.npmjs.com/package/@strudel/sampler) to generate a strudel.json file for you, by running:
+
+```sh
+npx --yes @strudel/sampler --json > strudel.json
+```
+
+See other uses of strudel/sampler further below, under "From Disk via @strudel/sampler".
+
 ## Github Shortcut
 
 Because loading samples from github is common, there is a shortcut:

From 42a903ecc080b1615f6b097e8f478aa21ae8837e Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 21 Aug 2025 20:36:42 +0200
Subject: [PATCH 4/4] add --yes flag to readme, making sure first run works

---
 packages/sampler/README.md    | 2 +-
 packages/sampler/package.json | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/sampler/README.md b/packages/sampler/README.md
index c7b44610..1142176b 100644
--- a/packages/sampler/README.md
+++ b/packages/sampler/README.md
@@ -26,7 +26,7 @@ PORT=5555 npx @strudel/sampler # changes port
 when running with `--json`, you will simply get the json logged back:
 
 ```sh
-npx @strudel/sampler --json > strudel.json
+npx --yes @strudel/sampler --json > strudel.json
 ```
 
 this is useful if you want to create a sample pack from the current folder.
\ No newline at end of file
diff --git a/packages/sampler/package.json b/packages/sampler/package.json
index 765f2962..dd701bcf 100644
--- a/packages/sampler/package.json
+++ b/packages/sampler/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/sampler",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "",
   "keywords": [
     "tidalcycles",