Skip to content

Local Files ​

Open images, plates and slides from your own disk. Nothing is uploaded.

Reading from disk is the fastest and most private way to work, but it is not the only one. Your OME-ZARR Storage Setup Is Slowing You Down compares this with streaming from a server, and is worth reading before a lab or facility commits to one setup.

Which Browsers Can Do This ​

It depends on whether your data is one file or a folder.

What you openChrome, EdgeFirefox, Safari, iPhone, iPad
One file: a Zeiss .czi or .lsm, a Leica .lif, a Nikon .nd2, an OME-TIFF, a slide (.svs, .ndpi, .scn, Philips .tiff, .qptiff), or a zipped OME-Zarr (.ozx, .zip)YesYes
A folder: an OME-Zarr dataset, an Opera Phenix or Yokogawa plate, a plate saved as one CZI per field, an MRXS or DICOM slideYesNo
A zip of one of those foldersYesYes
A measurement table (CSV or Parquet)YesNo

Folders need Chrome or Edge

Dropping a folder and picking one both work in Chrome and Edge only. Firefox and Safari cannot read a folder from a web page, and neither can any browser on an iPhone or iPad.

Zip the folder and open the zip instead. See Zip Without Compression. Or open it by address, see Remote URLs.

To share a folder from your own machine as an address, use the free Data Server.

Open a File ​

Drop the file on the viewer. Or click Open Image, go to the Local Files tab and click Choose File.

A file dragged over the start screen: a dashed box lists what you can drop, a data folder, a zipped dataset, or a CZI, slide or OME-TIFF file
On the start screen
A file dragged over an open slide: the same box, with the line Asks before replacing the image you have open
On an open image: it asks before replacing it

What opens as one file:

  • Images: a Zeiss .czi or .lsm, a Leica .lif, a Nikon .nd2 or an OME-TIFF.
  • Slides: .svs, .ndpi, .scn, Philips .tiff and .qptiff.
  • Zips: a zipped OME-Zarr (.ozx or .zip), a zipped Opera Phenix or Yokogawa plate, and a zip without compression of a CZI plate, an MRXS slide or a DICOM slide.

Each format has its own guide: see Supported Formats. To make a zipped OME-Zarr, see A Dataset in a Single File.

Open a Folder ​

In Chrome or Edge, drop the folder on the viewer. Or click Open Image, go to the Local Files tab and click Choose Data Folder.

The Local Files tab of the Open Image window, with the Choose Data Folder and Choose File buttons

What opens as a folder:

  • An OME-Zarr dataset.
  • A plate: the measurement folder of an Opera Phenix or Yokogawa plate, or a folder of one CZI per field.
  • A slide: an MRXS slide (the .mrxs file with its folder) or a folder of DICOM files.

Dropping on an open image. No need to close what you have first. The viewer asks before it replaces your image, and Cancel leaves your view as it was.

If the Folder Holds Datasets ​

Open a folder that holds several images, and the viewer lists them. Pick one and it opens.

This works for every format: OME-Zarr datasets, CZI files and slides. One folder can mix them, say Aperio .svs and Hamamatsu .ndpi side by side.

The names in the list come from the data, not from the folder names. A dataset called plate-3 is found just as well as one called sample.ome.zarr.

Nothing is uploaded to make the list. The viewer reads it on your computer.

Zip Without Compression ​

Plates and slides saved as several large files need a zip made without compression. The viewer then reads only the parts it needs, from your disk or a web address. These files are already compressed, so a compressed zip saves little space, and the viewer asks you to make the zip again. Opera Phenix and Yokogawa plates are the exception: they open from either kind of zip.

On a Mac or Linux. Run this next to the folder:

bash
zip -0 -r slide.zip slide -x '*.DS_Store'

-0 turns compression off, and -x leaves out the hidden files a Mac adds.

On Windows. In 7-Zip, right-click the folder and choose 7-Zip, then Add to archive. Set Archive format to zip and Compression level to Store.

The built-in Compress in Finder and Compressed (zipped) folder in Explorer both compress. They suit an OME-Zarr folder, not these files.

To check a zip. Run unzip -v slide.zip. Every file should say Stored in the Method column.

Recent Images ​

What you open appears in Recently Opened on the landing page. Click it to reopen. Your annotations, channel settings and contrast are as you left them.

The viewer remembers where your data is, not a copy of it. So reopening asks you to confirm:

Chrome, EdgeFirefox, Safari
Reopen a file or folder from RecentOne permission clickPick the file again

Chrome and Edge can keep a lasting pointer to your file, so you only allow access. Firefox and Safari cannot, so they ask for the file again. Either way you land back on the same image, with everything as you left it.

Why the viewer does not keep a copy

A browser can store a whole file in its own storage, and then Recent would work everywhere with no prompt. That makes a second copy of your data: a 10 MB file grew browser storage by 10.5 MB in our test. For a plate or a slide, that is gigabytes, written somewhere you did not choose. Pointing at the file again is the smaller price.

Image credits ​

The screenshots use CMU-1.svs from the OpenSlide test data, CC0. See Sample Data and Credits.

Privacy ​

Your data stays entirely on your machine. Find Nuclei Viewer processes everything locally in the browser. No files are uploaded to any server.

  • Remote URLs: the third route, and the one to use when the data lives on a server
  • Data Server: serve a folder from your own machine over HTTP, so local data opens anywhere
  • OME-Zarr: a whole dataset in one zipped file
  • Supported Formats: every format, and how it opens

Free. Private. Browser-based.