Osimis Web Viewer plugin

This plugin by Osimis extends Orthanc with a Web viewer of medical images, with more advanced features than the basic Orthanc Web viewer plugin. The Osimis plugin adds tools for measuring, for viewing multiple series, and for split-pane.

For general information and a demonstration, check out the official homepage of the plugin. Also check out the source code.

How to get it

The Osimis Web viewer is part of the Windows installers.

For Linux users, you’ll find it in the osimis/orthanc Docker images or you can download the LSB (Linux Standard Base) binaries here.

The compilation process is quite complex since it requires to build first the frontend and then the backend. All information can be found in the source code.

Usage

On Windows, the plugin is enabled by default and will work out-of-the-box.

If you’re using the osimis/orthanc Docker image, you’ll have to define the WVB_ENABLED environment variable to true.

On plain GNU/Linux distributions (i.e. if not using Docker), the Osimis Web viewer will only work with LSB (Linux Standard Base) Orthanc binaries that can be downloaded from here (that will work with most recent GNU/Linux distributions). Once Orthanc is installed, you must change the configuration file to tell Orthanc where it can find the plugin: This is done by properly modifying the Plugins option. You could for instance use the following configuration file:

{
  "Name" : "MyOrthanc",
  [...]
  "Plugins" : [
    "/home/user/xxx/Downloads/libOsimisWebViewer.so"
  ]
}

Orthanc must of course be restarted after the modification of its configuration file.

Once a DICOM study is opened using Orthanc Explorer, a yellow button entitled Osimis Web Viewer will show up. It will open the Web viewer for that particular study. See also the interactive demonstration on the official homepage of the plugin.

Advanced options

The configuration of the Web viewer can be fine-tuned by adapting some options in the configuration file.

FAQ

  • Can I use the Osimis Viewer in a medical environment ?

    The Osimis Viewer is not a Medical Device; it is not CE marked or FDA approved.

    The Osimis Viewer is an open source Viewer that cannot be used for diagnostic or therapeutic purposes.

    However, the viewer can be used as a communication tool that allows Researchers, Teachers, Technicians, General Practitioner or Patients to visualize medical images for information only.

    Check your local regulations to ensure you’re using it in a legal manner.

  • What video formats are supported by the Osimis Web Viewer ?

    The set of codecs supported by the Osimis Viewer is an intersection of the sets of codecs supported by the DICOM standard and those supported by the web browsers. In short, this mostly comes down to just MPEG-4.

  • Where are the annotations stored ?

    Annotations are stored in metadata (id 9999) in a custom format. Note that annotation storage is disabled by default and can be enabled by setting "AnnotationStorageEnabled": true in the configuration file.