Skip to main content

Jupyter Storage Explorer launcher

PyPI - Version

Adds Storage Explorer to JupyterLab's launcher (section Other) and command palette. It opens Jupyter Storage Explorer in its own tab, on the folder JupyterLab's file browser shows.

The Storage Explorer item in JupyterLab's launcher

It also integrates every Storage Explorer, in its tab or in a notebook, with JupyterLab:

  • Drag and drop: drag files onto JupyterLab's file browser to download them there.
  • Open files in a tab: double-click a file to open it in JupyterLab's own editor or viewer; Save writes it back to the storage.
  • Query data in a tab: open the data browser in a tab of its own.

Installation

pip install jupyter-storage-explorer-launcher

Install it in the environment of JupyterLab and of the default kernel (on JupyterHub, usually the single-user image), then restart JupyterLab. Requires JupyterLab 4.

Or from JupyterLab itself, without a terminal: run this in a notebook, then reload the page (no restart needed):

%pip install jupyter-storage-explorer-launcher

This works when the notebook's kernel runs in JupyterLab's own environment, as the default kernel usually does.

Then see Using the explorer.

Configuration

Configure the tab with files storage-explorer/launcher.py in Jupyter's configuration directories (jupyter --paths, config section), e.g. /etc/jupyter/storage-explorer/launcher.py for everyone and ~/.jupyter/storage-explorer/launcher.py for you. Each file is a layer, applied from the system's to the user's, and has some of these functions:

Function Returns Merged with earlier layers
filesystems() {name: URL or fsspec filesystem} By name: added or replaced; None removes one
formats() Formats of your own (DataFormat), tried before the defaults Later layers' first
format_options() Options for the default formats (Format options) By option name
operations() File operations of your own (FileSystemOperations) Later layers' first, all before the defaults
filesystem_mappers() How storages are told apart and their URLs (FileSystemMapper) Later layers' first, all before the defaults
transfer_policy() Rules of a transfer policy Later layers' first, so they decide first
parameters() Other StorageExplorer arguments, e.g. {"height": "fill"} By name
final() Settings later layers cannot change, e.g. ["filesystems"] Function names (except parameters) and parameter names

"." is the folder the tab opens on. The tabs share bookmarks and query settings in ~/.jupyter/storage-explorer/states.json, unless parameters() sets states (None: in each tab's memory). Final settings are not a security boundary: users can still create explorers in notebooks.

For example, for everyone, /etc/jupyter/storage-explorer/launcher.py:

def filesystems():
    return {
        "Here": ".",
        "Data lake": "abfs://lake@myaccount.dfs.core.windows.net",
    }


def transfer_policy():
    # No downloads from the lake to users' computers or to the Jupyter server.
    return [
        {"rule": "deny", "src": r"abfs://lake@.*", "dest": "browser:///.*"},
        {"rule": "deny", "src": r"abfs://lake@.*", "dest": "jupyterlab://.*"},
    ]


def final():
    return ["filesystems", "transfer_policy"]  # users cannot change these

And for one user, ~/.jupyter/storage-explorer/launcher.py:

def parameters():
    return {"max_browser_items": 50_000}

To change the explorer's icons, use JupyterLab's custom.css (see Icons), which applies to the launcher's tabs and to explorers in notebooks alike. style(), which earlier versions used for this, is ignored, with a warning in the tab.

Metadata

Release files for jupyter-storage-explorer-launcher 0.11.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jupyter-storage-explorer-launcher 0.11.2
File Size Uploaded
jupyter_storage_explorer_launcher-0.11.2.tar.gz 70.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for jupyter-storage-explorer-launcher 0.11.2
File Interpreter ABI Platform
jupyter_storage_explorer_launcher-0.11.2-py3-none-any.whl Python 3 none any Details

Total release size: 110.7 kB

Release files / jupyter_storage_explorer_launcher-0.11.2.tar.gz

Download URL jupyter_storage_explorer_launcher-0.11.2.tar.gz
Size 70.6 kB
Tags Source
SHA-256 checksum
How to use checksums
28ba586e498de72b2f6ec0bd5bc7100a32269674dabc75d6ad78792b088b9e50
BLAKE2b-256 checksum
How to use checksums
18f3671a600b13cf0b47c8f0ec507679bfd0f843ae9f96c7e4c2e384629afee4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release files / jupyter_storage_explorer_launcher-0.11.2-py3-none-any.whl

Download URL jupyter_storage_explorer_launcher-0.11.2-py3-none-any.whl
Size 40.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
000b3a22f202d79bda8f1894067eeef869506b987fceea33f6c2c6db94a39599
BLAKE2b-256 checksum
How to use checksums
2a47669d544d5adb6f0929ce33e3c18a20e307e41be301987768855a99be0036
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release history Release notifications | RSS feed

0.12.1

2 release files

0.12.0

2 release files

0.11.3

2 release files

This release

0.11.2 This release

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.6

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page