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

Installation

Fetch the latest version:

git clone https://github.com/kostrykin/jupyter-ctrl.git

Install as a user:

cd jupyter-ctrl
python2 setup.py install --user

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

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

Usage

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

jupyter-daemon.py

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 `jupyter-view.py 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 jupyter-daemon.py, you may also want to put jupyter-indicator.py on your list of automatically started desktop applications, which is a highly rudimentary user interface for the daemon:

http://raw.githubusercontent.com/kostrykin/jupyter-ctrl/master//doc/jupyter-indicator.png?raw=true

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 Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page