Getting Started | PromptTest Studio

Step 1: Download & Install PromptTest Studio

PromptTest Studio is distributed as a lightweight Windows application (per-user install, no administrative privileges required).

Go to the Downloads page and download the latest .exe installer.
Run the installer and follow the guided setup wizard.
Launch PromptTest Studio from your Start Menu or Desktop shortcut.

Windows SmartScreen Notice: "Windows protected your PC"?

When you first launch the installer, Windows Defender SmartScreen may show a blue warning because this is an independent, community-distributed release. The app is 100% safe, verified, and local-first:

1. Click the underlined link: "More info"

2. Click the button: "Run anyway"

Step 2: Prepare your Android Device

PromptTest Studio communicates with physical Android devices or official Android Emulators using ADB (Android Debug Bridge).

1. Enable Developer Options

Open Settings > About phone on your Android device.
Tap Build number 7 times until you see the message "You are now a developer!".

2. Enable USB Debugging

Go back to Settings > System > Developer options.
Toggle on USB debugging.
Connect the phone to your Windows PC with a USB cable.
When prompted with "Allow USB debugging from this computer?", check Always allow and tap Allow.

3. (Optional) Verify via Command Prompt

Open PowerShell or Command Prompt to confirm your device is recognized:

adb devices

You should see your device serial number listed with status device:

List of devices attached
19281FDF60002F    device

Step 3: Author and Run your First Test

Now that your device is connected, open PromptTest Studio:

Select Device: In the top navigation bar, ensure your connected device is selected in the device dropdown.
View Live Canvas: Your Android phone's live screen will appear in the central canvas.
Inspect & Click: Hover over any button or text field. Studio highlights the element boundaries. Click the element to generate test steps automatically.

Example Test Spec

# Launch the application
Launch "com.example.myapp"

# Navigate through onboarding
Tap "Get Started"
Type "tester@example.com" into "Email address"
Tap "Continue"

# Assert outcome
Assert "Welcome to your Dashboard" is visible

Click Run Suite. Studio will execute each step on the physical device, stream real-time pass/fail states, and save verification screenshots.

📶 How to Connect & Test over Wi-Fi (Untethered)

You can control and test Android devices completely wire-free over your local Wi-Fi network. Follow these steps for both your mobile device and PromptTest Studio:

Part A: Setup on your Android Mobile Device

Android 11, 12, 13, and 14+ (Native Wireless Debugging)

No USB cable is required at any point:

Ensure both your Android phone and Windows PC are connected to the same Wi-Fi network.
Go to Settings > System > Developer options.
Toggle on Wireless debugging and tap Allow for your current Wi-Fi network.
Tap directly on the "Wireless debugging" label to open its settings.
Tap "Pair device with pairing code". A popup will display a 6-digit Wi-Fi pairing code, your device's IP address, and a port number (e.g. 192.168.1.150:42135). Keep this screen open.

Android 10 and Older (USB-Assisted Wi-Fi)

For older Android versions, initiate Wi-Fi mode once using your cable:

Connect your device to your PC with a USB cable.
Open PowerShell and run: adb tcpip 5555
Disconnect the USB cable.
Find your phone's IP address under Settings > About phone > Status > IP address.

Part B: Connect inside PromptTest Studio Desktop

Open the Wireless Connection Modal

In the top Studio navigation bar, click the Device Selector dropdown and choose "Connect Device over Wi-Fi" (or click the Wi-Fi symbol).

Enter IP Address, Port & Pairing Code

Enter the IP address and port displayed on your phone's pairing screen (e.g., 192.168.1.150 and port 42135). If pairing for the first time on Android 11+, type in the 6-digit code.

Click Connect & Start Testing

Click Connect. Studio automatically authenticates with the device, turns the status badge green (Connected: Device Name), wakes the device display, and starts mirroring your screen untethered!

Start testing in three simple steps