Simple Browser is a tiny Electron shell that launches a Chromium window with remote debugging enabled. The project is published as an npm binary so you can spin up a clean browser profile from the command line in seconds.
npm install simple-browserSimple Browser is a tiny Electron shell that launches a Chromium window with remote debugging enabled. The project is published as an npm binary so you can spin up a clean browser profile from the command line in seconds.
- Simple Browser
- Quick Start
- Run once
- Install globally then run
- CLI Usage
- Project Structure
- Contributing
- License
``bash`
npx --yes simple-browser@latest
`bashInstall
npm install --global simple-browser@latest
When no URL is provided, the browser opens the Chrome DevTools protocol version endpoint that is exposed on the bundled remote debugging port.
CLI Usage
`bash
Open a specific URL
npx --yes simple-browser@latest https://example.comPass Chromium command-line switches before the URL
npx --yes simple-browser@latest --disable-gpu https://example.com
`- The final positional argument is treated as the initial URL to load.
- Any preceding arguments are appended as Chromium command-line switches (for example
incognito, disable-gpu, etc.).
- The app automatically enables remote debugging. Set REMOTE_DEBUGGING_PORT to pin it to a specific port; otherwise it chooses a free port starting at 9222.
- Tip: To navigate, open the DevTools console and run window.location = "https://example.com".Project Structure
-
src/main.ts configures the Electron main process, window defaults, and crash recovery.
- src/preload-content.ts exposes a minimal preload bridge (currently empty).
- TypeScript sources compile to build/ during publishing, and the run script wraps the packaged executable.Contributing
1. Install dependencies:
`bash
npm install
`2. Run the development build (watches
src/ with nodemon and opens devtools):
`bash
npm run dev
`3. For a production-like launch:
`bash
npm start
`4. For publish:
`bash
npm publish --access public
`Pull requests are welcome! Please describe any behavioral changes and include testing notes.
License
MIT — see
LICENSE`.