Skip to content

Releases

SlideIO Viewer 0.3.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 16:06

Added

  • 3DHISTECH MIRAX (.mrxs) slides. The Open dialog has a filter for them,
    and macOS offers the viewer for .mrxs files in Finder. Open the .mrxs
    entry file; its data directory has to sit beside it.
  • Roche Ventana BIF (.bif), Leica LIF (.lif) and Nikon ND2 (.nd2)
    images.
    Each has its own filter in the Open dialog and joins "All
    Supported Slides" and drag-and-drop, and macOS offers the viewer for these
    files in Finder.

Changed

  • Leica LIF channels whose lookup table is red, green, blue, cyan, magenta or
    yellow open in that colour instead of a default one.

Downloads

Binary distributions of SlideIO Viewer 0.3.0.

Platform File Notes
Windows x86_64 slideio-viewer-0.3.0-windows-x86_64.exe Installer. Unsigned: SmartScreen will warn on first run.
Windows x86_64 slideio-viewer-0.3.0-windows-x86_64.zip The same tree, to unpack anywhere.
macOS arm64 slideio-viewer-0.3.0-macos-arm64.dmg Apple Silicon, macOS 12+. Unsigned — see below.
macOS x86_64 slideio-viewer-0.3.0-macos-x86_64.dmg Intel Mac, macOS 12+. Unsigned — see below.
Debian/Ubuntu x86_64 slideio-viewer_0.3.0_amd64.deb Ubuntu 22.04+ / Debian 12+. Qt is bundled.

The macOS disk images are ad-hoc signed but not notarised, so
Gatekeeper refuses them on first open. Either open one once and then
choose Open Anyway under System Settings → Privacy & Security,
or clear the quarantine flag from the download before mounting it:

xattr -d com.apple.quarantine slideio-viewer-0.3.0-macos-<arch>.dmg

Neither needs admin rights. Without admin, drag the application to
~/Applications rather than /Applications, or run it straight
from the mounted image.

Full Changelog: v0.2.0...v0.3.0

SlideIO Viewer 0.2.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 13:45

Added

  • Annotations. Rectangle, ellipse, polygon, freehand line, point marker,
    arrow, text, ruler and angle tools, with select, move, delete, resize handles
    for boxes and vertex editing for traced shapes (double-click a polygon or
    line).
  • Annotations are saved automatically, one file per slide and scene in a
    workspace folder chosen in Preferences, and come back when the slide is
    reopened. Changing the folder asks whether to copy the annotations on screen
    into it, merge them with what is already there, or switch without them.
  • Undo and redo for annotation edits (Ctrl+Z / Ctrl+Y), 50 steps per slide.
  • Annotation list and properties panels: find, navigate to, rename, classify,
    recolour and annotate any annotation.
  • Measurements in the properties panel: area, perimeter, length and angle, in
    microns when the slide is calibrated.
  • Calibration (View > Calibration...): override a slide's pixel size per
    scene. Every measurement, the scale bar and the exports show whether the
    numbers come from the scanner, a manual calibration, or neither.
  • Categorized counting: a configurable category list, a counting category
    stamped onto new point markers, a live tally per category, and renaming a
    category across a slide.
  • Annotation layers: per-scene layers with visibility, lock, opacity and
    order; move annotations between layers and merge layers. Counts include
    hidden layers.
  • File > Export Counts: the category tally as CSV.
  • File > Export Measurements: every annotation's measurements as CSV, in pixels
    and microns.
  • File > Export Annotations as GeoJSON, readable by QuPath.
  • File > Import Annotations: GeoJSON (including QuPath exports) and ASAP XML.
    Re-importing the same file adds nothing, and an import is one undo step.
  • An annotation file is locked while a slide is open, so a second window
    opens it read-only instead of overwriting its changes.
  • Help > SlideIO Viewer Help opens the online documentation.
  • Help > License shows the licence and the third-party software the viewer
    ships with.
  • Slides sent from macOS Finder open in the running viewer.

Changed

  • RGB brightfield slides open at their native intensity range.
  • Turning on a pane brings it to the front.
  • Channels are numbered from 1 in the Metadata pane, as in the channel mixer.
  • A slide is added to Recent Files only once it has opened, and only once
    however its path is spelled.

Fixed

  • Escape leaves full screen, and the menus stay usable in full screen.
  • Min/Max work on one-channel slides.
  • The Z/T overlay is hidden when a slide closes.
  • The window title no longer names a slide after it is closed.
  • NDPI slides whose levels are stored in strips rather than tiles open faster.

Downloads

Binary distributions of SlideIO Viewer 0.2.0.

