Custom executable name

In some cases you may want to customize how the Chromium subprocess appears in your system’s task manager or monitoring tools. This is especially useful in environments where multiple instances or multiple applications using Equo Chromium are running simultaneously.

When a Java application uses Equo Chromium, it starts a separate native Chromium subprocess behind the scenes. By default, this subprocess has a generic name (equochro_helper). However, you can change this name to something more descriptive — such as the name of your application — to make process management easier.

Equo Chromium provides a system property that lets you define a custom name for the Chromium subprocess.

Setting a custom executable name

To specify a custom name for the Chromium subprocess, use the following Java system property before you create any browser instance (either Browser or ChromiumBrowser):

-Dchromium.executable.name=MyAppProcess

Replace MyAppProcess with the name you’d like the operating system to display for the Chromium subprocess associated with your application.

This will result in the Chromium subprocess being named FinanceDashboard in tools like Task Manager (Windows), Activity Monitor (macOS), or top/htop (Linux).

  • This property Must Be Set Early, before any Browser or ChromiumBrowser instances are created. Otherwise, the default executable name will be used and cannot be changed afterward.

  • This feature is available as of version ´124.0.8´.