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.

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

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.1
File Size Uploaded
jupyter_storage_explorer_launcher-0.11.1.tar.gz 70.5 kB Details

Built distribution (wheel)

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

Total release size: 110.5 kB

Release files / jupyter_storage_explorer_launcher-0.11.1.tar.gz

Download URL jupyter_storage_explorer_launcher-0.11.1.tar.gz
Size 70.5 kB
Tags Source
SHA-256 checksum
How to use checksums
cbf4cd1f1cd527b257ecd873f54a51596861b52ebde7cfa22defc6b32e7706ee
BLAKE2b-256 checksum
How to use checksums
4318a76764f29f20abdd38c5e26c5e7560a8868dc5e213fa1156c7409aaf76de
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.1-py3-none-any.whl

Download URL jupyter_storage_explorer_launcher-0.11.1-py3-none-any.whl
Size 40.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eeac12c2ef2cce073df9259ecf286eef6d644180f8a715154f91a24c88ab88a6
BLAKE2b-256 checksum
How to use checksums
a04c839070fa7359d43b126177c1b2f25936da9ad23e9ee141345e0bcfc5741c
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

0.11.2

2 release files

This release

0.11.1 This release

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