A napari plugin for file watching

This plugin contains two widgets: file watcher and script editor.

Usage: file watcher

The file watcher monitors a folder and displays its images (tiff, ome-zarr or hdf5) as napari layers, watch the following video for a demo:



  1. Select the folder you want to monitor by pressing "Browse".
  2. Select the extension of the files: "zarr", "hdf5" or "tiff".
  3. Click "Watch and run" to display the current items & the newly arrived as napari layers.
  4. If you click in one of the files of the list, the metadata will show (for hdf5 and zarr)

Usage: scripting editor

The script editor is for developing scripts and saving them in the filesystem. We have used this widget in the context of developing scripts for microscopy control software that implements another file watcher.


  1. Select the folder where you want to save your scripts in "Browse".
  2. Type the name of the script in the edit box below.
  3. Click "Add" for saving it into the folder after typing, or "Open" to display an existing file.


You can install napari-file-watcher via [pip]:

pip install napari-file-watcher

Or if you plan to develop it:

git clone
cd napari-file-watcher
pip install -e .

If there is an error message suggesting that git is not installed, run conda install git.


Contributions are welcome, tests are run with pytest.


Issues can be reported at:


  • 0.1.1

Last updated:

  • 16 January 2023

First released:

  • 16 January 2023


Supported data:

  • Information not submitted

Plugin type:

GitHub activity:

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

Python versions supported:

Operating system:

  • Information not submitted


  • napari
  • ome-zarr
  • zarr
  • h5py
  • PyQt5
  • qtpy
  • QScintilla

Sign up to receive updates