Platform File Notes
Windows x86_64 slideio-viewer-0.2.0-windows-x86_64.exe Installer. Unsigned: SmartScreen will warn on first run.
Windows x86_64 slideio-viewer-0.2.0-windows-x86_64.zip The same tree, to unpack anywhere.
macOS arm64 slideio-viewer-0.2.0-macos-arm64.dmg Apple Silicon, macOS 12+. Unsigned — see below.
macOS x86_64 slideio-viewer-0.2.0-macos-x86_64.dmg Intel Mac, macOS 12+. Unsigned — see below.
Debian/Ubuntu x86_64 slideio-viewer_0.2.0_amd64.deb Ubuntu 22.04+ / Debian 12+. Qt is bundled.

The macOS disk images are ad-hoc signed but not notarised, so
Gatekeeper refuses them on first open. Either open one once and then
choose Open Anyway under System Settings → Privacy & Security,
or clear the quarantine flag from the download before mounting it:

xattr -d com.apple.quarantine slideio-viewer-0.2.0-macos-<arch>.dmg

Neither needs admin rights. Without admin, drag the application to
~/Applications rather than /Applications, or run it straight
from the mounted image.

Full Changelog: v0.1.1...v0.2.0

SlideIO Viewer 0.1.2

Choose a tag to compare

@github-actions github-actions released this 11 Oct 15:30

Binary distributions of SlideIO Viewer 0.1.2.

Platform File Notes
Windows x86_64 slideio-viewer-0.1.2-windows-x86_64.exe Installer. Unsigned: SmartScreen will warn on first run.
Windows x86_64 slideio-viewer-0.1.2-windows-x86_64.zip The same tree, to unpack anywhere.
macOS arm64 slideio-viewer-0.1.2-macos-arm64.dmg Apple Silicon, macOS 12+. Unsigned — see below.
macOS x86_64 slideio-viewer-0.1.2-macos-x86_64.dmg Intel Mac, macOS 12+. Unsigned — see below.
Debian/Ubuntu x86_64 slideio-viewer_0.1.2_amd64.deb Ubuntu 22.04+ / Debian 12+. Qt is bundled.

The macOS disk images are ad-hoc signed but not notarised, so
Gatekeeper refuses them on first open. Either open one once and then
choose Open Anyway under System Settings → Privacy & Security,
or clear the quarantine flag from the download before mounting it:

xattr -d com.apple.quarantine slideio-viewer-0.1.2-macos-<arch>.dmg

Neither needs admin rights. Without admin, drag the application to
~/Applications rather than /Applications, or run it straight
from the mounted image.

Full Changelog: v0.1.1...v0.1.2

SlideIO Viewer 0.1.1

Choose a tag to compare

@github-actions github-actions released this 09 Oct 22:53

SlideIO Viewer 0.1.1 adds color management: slides with an embedded ICC profile can be shown in colorimetrically correct color instead of raw scanner RGB, and profiles can be supplied for slides that lack one. It is also the first release with a native build for Intel Macs.

Highlights

Color management

  • View → Color Management (Ctrl+Shift+I) switches the open slide between color-managed and raw display. The setting is remembered between sessions, and the action is available whenever a slide is open.
  • The Properties panel reports the slide's embedded ICC profile, so you can see whether the colors on screen are colorimetrically defined.
  • Set Default ICC Profile… chooses a profile to assume for slides that embed none. A new default applies to slides opened after the change. If the profile file later goes missing or becomes unreadable, the viewer says the setting is at fault rather than the slide.

Per-slide ICC profiles

  • Set ICC Profile for This Slide… assigns a profile to the slide on screen, overriding any profile it embeds (the viewer warns before replacing an embedded one). Clear ICC Profile for This Slide removes it.
  • Overrides are remembered and re-applied whenever the same slide is opened again. Slides are recognised by their content, not their path, so a moved or renamed file keeps its profile.
  • Manage Slide ICC Profiles… lists every stored override and lets you remove them.
  • The status bar names the profile the slide is being shown through, and confirms when a profile is cleared.

Intel Mac build

  • A native macOS x86_64 disk image ships alongside the Apple Silicon one.

Fixes

  • Setting a per-slide profile on a freshly opened slide silently did nothing; it now works from File → Open, drag-and-drop and Recent Files.
  • Setting or clearing a slide profile after switching scenes reopened the slide with automatic format detection rather than the driver it was opened with, which could misread DICOM directory studies.
  • A per-slide override no longer changes the global color-management setting.
  • Color-profile work no longer runs on the UI thread when a slide opens.
  • The Color Management shortcut no longer collides with the Channels panel toggle.
  • The README and specifications no longer list formats SlideIO cannot read (MRXS, BIF). Supported formats: SVS, AFI, SCN, CZI, ZVI, NDPI, VSI, DCM, QPTIFF, OME-TIFF, PHTIFF and GDAL-readable images.

