Skip to content

Simple wrapper to drive Google Chrome from Python

License

Notifications You must be signed in to change notification settings

timgates42/chromote

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chromote

Simple wrapper to drive Google Chrome from Python using the Remote Debugging Protocol 1.2 API

Installation

$ pip install chromote

API

>>> from chromote import Chromote
>>> chrome = Chromote()
>>> chrome
Chromote(host="localhost", port=9222)
>>> print chrome
[Chromote(tabs=1)]
>>> tab = chrome.tabs[0]
>>> print tab
Google - https://www.google.co.uk/
>>> print tab.url
https://www.google.co.uk/
>>> tab.reload()
'{"result":{},"id":1}'
>>> tab.set_url('https://github.com/chromote')
'{"id":2,"result":{}}'
>>> tab.set_zoom(1.2)
'{"id":1,"result":{"result":{"type":"number","value":1.2,"description":"1.2"},"wasThrown":false}}'
>>> tab.evaluate('alert("Remotey");')

Note: Google Chrome needs starting with the --remote-debugging-port=<PORT> option to be controlled remotely.

Remote Browser Control

The remote debugging port binds to localhost only so using chromote with a remote machine like a dashboard/kiosk setup will require tunneling to the machine first.

On the remote machine start Google Chrome:

$ chromium-browser <URL> --incognito --kiosk --remote-debugging-port=9222

On the local machine set up a tunnel to map the remote debugging port to 9222 on localhost:

$ ssh remote-machine -L 9222:localhost:9222

You can then drive your dashboard/kiosk machine remotely to display the content you want.

from time import sleep
from chromote import Chromote

chrome = Chromote()
tab = chrome.tabs[0]

sites = [
    'https://github.com',
    'http://stackoverflow.com',
]

while True:
    for site in sites:
        tab.set_url(site)
        sleep(30)

License

MIT Copyright (c) 2016 Chris Seymour

About

Simple wrapper to drive Google Chrome from Python

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%