Repository navigation
Releases
SlideIO Viewer 0.3.0
Added
- 3DHISTECH MIRAX (
.mrxs) slides. The Open dialog has a filter for them,
and macOS offers the viewer for.mrxsfiles 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
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
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
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
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.