Skip to main content

Add entries to start Jupyter from context menu.

Project description

pypi_version python_version conda

Description

Add entries to start the Jypyter Notebook and QtConsole from the file manager context menu. This offers a convenient way of starting Jupyter in a folder. Currently it only supports Microsoft Windows and GNOME (and its many derivatives). Contributions to support other OSs/desktop environments are highly welcome.

WinPython and Anaconda/Miniconda distributions are supported. If run from a conda environment other than root, the name of the environment will be specified in brackets in the context menu name.

Microsoft Windows

Jupyter context menu entries in windows

Jupyter context menu entries in windows.

In addition to starting the QtConsole, the Jupyter Notebook or the Jupyter Lab, and launching the default browser, in Microsoft Windows the process runs from a terminal. Closing the terminal closes the QtConsole or the Jupyter server. Single and all users installations are supported, see installation instructions below.

GNOME

Jupyter context menu entries in windows

Jupyter context menu entries in gnome.

When selecting multiple folders, one instance of Jupyter QtConsole/notebook/lab opens in each of the selected folders. Selecting a file starts Jupyter in the file directory.

Note that in GNOME the processes run in the background. As of Jupyter Notebook 4.1 there is no way to shutdown the server from the notebook UI. To stop the server one has to manually kill the process. Alternatively, nbmanager can discover all running servers and shut them down using via an UI.

GNOME >= 2.22 is required.

Installation instructions

Any platform

Install from pypi using pip:

$ pip install start_jupyter_cm

Or install from conda-forge channel using conda (in a Anaconda/Miniconda distribution):

$ conda install -c conda-forge start_jupyter_cm

After installation, enable the context menu entries from a terminal as follows:

$ start_jupyter_cm

To remove the context menu entries execute the following in a terminal:

$ start_jupyter_cm --remove

To uninstall the package:

$ pip uninstall start_jupyter_cm

On Microscoft Windows, the administrator rights are required to add the entry for all users, otherwise the entries will be added only for the current user. In GNOME only for the current user.

Also, be aware that, uninstalling the package does not remove the context menu entries. If you are left with the context menu entries after uninstalling start_jupyter_cm, reinstall it, remove the entries as above and uninstall it again.

Microsoft Windows

In Microsoft Windows the preferred way to install this package would be using the Windows MSI installers if it wasn’t for this Python bug. Until this issue is fixed, we will not distribute MSI installers.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

start_jupyter_cm-2.0.tar.gz (51.3 kB view hashes)

Uploaded Source

Built Distribution

start_jupyter_cm-2.0-py3-none-any.whl (49.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page