Browser sources

Discover which local browsers and profiles are available, or register custom Chromium-based browsers.

Command: browserless profile sources <subcommand>

Subcommands

• list List all detected local browsers with their available profiles.
• add Register a custom Chromium binary.
• rm <name> Remove a custom browser registration.

Flags for sources add

• --name <name> Display name for the custom browser.
• --path <path> Path to the Chromium binary.
• --user-data-dir <path> Path to the browser's user data directory.

Examples

List available browsers

browserless profile sources list

Register a custom browser

browserless profile sources add \
  --name "My Chromium" \
  --path /opt/chromium/chrome \
  --user-data-dir ~/.config/my-chromium

Supported browsers

The CLI detects these browsers out of the box:

Key	Display name
chrome	Google Chrome
chrome-beta	Google Chrome Beta
chrome-dev	Google Chrome Dev
chrome-canary	Google Chrome Canary
brave	Brave
edge	Microsoft Edge
vivaldi	Vivaldi
opera	Opera
arc	Arc
chromium	Chromium (incl. Snap on Linux)

The --browser flag is case-insensitive: --browser CHROME, --browser Chrome, and --browser "google chrome" all resolve to the same entry.

--profile accepts either the user-visible profile name from Chrome's Local State (e.g. Personal, Work) or the on-disk directory name (Default, Profile 1).