Your first test.
Starts small.

Start with the source.

Start in the root of your own TestHand checkout. Follow the repository README for your platform’s Qt SDK and build-tool requirements.

The Makefile selects Qt through QT_PREFIX. Set it to your own Qt installation prefix before building; installation paths and prerequisites differ by platform.

make help
make build

Choose your application.

Set the client path from the checkout root, then launch a supported Qt app. Replace the example path with your own executable.

The example below uses macOS/Linux POSIX shell syntax. For Windows, follow the repository’s Windows setup instructions instead.

export PYTHONPATH=$PWD/client
python3 -m testhand launch -- /path/to/YourApp
python3 -m testhand windows
python3 -m testhand tree --depth 3

For supported external access, use launch --desktop or attach --pid. Read the backend limitations and configure OS permissions before sending real desktop input.

Keep the first workflow focused.

Inspect the object tree to choose selectors that exist in your app. Try one action and one visible result, then grow the script.

# Launch and connect to your app first.
type 'Ada' --target '#nameEdit'
click '#greetButton'
wait '#greetingLabel' --for property \
  --property text --value 'Hello, Ada!'
screenshot --out result.png