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.
The default DICOM workspace has two main areas:
- The DICOM Explorer on the left (blue) — used to import and export data and to pick the series to display.
- 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:
- Multi-Planar Reconstruction (MPR) viewer
- Maximum Intensity Projection (MIP) viewer
- DICOM 3D Volume Renderer
- DICOM ECG viewer
- DICOM Structured Report (SR) viewer
- DICOM Audio player
- DICOM PDF viewer — opened with the default system application registered for PDF files.
- DICOM Video player — opened with the default system player registered for MPEG files.
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.jsonprofile).