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!

Jupyter Notebooks Controller Daemon

Project Description

Daemon, which ensures, that the Jupyter notebooks server is started only once, no metter how often or where from you open a notebook. No root privileges required.

Besides of Jupyter, the package requires Python 2, Pyro and the argparse module. It was successfully tested with version 3.14 of Pyro and is known not to work with Pyro 4. On Ubuntu 14.04, the dependencies are satisfied by issuing the following command:

sudo apt-get install pyro


Fetch the latest version:

git clone

Install as a user:

cd jupyter-ctrl
python2 install --user

Ensure that ~/.local/bin is listed in your $PATH variable:

echo 'export PATH="$PATH:~/.local/bin"' >> ~/.bashrc


Add the following command to the list of commands to be run on start-up by your desktop manager:

On most Ubuntu-based systems, this is accomplished through the gnome-session-properties application.

Run the following command to open-up a notebook (e.g. Unnamed.ipynb in your working directory) in your favorite web browser:

xdg-open ` Unnamed.ipynb`

It’s convenient to set this to be the default “application” for opening up .ipynb files.

Alternatively, you can also use the jupyter-open bash script for convenience, which does the same:

jupyter-open Unnamed.ipynb

Note that file managers, which support .desktop files, should offer Jupyter Notebook as a method of opening files after installing this package. It was tested with Pantheon files 0.2.4.

Status Bar Indicator

Alongside of, you may also want to put on your list of automatically started desktop applications, which is a highly rudimentary user interface for the daemon:

Use the --icon parameter to adjust the appearance e.g. for bright or dark themes. The two icons jupyter-bright and jupyter-dark are installed by default, but you may also use any icon you like.

Release History

This version
History Node


History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers