https://github.com/thlorenz/chromium-remote-debugging-proxy
A proxy that sits in between a chromium devtools frontend and the remote chromium being debugged and logs requests, responses and websocket messages that are exchanged.
https://github.com/thlorenz/chromium-remote-debugging-proxy
Last synced: 19 days ago
JSON representation
A proxy that sits in between a chromium devtools frontend and the remote chromium being debugged and logs requests, responses and websocket messages that are exchanged.
- Host: GitHub
- URL: https://github.com/thlorenz/chromium-remote-debugging-proxy
- Owner: thlorenz
- License: mit
- Created: 2014-09-28T18:47:00.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2020-09-04T22:47:40.000Z (almost 5 years ago)
- Last Synced: 2025-06-01T19:11:52.731Z (about 1 month ago)
- Language: JavaScript
- Homepage: http://thlorenz.github.io/chromium-remote-debugging-proxy/
- Size: 178 KB
- Stars: 20
- Watchers: 2
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# chromium-remote-debugging-proxy
A proxy that sits in between a chromium devtools frontend and the remote chromium being debugged and logs requests, responses and websocket
messages that are exchanged.
## Usage
### Start Proxy
```
crdp
```
### Start Chromium with remote debugging enabled
```
./Chromium.app/Contents/MacOS/Chromium --remote-debugging-port=9222 --no-sandbox
```
### Open DevTools in another Browser
Make sure it points to the Proxy Port (by default `REMOTE_PORT -1`).
[localhost:9221](http://localhost:9221/)
## Installation
npm install chromium-remote-debugging-proxy
## Proxy Usage
```
crdp
Proxies requests from chromium devtools frontend and the remote chromium being debugged and logs requests, responses and websocket messages that are exchanged.
OPTIONS:
-l, --loglevel level at which to log: silly|verbose|info|warn|error|silent -- default: info
-r, --remote overrides port at which remote Chromium is listening, same as --remote-debugging-port (default: 9222)
-p, --port overrides proxy port (default: --remote - 1)
-o, --outfile if supplied all the incoming and outgoing messages are written to it as comma-delimited JSON, but requests and responses are not
all messages have a 'direction' attached to the message taking the view point of the DevTools frontend
outgoing: '=>'
incoming: '<='
in order to parse the resulting JSON remove the last ',' and surround it with [ ]
-h, --help Print this help message.
EXAMPLES:
Assume Chromium is listening on remote debugging port 9222, make proxy listen on port 9221 and write JSON messages to ./messages.json
crdp --remote 9222 -outfile messages.json
```
## Visualizer Usage
In order to better understand the messages the `crdp-visualize` is included. It will sort messages and thus group
outgoing ones right next to the incoming message sent in response.
After generating a JSON message file via the crdp `--outfile` option do the following:
```
crdp-visualize ./path-to-file.json
open ./path-to-file.html
```
[sample html](http://thlorenz.github.io/chromium-remote-debugging-proxy/)
## License
MIT