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:
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.