README.md

ownCloud Web DICOM Viewer

The ownCloud Web DICOM Viewer app is an extension of ownCloud Web to preview DICOM files (medical images and their corresponding metadata) in the browser. The preview of the medical images is based on MIT licensed cornerstone3D.

The current implementation allows to preview .dcm files and display their corresponding metadata in a sidebar on request. It offers image manipulation operations such as zoom, rotate, flip, invert and reset of the image preview. The UI is implemented in responsive manner and adapts the size of the image preview and the way how metadata is displayed to the screen size of the device.

Quick reference

• Where to file issues:
  owncloud/web-app-dicom-viewer

• Supported architectures:
  amd64

Installation

1. Install dependencies

pnpm install

2. Build extension

Build the extension using watch for development.

pnpm build:w

3. Load apps

We can load the app into the oCIS server in two different ways, depending on the version of oCIS:

1. For oCIS 5.0.0 (Seperate extension server)

Configure the extension in web.config.json

{
  …
  "external_apps": [
    {
      "id": "dicom-viewer",
      "path": "https://host.docker.internal:9999/js/web-app-dicom-viewer.js",
      "config": {
        "mimeTypes": [
          "application/dicom",
          "application/octet-stream",
          "application/dicom+xml",
          "application/json"
        ]
      }
    }
  ]
}

2. For oCIS >= 5.1

Copy docker-compose.override.example.yml to docker-compose.override.yml.

4. Run oCIS server

docker compose up

Docker Tags and respective Dockerfile links

• latest available as registry.owncloud.com/internal/web-app-dicom-viewer:latest

Default volumes

None

Exposed ports

• 8080

Environment variables

None

Copyright

Copyright (c) 2023 ownCloud GmbH