Skip to content


Subversion checkout URL

You can clone with
Download ZIP


Ability to open the notebook in a browser when it starts #891

merged 1 commit into from

2 participants


When the notebook starts up, it opens a browser with its homepage.

Currently, this simply makes the call to launch the browser immediately before entering the server loop. On my system, the server is running by the time the browser requests the homepage. If this isn't sufficient, we'll just need to use a threading.Timer to delay it for a fraction of a second.

There's a config option, and a flag --no-browser to control this behaviour.

@fperez fperez merged commit e9f8f8c into ipython:master
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
This page is out of date. Refresh to see the latest.
Showing with 13 additions and 2 deletions.
  1. +13 −2 IPython/frontend/html/notebook/
15 IPython/frontend/html/notebook/
@@ -22,6 +22,7 @@
import signal
import socket
import sys
+import webbrowser
import zmq
@@ -51,7 +52,7 @@
aliases as ipkernel_aliases,
-from IPython.utils.traitlets import Dict, Unicode, Int, List, Enum
+from IPython.utils.traitlets import Dict, Unicode, Int, List, Enum, Bool
# Module globals
@@ -111,11 +112,15 @@ def __init__(self, ipython_app, kernel_manager, notebook_manager, log):
flags = dict(ipkernel_flags)
+ {'IPythonNotebookApp' : {'open_browser' : False}},
+ "Don't open the notebook in a browser after startup."
# the flags that are specific to the frontend
# these must be scrubbed before being passed to the kernel,
# or it will raise an error on unrecognized flags
-notebook_flags = []
+notebook_flags = ['no-browser']
aliases = dict(ipkernel_aliases)
@@ -195,6 +200,9 @@ def _ip_changed(self, name, old, new):
password = Unicode(u'', config=True,
help="""Password to use for web authentication"""
+ open_browser = Bool(True, config=True,
+ help="Whether to open in a browser after starting.")
def get_ws_url(self):
"""Return the WebSocket URL for this server."""
@@ -291,6 +299,9 @@ def start(self):"The IPython Notebook is running at: %s://%s:%i" % (proto,
+ if self.open_browser:
+ ip = self.ip or ''
+"%s://%s:%i" % (proto, ip, self.port), new=2)
Something went wrong with that request. Please try again.