DEV Community

Cover image for Introducing SoloPi Desktop, an open-source test workbench for connected devices
zimu liu
zimu liu

Posted on Edited on Originally published at linkedin.com AI-assisted

Introducing SoloPi Desktop, an open-source test workbench for connected devices

SoloPi Desktop brings device control, test workflows, regression runs, and performance analysis into one desktop app. It supports testing on physical Android devices, connects to HarmonyOS NEXT emulators through HDC, and lets teams coordinate tests across supported smart glasses and their companion phones. The built-in Agent can also start a test from chat.

SoloPi Desktop home screen after skipping the first-run setup

What you can do with SoloPi Desktop

Feature When to use it
Built-in Agent Find devices and test cases, and start a test from chat
Device control and record/replay Turn a repeatable phone interaction into a regression test
Visual workflows and run reports Combine actions, commands, and assertions, then identify the step that failed
Performance and battery analysis Investigate an app’s resource usage over time and review estimated battery use by app
CLI batch runs Run existing test cases from a regression script
Team configuration and lab connections Share test cases and quick actions, and connect to a self-hosted device lab

Run a test on a physical device from Agent chat

Connect a phone and configure a model. In Agent chat, ask the built-in Agent to find connected devices and available cases, run an existing case on a specific phone, or show the result. The example shows a device and a test case returned by the Agent. Agent chat is currently experimental.

English illustration of Agent chat showing a connected Android device and an available test case

AI-translated illustration based on an earlier device session.

Record a phone interaction and replay it as a test case

Open Device control to inspect the screen, tap UI elements, enter text, and scroll from your computer. Save the recorded actions as a reusable test case. The example below records an Alipay search on a physical Android phone. For HarmonyOS NEXT, the device-control workflow currently supports HDC-connected emulators. Device connection guide

English illustration of an Alipay Membership search recorded on a physical Android device

AI-translated illustration of the original recording, including the phone screen.

Add an assertion to verify the result during replay. For example, check that the search field contains the expected text. If it differs, the assertion fails and the run report shows which check failed.

Build a workflow and find the step that failed

Use the visual editor to combine recorded actions, ADB commands, local scripts, and assertions. You can import existing SoloPi mobile cases as JSON and edit their steps. Put cleanup actions such as returning to the home screen in the separate Final section. A smart-glasses workflow can include an action on the phone, a check on the glasses, and a log check. The exact steps depend on your devices and test setup. Importing existing SoloPi cases

English illustration of the SoloPi Desktop workflow editor with Main workflow and Final cleanup tabs

AI-translated illustration based on the macOS workflow editor.

After a run, open Test runs to review each case’s status and duration. Expand the details to inspect individual steps and their outputs.

Physical-device test run report showing the case status, step count, and duration

Collect performance data and review trends

In Performance tests, choose a device and a target app. While the app is running, SoloPi Desktop can sample CPU usage, memory usage, thread count, and device battery temperature. The screenshot shows samples collected while Google Play was running on a physical Android phone.

English SoloPi Desktop performance report showing Google Play data collected on a physical Android phone

Compare the metrics over the same time period to see what changed, then export the report as HTML to share it. Battery analysis can also show estimated battery usage by app from Android battery statistics.

Run existing cases in batches from the CLI

Submit multiple saved cases from a regression script. Use the run ID to check progress and read structured results back into your workflow. Desktop CLI guide

Share team settings and connect to a device lab

Import a team configuration JSON file to reuse shared test libraries and quick actions. You can import it during first-run setup or later from Settings → Team setup & onboarding.

If you run your own SoloPi Lab Server, configure the server connection and device groups in Desktop.

Download and try it

  1. Choose the Desktop installer for Apple Silicon macOS or Linux x64 from GitHub Releases. SoloPi releases
  2. Follow the first-run setup or skip it and configure the app later. Use Settings → Language → English in a build that includes the language picker. SoloPi Desktop remembers the selection.
  3. Enable USB debugging on an Android phone, connect it to your computer, and approve the debugging prompt. Open Device control, follow the prompts to set up SoloPi on the phone, select the device and target app, and record a short flow you already test manually.

If you try it, we’d like to hear what you ran on a real device and where you got stuck. Source code · Report an issue · Project website

Top comments (0)