# chrome_remote_shell

**Repository Path**: allmost/chrome_remote_shell

## Basic Information

- **Project Name**: chrome_remote_shell
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-11-21
- **Last Updated**: 2021-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#chrome_remote_shell


###Client for the Google Chrome browser's remote debugging shell.

New update replaces old api code with new - no longer compatibile with 3+ year 
old chrome, now compatible with Chrome Remote Debugging Protocol


  See <https://developer.chrome.com/devtools/docs/debugger-protocol> for details on 
  Chrome's remote debugging protocol.

The protocol is composed of json messages described on the site above.

This library makes it easier to communicate with the Google Chrome remote
debugging api from Python.  To enable the debugging api port, start Chrome
with this option::

    google-chrome --remote-shell-port=9222
  
  
Note that Chromecast devices also open a remote debugging port and speak
this same api, on devices in development mode, and which are currently
running a dev app.  

Then you can connect from Python through code like this:

### Example

    >>> import chrome_remote_shell, json
    >>> shell = chrome_remote_shell.Shell(host='localhost', port=9222)
    >>> shell.connect(0)
    >>> url = 'http://www.clift.org/fred' # shameless
    >>> navcom = json.dumps({"id":0, "method":"Page.navigate", "params":{"url":url}})
    >>> shell.soc.send(navcom)
    >>> response = json.loads(shell.recv())
    

As a convenience, the shell connection object offers a method that, by
injecting JavaScript into the first tab, commands Chrome to open a URL
in a new tab::

    # equivalent to the api call above
    >>> shell.open_url('http://www.aldaily.com/')

#TODO Installation 


#CHANGELOG
*2014 Sept 15.* Updated to work with modern Chrome Remote Debugging protocol

*2014 Sept 15.* Package maintaince transitioned to Fred Clift

*2014 Sept 15.* Package migrated to GitHub.

*2009 Feb 26.* Added a conditional import of `simplejson` so that the
module runs under Python 2.5.