Skip to main content

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.

Project details

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page