Skip to content

README.md

Latest commit

 

History

History
92 lines (59 loc) · 2.34 KB

README.md

File metadata and controls

92 lines (59 loc) · 2.34 KB

The Multi-Monitor Browser

This is a fullscreen Webkit based browser for kiosks and displays, with multi-monitor support.

Install

To install you just need Python, PyGTK and PyWebkitGtk.

On Debian and Ubuntu, you just need to install :

sudo apt install python-webkit python-gtk2

And clone this repository:

git clone https://github.com/thor27/multimonitor-browser.git

Usage

To run, you just need to execute the browser.py with an URL as argument:

./browser.py http://github.com/

If you have more than one monitor, you can run one URL for each monitor, for example:

./browser.py http://github.com/ http://www.python.org

Remember that you are locked in the hostname you called your script. For example, this will not work:

./browser.py http://www.github.com/

It will print on terminal:

github.com not allowed host. Allowed hosts are: www.github.com.

To allow more than one host, you can use the --allowed-hosts argument, like that:

./browser.py http://www.github.com/ --allowed-hosts github.com

You can even allow more than one extra host:

./browser.py http://www.google.com/ --allowed-hosts github.com www.github.com www.python.org pypi.python.org

So you can search in google Github and Python and enter in those specifics sites. You may also need to add to allowed-hosts your regional Google site, for example www.google.com.br

You can also disable this, and allow any site navigation using --allow-any-host:

./browser.py http://www.google.com/ --allow-any-host

So now you can go to any website googles shows to you.

Also, by default, you can't close browser window. To change this behavior you need to use --allow-close:

./browser.py http://www.google.com/ --allow-close

Detect Monitors Script

The detect_monitors.py script helps screen detection to know which monitor each URL will go. It returns URLs in correct order to use with browser.py

Example usage:

URLS=`./detect_monitors.py http://www.github.com/ http://www.python.org --messages "Select the monitor to show GitHub" "Select the monitor to show Python.org"`
./browser.py $URLS

Contributors

License

  • GPLv3