Debugging Your Chromium App with DevTools

You can use Chrome DevTools to debug the web content inside your Java app that uses Equo Chromium.

Important: Only use this in development — do not enable in production!

Step 1: Enable Debugging

Tell Chromium to expose a debug interface by setting this system property:

-Dchromium.debug_port=8888

Add this to your Java launch options or run configuration.

Step 2: Open Chrome’s Inspect Page

  1. Open Google Chrome

  2. Visit: chrome://inspect

Step 3: Add Your Application

Inside the inspect page: Click "Add connection…​" Enter: localhost:8888 Confirm

Step 4: Refresh and Find Your Target

Go back to chrome://inspect Click "Configure…​" if needed Wait a few seconds — your embedded browser should appear under Remote Target Click "Inspect" to open DevTools for your Java app’s browser

Get DevTools URL in Code

You can also programmatically get the DevTools URL from Java:

String devtoolsUrl = browser.getDevtoolsUrl();
System.out.println("Debug at: " + devtoolsUrl);

Paste the URL in Chrome to open the DevTools directly.