Skip to main content

Add entries to start Jupyter from context menu.

Project description

Supported python versions PyPI version Conda forge version Github tests status License: GPL v3

Description

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

WinPython and Anaconda/ Miniconda/ Miniforge/ Mambaforge 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.

Linux

On linux, the supported file managers are: Nautilus (GNOME), Caja (MATE), Dolphin (KDE) and Nemo (Cinnamon). With Nautilus and Caja, the shortcut will appear in the Scripts menu and with Dolphin, it will appear in the Actions menu.

Jupyter context menu entries in Nautilus

Jupyter context menu entries on Linux (Nautilus).

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 on Linux the processes run in the background: to stop the jupyter notebook or lab, don’t forget to exit using the quit button - only closing the tab will not stop the jupyter server. Alternatively, nbmanager can discover all running servers and shut them down using via an UI.

macOS

Jupyter context menu entries in macOS

Jupyter context menu entries on macOS.

The context menu is only available when an object (folder or file) is selected in Finder. The Jupyter options will be available from the “Services” section of the menu. If a folder is selected then an instance of Jupyter QTConsole/notebook/lab opens in the selected folder. If a file is selected then Jupyter is started in the file directory. If the file is a jupyter notebook (*.ipynb), then selecting Jupyter notebook/lab will open the file in that program; Jupyter QtConsole will still only open in the file directory.

As the processes are opened through a shell script in Automator, a spinning cog will be visible in the menu bar when the processes are running. Once you have finished with the server then manually kill the process via the drop-down menu from this spinning cog.

The launchers have been tested on macOS Mojave (10.14) to Sonoma (14).

Installation instructions

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

Usage

Create context menu shortcut(s)

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

$ 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 and OSX only for the current user.

Remove context menu shortcut(s)

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

$ start_jupyter_cm --remove

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.

Optional arguments

On Linux, several file manager can be installed, to create or remove the context menu shortcut(s) for a specific file manager, use the --file_manager (-f) option:

$ start_jupyter_cm -f nautilus

Help

Use the command line help for more information:

$ start_jupyter_cm -h

More information

Linux

On linux, the context menu shortcuts are created by adding scripts or configuration files for each file manager. The location of these files are:

  • Nautilus: ~/.local/share/nautilus/scripts

  • Caja: ~/.config/caja/scripts

  • Dolphin: ~/.local/share/kservices5/ServiceMenus

  • Nemo: ~/.local/share/nemo/actions

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.3.2.tar.gz (59.6 kB view details)

Uploaded Source

Built Distribution

start_jupyter_cm-2.3.2-py3-none-any.whl (58.1 kB view details)

Uploaded Python 3

File details

Details for the file start_jupyter_cm-2.3.2.tar.gz.

File metadata

  • Download URL: start_jupyter_cm-2.3.2.tar.gz
  • Upload date:
  • Size: 59.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for start_jupyter_cm-2.3.2.tar.gz
Algorithm Hash digest
SHA256 d9f9107e1af763fd2eb227fc39cd7bd61da216f5dada7aa1161c3a2059559c90
MD5 3ac53dfba4692ac5825258851b47bad3
BLAKE2b-256 0e99518d62aa7edfcf76f9a7e100368e1634f055a393a81ac3684b4d0b1c7192

See more details on using hashes here.

Provenance

File details

Details for the file start_jupyter_cm-2.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for start_jupyter_cm-2.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3e49129a6d8e97fc225533d0055a2258df954f0461d626b9672f7a5d0eabf0a0
MD5 137527a7548fb76d04e5ed43d6f8c1ea
BLAKE2b-256 676ccd7812a7781d9f853a129964b22ad37c874f01aa49066327948e6ba1b374

See more details on using hashes here.

Provenance

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