Skip to content

JPITSG/ChromeDevLauncher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chrome Developer Launcher

A Windows 10+ system tray utility that launches Chrome with remote debugging enabled for AI agent automation.

Features

  • Remote Debugging - Launches Chrome with --remote-debugging-port for Chrome DevTools Protocol access
  • Port Forwarding - Automatically sets up netsh port forwards for all non-loopback network interfaces
  • System Tray - Runs quietly in the system tray with status monitoring
  • Status Display - Shows Chrome version, API status, and active port forwards
  • Configuration - Registry-backed settings with modern WebView2 configuration dialog
  • Auto-Elevation - Automatically requests administrator privileges (required for port forwarding)
  • Single Instance - Prevents multiple instances from running simultaneously
  • Clean Shutdown - Removes port forwards and terminates Chrome processes on exit

Requirements

  • Windows 10 or later
  • Administrator privileges (for netsh port forwarding)
  • Google Chrome installed
  • Microsoft Edge WebView2 Runtime (included with Windows 11; download for Windows 10)

Usage

  1. Run ChromeDevLauncher.exe
  2. Accept the UAC elevation prompt
  3. Configure Chrome path via right-click menu if not auto-detected
  4. Chrome launches with remote debugging on port 9222 (default)

Configuration Options

  • Chrome Executable Path - Path to chrome.exe
  • Debug Port - Remote debugging port (default: 9222)
  • Chrome IP Address - Address Chrome binds to (default: 127.0.0.1)
  • Status Check Interval - How often to poll Chrome DevTools API (default: 60 seconds)

Settings are stored in the Windows Registry at:

HKEY_CURRENT_USER\SOFTWARE\JPIT\ChromeDevLauncher

System Tray Menu

Right-click the tray icon to see:

  • Chrome version and connection status
  • API response status
  • Active port forwards
  • Configure option
  • Exit option

Building from Source

Requires MinGW-w64 cross-compiler and Node.js on Linux:

make clean && make

This builds the React/shadcn frontend (assets/), embeds it into the executable as a resource, and cross-compiles with MinGW.

Output: release/ChromeDevLauncher.exe

License

MIT

About

Windows 10+ system tray utility that launches Chrome with remote debugging enabled for AI agent automation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors