Skip to main content

A napari plugin for file watching

Project description

File watcher plugin for napari (napari-file-watcher)

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:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

napari-file-watcher-0.1.1.tar.gz (21.0 kB view hashes)

Uploaded Source

Built Distribution

napari_file_watcher-0.1.1-py3-none-any.whl (23.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page