Jupyter Storage Explorer launcher
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.
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.0 or later.
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.
1 maintainer
Metadata
1 maintainer
Release files for jupyter-storage-explorer-launcher 0.12.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jupyter_storage_explorer_launcher-0.12.1.tar.gz | 71.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jupyter_storage_explorer_launcher-0.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 112.3 kB
Release files / jupyter_storage_explorer_launcher-0.12.1.tar.gz
| Download URL | jupyter_storage_explorer_launcher-0.12.1.tar.gz |
|---|---|
| Size | 71.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e9ce013201b28fa32168db7028d56d1a7ebcb309e6455d1f8af75920477964a9
|
|
BLAKE2b-256 checksum How to use checksums |
112d4386bde40b0add6219989c7bab973c9dfc31b040f1ca06f33a1ae88851c0
|
| 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 logRelease files / jupyter_storage_explorer_launcher-0.12.1-py3-none-any.whl
| Download URL | jupyter_storage_explorer_launcher-0.12.1-py3-none-any.whl |
|---|---|
| Size | 40.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8ee4058c5d948e38b9688fb1efc34b872ce149d3be32ec3138b6c95807520309
|
|
BLAKE2b-256 checksum How to use checksums |
9d2824e6bcbaeb64c6fd761fce34dd812ca4464e9ab70cde66e50419063e53d6
|
| 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
