Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today! is a cross-platform script (web) and API for launching a browser(with x-www-browser (Linux, Unix), open (OSX), start (Windows),or python -m webbrowser)

Project Description is a cross-platform script (web) and API for launching a browser (with x-www-browser (Linux, Unix), open (OSX), start (Windows), or python -m webbrowser)


  • Open the configured default system web browser with one or more paths or URIs
  • Open to a relative path
  • Open to an absolute path


Install the web (and x-www-browser-) scripts:

pip install
pip install -e


The web script commandline interface:

web .
web ./index.html
web $WORKON_HOME/dotfiles/src/dotfiles/docs/_build/html/index.html
web localhost:8082   #  pgs docs/_build/html  # pypi:pgs
web  # !HTTPS!
x-www-browser- .

web --help commandline help:

Usage: [-b|-x|-o|-s] [-v|-q] <url1> [<url_n>]

Open paths or URIS as tabs in the configured system default webbrowser

  -h, --help           show this help message and exit
  -b, --webbrowser     Open with `python -m webbrowser`
  -x, --x-www-browser  Open with `x-www-browser` (Linux, X)
  -o, --open           Open with `open` (OSX)
  -s, --start          Open with `start` (Windows)
  -v, --verbose
  -q, --quiet
  -t, --test


  • Instances of websh.websh.WebBrowser implement open_new_tab()

  • websh.websh.WebBrowser.x_www_browser calls open_new_tab() with a list of paths and/or URIs

  • web <urls> calls websh.websh.WebBrowser.x_www_browser to open new tabs for each path or URI:

    urls = (["",
    output = list(WebBrowser.x_www_browser(urls))

Platform Notes

  • OSX: web -o ./README.rst and web -b ./README.rst open README.rst in the configured editor (not the configured system browser).


    • Specify the full path to a specific browser application followed by a quoted URI, for each URI in a newline-delimited list


0.1.1 (2015-06-21)

  • DOC: README.rst: links, Features, Usage, API
  • BLD: console_script entrypoint web = websh.web:main
  • BLD: console_script entrypoint x-www-browser- = websh.web:main
  • BUG,REF: logging, logging config [07f9a0f]
  • BUG,CLN,DOC,REF,TST: match_domain, :PymodeLintAuto, argv, logging config [4b33395]
  • ENH: [29c0ca7]
  • BLD,RLS: *,, cookiecutter gh:audreyr/cookiecutter-pypackage [e288536]

0.1.2 (2015-06-21)

  • DOC: README.rst: API docs
  • RLS:, __version__ = 0.1.2
  • First release on PyPI

0.1.3 (2015-06-21)

  • DOC: README.rst, HISTORY.rst: formatting, links, release notes

0.1.4 (2015-06-21)

  • RLS:, __version = ‘0.1.4’ [8e33773]
  • BUG: py26, py34 compat [a6ed31a]
  • BLD: tox.ini, .travis.yml: commands = python websh/ -v -t [295abab]
  • DOC:, README.rst: usage docstrings [d054b43]
  • DOC: README.rst: links [bc1d06c]
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (9.6 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Jun 22, 2015 (15.6 kB) Copy SHA256 Checksum SHA256 Source Jun 22, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting