Skip to content

Setup & Recording

Running the recorder is a single command. There is no install step — run.bat sets up everything it needs the first time you use it.


Step 1: Open a Terminal

Open PowerShell and navigate to the folder where you unzipped the recorder:

cd C:\path\to\your\folder

Tip

Type cd (with a space) and then drag the folder into the PowerShell window to paste its path.

Step 2: Start Recording

.\run.bat record https://your-application-url.com
run.bat record https://your-application-url.com

Replace https://your-application-url.com with the actual URL of the application you want to record.

The first run takes a few minutes

Before recording starts, the recorder installs uv if needed, downloads its own copy of Python 3.13, and downloads Chromium. Later runs start in a couple of seconds.

If the uv install step runs, close PowerShell and open it again before your next run.

View All Options

To see additional recording options and parameters:

.\run.bat record -h
run.bat record -h

During Recording

  • A Chromium browser window will open automatically.
  • Navigate through your application and perform the interactions you want to record.
  • The recorder captures all clicks, inputs, and navigation.
  • To stop recording: simply close the browser window.

Output

Once recording is complete, the tool generates a zip file containing all the captured metadata from your session. The recorder prints the output path when it finishes.

Troubleshooting

"uv is not recognized" : Close PowerShell, open it again, and retry. The installer adds uv to your PATH, but only new windows pick that up.

"running scripts is disabled on this system" : Your machine blocks PowerShell scripts. Run this once:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

The browser never opens : Install Chromium by hand, then try again:

.\run.bat playwright install chromium

ImportError: DLL load failed while importing _greenlet : This means a Python version the browser libraries cannot work with is being used. run.bat pins Python 3.13 specifically to avoid this — do not remove the --python 3.13 argument from it.

Anything else : Send the full text of the error, plus the log file path that the recorder prints when it starts. See Support.

Next Step

Upload the recording to Test Case Generator.