skip to navigation
skip to content 0.1.4 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) 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]
File Type Py Version Uploaded on Size (md5) Python Wheel 2.7 2015-06-22 9KB (md5) Source 2015-06-22 15KB