Working version

2026-08-24 10:33:01 +02:00
commit 9c67af04c1
5 changed files with 395 additions and 0 deletions
@@ -0,0 +1,68 @@
+# VCV Library Non-Hardware-Clone Cleanup
+
+
+This vibe-coded script scans VCV Library pages and removes modules that are currently removable and not tagged `Hardware clone`.
+
+## Safety and rate limit
+
+- Default rate limit is one page request every 1100 ms.
+- Use `--dry-run` first to preview actions.
+
+## Setup
+
+```bash
+npm install
+```
+
+## Run
+
+```bash
+npm run clean:vcv -- --dry-run
+```
+
+Then run the real cleanup:
+
+```bash
+npm run clean:vcv
+```
+
+The browser opens to the login page. Log in manually and the script auto-continues when login is detected.
+
+## Per-page reporting
+
+The script prints one report line per page, for example:
+
+```text
+[page 12] mode=apply candidates=5 removed=4 keptHardware=1 unchanged=no url=https://library.vcvrack.com/?page=12&...
+```
+
+- `candidates`: visible `Remove` buttons on that page
+- `removed`: non-hardware-clone modules removed (or would be removed in dry-run)
+- `keptHardware`: removable modules kept because they have `Hardware clone`
+- `unchanged`: `yes` when no removals happened on that page
+
+## Options
+
+- `--dry-run` preview only, no clicks
+- `--headless` run without opening browser UI
+- `--delay-ms=1100` page query delay (minimum is 1000)
+- `--nav-timeout-ms=30000` timeout per page navigation
+- `--login-timeout-ms=300000` max wait for login detection
+- `--mode=all` scan all library pages (default)
+- `--mode=added` scan only your added modules view
+- `--start-page=1` start from a page index
+- `--max-pages=10` limit pages scanned from start page
+
+## Examples
+
+Scan all pages with rate limit:
+
+```bash
+npm run clean:vcv -- --mode=all --delay-ms=1100
+```
+
+Scan only added modules:
+
+```bash
+npm run clean:vcv -- --mode=added --delay-ms=1100
+```