VCV-Hardware-Module-Selector/README.md

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

npm install

Run

npm run clean:vcv -- --dry-run

Then run the real cleanup:

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:

[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:

npm run clean:vcv -- --mode=all --delay-ms=1100

Scan only added modules:

npm run clean:vcv -- --mode=added --delay-ms=1100