Downloads

Platform File Notes
Windows x86_64 slideio-viewer-0.1.1-windows-x86_64.exe Installer. Unsigned: SmartScreen will warn on first run.
Windows x86_64 slideio-viewer-0.1.1-windows-x86_64.zip The same tree, to unpack anywhere.
macOS arm64 slideio-viewer-0.1.1-macos-arm64.dmg Apple Silicon. Unsigned — see below.
macOS x86_64 slideio-viewer-0.1.1-macos-x86_64.dmg Intel Mac. Unsigned — see below.
Debian/Ubuntu x86_64 slideio-viewer_0.1.1_amd64.deb Ubuntu 22.04+ / Debian 12+. Qt is bundled.
Linux x86_64 slideio-viewer-0.1.1-linux-x86_64.tar.gz The same tree as the .deb, to unpack anywhere.

The macOS disk images are ad-hoc signed but not notarised, so
Gatekeeper refuses them on first open. Either open one once and then
choose Open Anyway under System Settings → Privacy & Security,
or clear the quarantine flag from the download before mounting it:

xattr -d com.apple.quarantine slideio-viewer-0.1.1-macos-<arch>.dmg

Neither needs admin rights. Without admin, drag the application to
~/Applications rather than /Applications, or run it straight
from the mounted image.

Pull requests

  • Per-slide ICC colour profile override by @Booritas in #2
  • Enable colour management only once an override's profile binds by @Booritas in #3
  • Acknowledge cleared color profiles in the status bar by @Booritas in #4

Full Changelog: v0.1.0...v0.1.1

SlideIO Viewer 0.1.0

Choose a tag to compare

@github-actions github-actions released this 03 Oct 20:32

First release of SlideIO Viewer — a cross-platform desktop viewer for digital pathology whole-slide images, built on the SlideIO library and Qt 6.

What it does

Opens gigapixel whole-slide images and lets you move around them: GPU-accelerated tile rendering over the image's own resolution pyramid, with tiles loaded in the background so panning and zooming stay responsive on slides far larger than memory.

  • Navigation — pan and zoom, fit to window, actual pixels, full screen, minimap overview, zoom indicator with a physical scale bar
  • Multi-scene and multi-channel slides — scene thumbnails, associated images (label, macro, overview), a channel mixer with per-channel intensity and range controls, and Z-stack / time-series navigation
  • Slide information — properties and metadata panels, read from the file rather than guessed
  • Opening files — drag and drop, a recent files list, and a folder picker for DICOM studies, which are directories rather than single files

Supported formats

Aperio SVS and AFI, Hamamatsu NDPI, Leica SCN, Carl Zeiss CZI and ZVI, Olympus VSI, PerkinElmer QPTIFF, OME-TIFF, DICOM whole-slide studies, and TIFF/BigTIFF and other raster formats through GDAL.

Downloads

Platform File Notes
Windows x86_64 slideio-viewer-0.1.0-windows-x86_64.exe Installer. Unsigned, so SmartScreen warns on first run.
Windows x86_64 slideio-viewer-0.1.0-windows-x86_64.zip The same tree, to unpack anywhere.
macOS arm64 slideio-viewer-0.1.0-macos-arm64.dmg Apple Silicon. Ad-hoc signed, not notarised — see below.
Debian/Ubuntu x86_64 slideio-viewer_0.1.0_amd64.deb Ubuntu 22.04+ / Debian 12+.
Linux x86_64 slideio-viewer-0.1.0-linux-x86_64.tar.gz Relocatable tree, for distributions the .deb does not fit.

Every package carries its own Qt 6.7.3 and SlideIO 2.10.0, so nothing needs to be installed alongside it. The Windows packages include the MSVC runtime; the Linux packages install under /opt/slideio-viewer and depend only on the X11 and OpenGL libraries a desktop already has.

Requires a GPU and driver supporting OpenGL 3.3.

macOS: getting past Gatekeeper

The disk image is ad-hoc signed but not notarised, so Gatekeeper refuses it on first open. Either open it once and then choose Open Anyway under System Settings → Privacy & Security, or clear the quarantine flag on the download before mounting it:

xattr -d com.apple.quarantine slideio-viewer-0.1.0-macos-arm64.dmg

Neither needs admin rights. Without admin, drag the application to ~/Applications rather than /Applications, or run it straight from the mounted image.

Known limitations

  • No annotation tools yet — this release is a viewer only.
  • Windows and macOS packages are unsigned, as above.
  • macOS is Apple Silicon only; there is no Intel build.

Reporting a problem

Help → About SlideIO Viewer has a Copy to Clipboard button that collects the version, build revision, operating system, GPU and OpenGL renderer, and the log file path. Pasting that into an issue saves a round trip.