GUI Overview

Essential aspects of the interface

The image below shows the main elements of the Weasis graphical user interface. Click any of the green or blue areas to jump to the dedicated documentation for that element.

1 2

The default DICOM workspace has two main areas:

  1. The DICOM Explorer on the left (blue) — used to import and export data and to pick the series to display.
  2. The main area on the right (green) — hosts the open viewers and players as tabs. The available menus, toolbars, and tools change depending on the viewer currently in focus.
    • In the screenshot above, the active viewer is the DICOM 2D Viewer , which is the default for image series.
    • A tab with a multi-view layout can only display images from a single patient, but the same patient can appear in several tabs.
    • Each tab is a docked panel that can be moved by drag-and-drop, including side-by-side splits — see Docking for the full layout options.
    • For navigating through the Patient / Study / Series / Image hierarchy, see the DICOM Explorer page.

Minimal configuration before starting

A few settings make Weasis noticeably more comfortable the first time you launch it. Open the preferences dialog from the main menu: File > Preferences (Alt + P).

Language and regional settings

In the General tab, pick your preferred language and regional format (dates, numbers). Only languages with at least 30 % translation coverage appear in the list. Dates, numbers, and other locale-sensitive values follow the selected regional format throughout the interface.

➜ See Language and regional settings for the detailed instructions.

Theme and scaling factor

In the Appearance tab:

  • Choose a theme that suits your environment and reduces eye strain. The recommended theme is Core Dark — Flat Weasis.
  • Set a scaling factor that matches your system display scaling. This is especially recommended for HiDPI screens — Weasis will scale fonts, icons, and every UI component consistently.

➜ See Styles and themes for the detailed instructions.

Tip

Wherever you need more complete instructions, click the button in the preferences dialog or in any contextual pop-up — it opens the matching page of this documentation in your browser.

Tip

In the View menu at the top, the toolbars and tools attached to the active viewer can be shown or hidden. These preferences are remembered across restarts. Show / hide preferences specific to the DICOM Explorer are only kept for the current session.

Other viewers and players in the DICOM workspace

Depending on the SOP Class of the loaded series, Weasis opens one of the following:

Overlay viewers — applied on top of an image series rather than opened on their own — include DICOM Segmentation (SEG), DICOM RT, and Presentation State (PR / GSPS).

Other workspaces

  • Dicomizer — the workspace for converting standard images into DICOM objects.
  • Standard image explorer — workspace for non-DICOM images (configured through the non-dicom-explorer.json profile).