Napari plugin for viewing Brain Image Library datasets

View datasets archived at the Brain Image Library.

**NOTE: This plugin is under early development. Currently, only a subset of single-channel, fMOST datasets which include projections are available to view. An example can be found here.

Plugin Demo GIF


  • Multiscale Rendering
    • In datasets that include multiple resolution representations of the data, each resolution can be combined to improve the speed of browsing and user experience. An example of a dataset with multiple resolution projections can be found here.
    • All datasets included in the current release of napari-bil-data-viewer use multi-resolution datasets.
  • 3D rendering of whole datasets. The lowest resolution is used for rendering. Currently, this is a limitation imposed by napari.
  • The plugin does NOT require a BIL account as datasets are already accessible via https.

Known Issues / limitations

  • Currently the only datasets that are available are those which have been manually selected by the developers. If you would like a specific dataset to be included please consider adding the dataset(s) to the file and submitting a pull request.
  • To inquire about this plugin please contact Brain Image Library support:
  • The plugin is still under development. We appreciate all reports of issues / errors which occur during use.

This napari plugin was generated with Cookiecutter using with @napari's cookiecutter-napari-plugin template.


Option #1: Install plugin via the napari plugin menu

  1. Menu: Plugins >> Install/Uninstall Plugins
  2. Search: napari-bil-data-viewer
  3. Select install

Option #2: Install a fresh python virtual environment

# Example of venv creation using conda
conda create -y -n bil-viewer python=3.8
conda activate bil-viewer

# Install napari-bil-data-viewer
pip install napari-bil-data-viewer

# Run Napari


Please consider contributing to this project! Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.


Distributed under the terms of the BSD-3 license, "napari-bil-data-viewer" is free and open source software


If you encounter any problems, please file an issue along with a detailed description.

Change Log:


Initial release.

v0.1.1 & v0.1.2:

Changes to documentation


Added all available summary fMOST datasets


  • 0.1.3

Last updated:

  • 21 February 2023

First released:

  • 24 January 2022


  • BSD-3-Clause

Supported data:

  • Information not submitted

Plugin type:

GitHub activity:

  • Stars: 3
  • Forks: 1
  • Issues + PRs: 1

Python versions supported:

Operating system:


  • napari[all]
  • napari-plugin-engine (>=0.1.4)
  • scikit-image
  • fsspec
  • requests
  • aiohttp
  • imagecodecs
  • beautifulsoup4
  • dask

Sign up to receive updates