Download Weasis DICOM Viewer

Package management systems

If you want to get automatic updates of the Weasis DICOM viewer then check these package management systems:

Windows

• Microsoft Windows store
• Windows Package Manager (winget)
• Chocolatey Community Repository (Windows deployment with PowerShell, CHEF, Puppet…)

macOS

• Homebrew Formulae (Homebrew Cask for Intel and Apple Silicon architectures)

Linux

• Flathub repository (Flatpak package management for x86_64 and arm64 architectures)
• Snapcraft: The app store for Linux (Snap package management for x86_64 and arm64 architectures)
• Arch Linux repository
• Gentoo repository

Number of downloads

• Github
• Sourceforge

List of all the installers

For more information on GLIBC versions regarding the life cycle of the different Linux distributions, see this page.

Download Weasis DICOM Viewer binaries

Pack.	System	Arch.	Size	Weasis installer	Comments
v4.5.1 publised on Sep 18, 2024
DEB	Linux	x86-64	49.9 MB	weasis_4.5.1-1_amd64.deb	Requires GLIBC_2.17
DEB	Linux	arm-64	47.2 MB	weasis_4.5.1-1_arm64.deb	Requires GLIBC_2.27
DEB	Linux	arm-32	50.5 MB	weasis_4.5.1-1_armhf.deb	Requires GLIBC_2.17. Only tested with Raspberry Pi 4
MSI	Windows	x86-64	47.7 MB	Weasis-4.5.1-x86-64.msi	Requires Windows 10 or higher
PKG	macOS	arm-64	57.7 MB	Weasis-4.5.1-aarch64.pkg	Requires macOS 12 or higher (Apple Silicon)
PKG	macOS	x86-64	60.1 MB	Weasis-4.5.1-x86-64.pkg	Requires macOS 11 or higher
RPM	Linux	x86-64	63.3 MB	weasis-4.5.1-1.x86_64.rpm	Requires GLIBC_2.17, libstdc++.so.6 and libgcc
v4.5.0 publised on Aug 15, 2024
DEB	Linux	x86-64	49.9 MB	weasis_4.5.0-1_amd64.deb
DEB	Linux	arm-64	47.2 MB	weasis_4.5.0-1_arm64.deb
DEB	Linux	arm-32	50.5 MB	weasis_4.5.0-1_armhf.deb
MSI	Windows	x86-64	47.7 MB	Weasis-4.5.0-x86-64.msi
PKG	macOS	arm-64	57.8 MB	Weasis-4.5.0-aarch64.pkg
PKG	macOS	x86-64	60.2 MB	Weasis-4.5.0-x86-64.pkg
RPM	Linux	x86-64	63.3 MB	weasis-4.5.0-1.x86_64.rpm
v4.4.0 publised on May 6, 2024
DEB	Linux	x86-64	50.4 MB	weasis_4.4.0-1_amd64.deb
DEB	Linux	arm-64	47.4 MB	weasis_4.4.0-1_arm64.deb
DEB	Linux	arm-32	50.7 MB	weasis_4.4.0-1_armhf.deb
MSI	Windows	x86-64	47.8 MB	Weasis-4.4.0-x86-64.msi
PKG	macOS	arm-64	58.4 MB	Weasis-4.4.0-aarch64.pkg
PKG	macOS	x86-64	60.8 MB	Weasis-4.4.0-x86-64.pkg
RPM	Linux	x86-64	64.3 MB	weasis-4.4.0-1.x86_64.rpm
v4.3.0 publised on Feb 17, 2024
DEB	Linux	x86-64	49.5 MB	weasis_4.3.0-1_amd64.deb
DEB	Linux	arm-64	46.5 MB	weasis_4.3.0-1_arm64.deb
DEB	Linux	arm-32	47.6 MB	weasis_4.3.0-1_armhf.deb
MSI	Windows	x86-64	46.8 MB	Weasis-4.3.0-x86-64.msi
PKG	macOS	arm-64	57.4 MB	Weasis-4.3.0-aarch64.pkg
PKG	macOS	x86-64	59.9 MB	Weasis-4.3.0-x86-64.pkg
RPM	Linux	x86-64	63.5 MB	weasis-4.3.0-1.x86_64.rpm
v4.2.1 publised on Nov 11, 2023
DEB	Linux	x86-64	49.0 MB	weasis_4.2.1-1_amd64.deb
DEB	Linux	arm-64	46.4 MB	weasis_4.2.1-1_arm64.deb
DEB	Linux	arm-32	47.5 MB	weasis_4.2.1-1_armhf.deb
MSI	Windows	x86-64	46.7 MB	Weasis-4.2.1-x86-64.msi
PKG	macOS	arm-64	57.2 MB	Weasis-4.2.1-aarch64.pkg
PKG	macOS	x86-64	59.7 MB	Weasis-4.2.1-x86-64.pkg
RPM	Linux	x86-64	62.9 MB	weasis-4.2.1-1.x86_64.rpm
v4.2.0 publised on Aug 18, 2023
DEB	Linux	x86-64	50.5 MB	weasis_4.2.0-1_amd64.deb
DEB	Linux	arm-64	48.8 MB	weasis_4.2.0-1_arm64.deb
DEB	Linux	arm-32	50.0 MB	weasis_4.2.0-1_armhf.deb
MSI	Windows	x86-64	48.1 MB	Weasis-4.2.0-x86-64.msi
PKG	macOS	x86-64	61.2 MB	Weasis-4.2.0-x86-64.pkg
RPM	Linux	x86-64	62.7 MB	weasis-4.2.0-1.x86_64.rpm
v4.1.2 publised on Jun 16, 2023
DEB	Linux	x86-64	48.7 MB	weasis_4.1.2-1_amd64.deb
DEB	Linux	arm-64	47.1 MB	weasis_4.1.2-1_arm64.deb
DEB	Linux	arm-32	48.6 MB	weasis_4.1.2-1_armhf.deb
MSI	Windows	x86-64	46.4 MB	Weasis-4.1.2-x86-64.msi
PKG	macOS	x86-64	58.8 MB	Weasis-4.1.2-x86-64.pkg
RPM	Linux	x86-64	61.6 MB	weasis-4.1.2-1.x86_64.rpm
v4.1.1 publised on May 22, 2023
DEB	Linux	x86-64	48.7 MB	weasis_4.1.1-1_amd64.deb
MSI	Windows	x86-64	46.4 MB	Weasis-4.1.1-x86-64.msi
PKG	macOS	x86-64	58.8 MB	Weasis-4.1.1-x86-64.pkg
RPM	Linux	x86-64	61.6 MB	weasis-4.1.1-1.x86_64.rpm
v4.1.0 publised on May 8, 2023
DEB	Linux	x86-64	48.7 MB	weasis_4.1.0-1_amd64.deb
DEB	Linux	arm-64	48.3 MB	weasis_4.1.0-1_arm64.deb
DEB	Linux	arm-32	48.6 MB	weasis_4.1.0-1_armhf.deb
MSI	Windows	x86-64	46.1 MB	Weasis-4.1.0-x86-64.msi
PKG	macOS	x86-64	58.8 MB	Weasis-4.1.0-x86-64.pkg
RPM	Linux	x86-64	61.7 MB	weasis-4.1.0-1.x86_64.rpm
v4.0.3 publised on Nov 13, 2022
DEB	Linux	x86-64	41.0 MB	weasis_4.0.3-1_amd64.deb
DEB	Linux	arm-64	39.1 MB	weasis_4.0.3-1_arm64.deb
DEB	Linux	arm-32	38.9 MB	weasis_4.0.3-1_armhf.deb
MSI	Windows	x86-64	41.0 MB	Weasis-4.0.3-x86-64.msi
PKG	macOS	x86-64	53.4 MB	Weasis-4.0.3-x86-64.pkg
RPM	Linux	x86-64	56.4 MB	weasis-4.0.3-1.x86_64.rpm
v4.0.2 publised on Aug 1, 2022
DEB	Linux	x86-64	39.4 MB	weasis_4.0.2-1_amd64.deb
DEB	Linux	arm-64	38.7 MB	weasis_4.0.2-1_arm64.deb
DEB	Linux	arm-32	38.4 MB	weasis_4.0.2-1_armhf.deb
MSI	Windows	x86-64	39.4 MB	Weasis-4.0.2-x86-64.msi
PKG	macOS	x86-64	51.0 MB	Weasis-4.0.2-x86-64.pkg
RPM	Linux	x86-64	53.9 MB	weasis-4.0.2-1.x86_64.rpm
v4.0.1 publised on Jun 17, 2022
DEB	Linux	x86-64	39.3 MB	weasis_4.0.1-1_amd64.deb
DEB	Linux	arm-64	38.7 MB	weasis_4.0.1-1_arm64.deb
DEB	Linux	arm-32	38.4 MB	weasis_4.0.1-1_armhf.deb
MSI	Windows	x86-64	39.4 MB	Weasis-4.0.1-x86-64.msi
PKG	macOS	x86-64	51.0 MB	Weasis-4.0.1-x86-64.pkg
RPM	Linux	x86-64	53.8 MB	weasis-4.0.1-1.x86_64.rpm
v4.0.0-rc publised on Apr 30, 2022
DEB	Linux	x86-64	38.9 MB	weasis_4.0.0-1_amd64.deb
DEB	Linux	arm-64	38.1 MB	weasis_4.0.0-1_arm64.deb
DEB	Linux	arm-32	37.9 MB	weasis_4.0.0-1_armhf.deb
MSI	Windows	x86-64	38.9 MB	Weasis-4.0.0-x86-64.msi
PKG	macOS	x86-64	50.5 MB	Weasis-4.0.0-x86-64.pkg
RPM	Linux	x86-64	53.4 MB	weasis-4.0.0-1.x86_64.rpm
v3.8.1 publised on Feb 4, 2022
DEB	Linux	x86-64	39.3 MB	weasis_3.8.1-1_amd64.deb
DEB	Linux	arm-64	38.2 MB	weasis_3.8.1-1_arm64.deb
DEB	Linux	arm-32	38.7 MB	weasis_3.8.1-1_armhf.deb
MSI	Windows	x86-64	39.0 MB	Weasis-3.8.1-x86-64.msi
PKG	macOS	x86-64	51.4 MB	Weasis-3.8.1-x86-64.pkg
RPM	Linux	x86-64	55.1 MB	weasis-3.8.1-1.x86_64.rpm
v3.8.0 publised on Dec 11, 2021
DEB	Linux	x86-64	39.3 MB	weasis_3.8.0-1_amd64.deb
DEB	Linux	arm-64	38.2 MB	weasis_3.8.0-1_arm64.deb
DEB	Linux	arm-32	38.7 MB	weasis_3.8.0-1_armhf.deb
MSI	Windows	x86-64	39.0 MB	Weasis-3.8.0-x86-64.msi
PKG	macOS	x86-64	51.4 MB	Weasis-3.8.0-x86-64.pkg
RPM	Linux	x86-64	55.1 MB	weasis-3.8.0-1.x86_64.rpm
v3.7.1 publised on Jun 6, 2021
DEB	Linux	x86-64	38.0 MB	weasis_3.7.1-1_amd64.deb
DEB	Linux	arm-32	44.5 MB	weasis_3.7.1-1_armhf.deb
MSI	Windows	x86-64	38.4 MB	Weasis-3.7.1-x86-64.msi
PKG	macOS	x86-64	50.3 MB	Weasis-3.7.1-x86-64.pkg
RPM	Linux	x86-64	52.1 MB	weasis-3.7.1-1.x86_64.rpm
v3.7.0 publised on Feb 6, 2021
DEB	Linux	x86-64	36.9 MB	weasis_3.7.0-1_amd64.deb
MSI	Windows	x86-64	37.3 MB	Weasis-3.7.0-x86-64.msi
PKG	macOS	x86-64	49.5 MB	Weasis-3.7.0.pkg
RPM	Linux	x86-64	51.1 MB	weasis-3.7.0-1.x86_64.rpm
v3.6.2 publised on Aug 27, 2020
DEB	Linux	x86-64	34.9 MB	weasis_3.6.2-1_amd64.deb
MSI	Windows	x86-64	35.2 MB	Weasis-3.6.2-x86-64.msi
MSI	Windows	x86-32	43.4 MB	Weasis-3.6.2-x86.msi
PKG	macOS	x86-64	47.4 MB	Weasis-3.6.2.pkg
RPM	Linux	x86-64	48.6 MB	weasis-3.6.2-1.x86_64.rpm
v3.6.1 publised on Jul 5, 2020
DEB	Linux	x86-64	39.0 MB	weasis_3.6.1-1_amd64.deb
MSI	Windows	x86-64	35.1 MB	Weasis-3.6.1-x86-64.msi
MSI	Windows	x86-32	36.7 MB	Weasis-3.6.1-x86.msi
PKG	macOS	x86-64	47.9 MB	Weasis-3.6.1.pkg
RPM	Linux	x86-64	55.2 MB	weasis-3.6.1-1.x86_64.rpm
v3.6.0 publised on Mar 6, 2020
DEB	Linux	x86-64	40.3 MB	weasis_3.6.0-1_amd64.deb
MSI	Windows	x86-64	40.1 MB	Weasis-3.6.0-x86-64.msi
MSI	Windows	x86-32	41.2 MB	Weasis-3.6.0-x86.msi
PKG	macOS	x86-64	51.5 MB	Weasis-3.6.0.pkg
RPM	Linux	x86-64	57.3 MB	weasis-3.6.0-1.x86_64.rpm
v3.5.4 publised on Nov 1, 2019
DEB	Linux	x86-64	38.7 MB	weasis_3.5.4-1_amd64.deb
MSI	Windows	x86-64	37.8 MB	Weasis-3.5.4-x86-64.msi
MSI	Windows	x86-32	39.7 MB	Weasis-3.5.4-x86.msi
PKG	macOS	x86-64	49.4 MB	Weasis-3.5.4.pkg
RPM	Linux	x86-64	55.8 MB	weasis-3.5.4-1.x86_64.rpm
v3.5.3 publised on Aug 10, 2019
DEB	Linux	x86-64	38.3 MB	weasis_3.5.3_amd64.deb
MSI	Windows	x86-64	37.2 MB	Weasis-3.5.3-x86-64.msi
MSI	Windows	x86-32	39.0 MB	Weasis-3.5.3-x86.msi
PKG	macOS	x86-64	47.5 MB	Weasis-3.5.3.pkg
RPM	Linux	x86-64	55.3 MB	weasis-3.5.3-1.x86_64.rpm

Embedding in dcm4chee

This page describes how installing Weasis to be the default web viewer of dcm4chee-arc-light web interface. See How to launch Weasis from any environments to integrate Weasis into your own user interface.

Weasis is launched from the dcm4chee administrative web interface with the weasis protocol, as shown in the pictures below.

For a simpler and faster installation without server components, please follow these instructions; no need to consider the following points on this page. Otherwise if you need more advanced configurations then follow these steps:

1. Install dcm4chee, if not already done (Installation with Docker is straightforward).

2. Go here and download these following files:

   Warning

   Download issue: Some browsers (like Internet Explorer) may rename war files to zip. If so, use the Save As option when downloading and change the name back to war.

   • From weasis-pacs-connector folder:
     • [weasis-pacs-connector.war] Requires at least the version 7.1.2
   • From the folder with the latest version number (Optional if you want to run only the native version installed on the client system):
     • [weasis.war] requires at least Weasis 3.5.3
     • InfoOptional [weasis-i18n.war] for internationalization
     • InfoOptional [weasis-ext.war] for additional plug-ins
   • From the folder with the latest version number:

3. Open the wildfly management console (at http://<your-host>:9990).

   • Select the “Deployments” tab
   • Add the .war files using the “Add” button (Choose Upload a new deployment or select Replace when the file already exists)
     Note

     Alternatively one may deploy .war files using JBoss Command Line Interface Console.

4. Configure weasis-pacs-connector (This step is optional if you just want to keep the default configuration).
   The default configuration is stored in two files inside weasis-pacs-connector.war. To override the default configuration:

   • Download the current download>weasis-pacs-connector.properties and download>dicom-dcm4chee-arc.properties (configuration of the dcm4chee archive)
   • Edit the configuration as needed. For example, dcm4chee may be running on a different computer than Weasis, or the AE Title of dcm4chee may have been changed. If so, edit weasis-pacs-connector.properties or dicom-dcm4chee-arc.properties (Change pacs.host, pacs.port, and pacs.aet).
   • Copy weasis-pacs-connector.properties and dicom-dcm4chee-arc.properties into $WILDFLY_HOME/standalone/configuration (where $WILDFLY_HOME is the path of the running Wildfly).
     With the docker installation use the docker copy command ($ docker cp …)
     Tip

     Instead of copying the files into $WILDFLY_HOME/standalone/configuration, JBoss Command Line Interface Console can be used to override files in the war. Add the two configuration files with the deployment-overlay command:
     

     deployment-overlay add --name=dcm4chee-arc --deployments=weasis-pacs-connector.war --content=WEB-INF/classes/weasis-pacs-connector.properties=/tmp/weasis-pacs-connector.properties,WEB-INF/classes/dicom-dcm4chee-arc.properties=/tmp/dicom-dcm4chee-arc.properties --redeploy-affected

   • For applying the new configuration, from the management console “Disable” weasis-pacs-connector.war and then “Enable”

5. To activate Weasis in the dcm4chee-arc-light user interface (see the matrix of the required versions in the table below): you need to add attributes by either editing docker-compose.env (from 5.22.0) or from the left menu Configuration > Devices > dcm4chee-arc > Extensions > Edit extension > Child Objects > Web Applications > DCM4CHEE (add &cdb to the URL if weasis.war has not been deployed on the server-side):

   • Configure the URL for having a view button for the patient or study level.
     • From dcm4chee-arc-light 5.10.2 to 5.19.0 the left menu Configuration > Devices > dcm4chee-arc > Extensions > Archive Device
     • From dcm4chee-arc-light 5.19.1 the left menu Configuration > Devices > dcm4chee-arc > Extensions > Edit extension > Child Objects > Web Applications > DCM4CHEE
     • From dcm4chee-arc-light 5.22.0 by editing docker-compose.env (It allows you to directly apply the properties when deploying, then the can be edited in the web portal). Note: the character ‘&’ must be escaped (e.g. IID_STUDY_URL=../../weasis-pacs-connector/weasis?studyUID={{studyUID}}\&access_token={{access_token}})
       Note

       URL parameters

       • access_token is necessary in secure mode (secured RESTful services) from dcm4chee-arc-light 5.15.1
       • _self avoids to open a new empty window in the web browser
         
       • cdb cdb parameter to override the URL of the Weasis web context to null (when you want only the native local version or when weasis.war has not be deployed with weasis-pacs-connector)
         
       • See also Invoke Image Display in dcm4chee
       Tip

       Absolute path: The values above starting by “../” are the default relative path when weasis-pacs-connector is installed in the same JBoss as dcm4chee. Otherwise replace the relative URL by an absolute value, ex: http://<your-host>:<port>/weasis-pacs-connector/...

   • InfoOptional Add other properties in the URL.
   • Refresh the web page and the view button should appear as in the screenshot above
   • To launch the viewer from the web portal, the client computer must have installed the Weasis package.

* Running only the local native version of Weasis (when not connected to a remote version - weasis.war -)

Weasis Web Protocol

The web protocol allows launching Weasis in a web context from a specific URI scheme: weasis://parameters

How to use the weasis protocol

• From a web page, just make a link starting with weasis:// (see below How to build an URI)
  Note

  Some web frameworks such as the wiki or the URL field of some browsers only support the standard protocols (http, ftp…). To solve this problem, it is necessary to use a URL redirection starting with http like the one proposed in weasis-pacs-connector: http://<your-host>:8080/weasis-pacs-connector/weasis?patientID=TESTS

• From the command line:
  ​

  Windows Linux macOS

  start weasis://%24dicom%3Aget+-w+%22https%3A%2F%2Fnroduit.github.io%2Fdemo-archive%2FLumbar%2Fmf.xml%22

  xdg-open weasis://%24dicom%3Aget+-w+%22https%3A%2F%2Fnroduit.github.io%2Fdemo-archive%2FLumbar%2Fmf.xml%22

  open weasis://%24dicom%3Aget+-w+%22https%3A%2F%2Fnroduit.github.io%2Fdemo-archive%2FLumbar%2Fmf.xml%22

How to build an URI

The URI scheme “weasis://” allows you to launch Weasis from the system’s URI handler while the URI path allows you to build Weasis commands.

weasis-pacs-connector will help to build dynamically the manifest (the references of the images to be loaded) and the launch parameters (user, profile, plugins…). It will also manage user preferences.

To build an URI (weasis://path) without weasis-pacs-connector, you must choose one or more commands, encode the commands, and add the scheme weasis:// as prefix. Here is an example of loading an image:

1. Use $dicom:get to load an image from URL

   $dicom:get -r "https://nroduit.github.io/demo-archive/us-palette.dcm"

2. Format the URI path with a URL encoder

   %24dicom%3Aget+-r+%22https%3A%2F%2Fnroduit.github.io%2Fdemo-archive%2Fus-palette.dcm%22

3. Make a link by adding “weasis://” at the beginning Open the remote image

Examples to load images

If you use weasis-pacs-connector, please refer to Launch Weasis.

• Use $dicom:get to load a static XML manifest containing direct links (without WADO server) Launch

  $dicom:get -w "https://nroduit.github.io/demo-archive/Lumbar/mf.xml"

• Use $dicom:rs to load DICOM files with DICOMWeb RESTful services (see other examples) Launch

  $dicom:rs --url "https://demo.orthanc-server.com/dicom-web" -r "patientID=5Yp0E"

• Use $dicom:get to load an image from URL and remove all the previous images if Weasis is already open Launch

  $dicom:close --all $dicom:get -r "https://nroduit.github.io/demo-archive/us-palette.dcm"

• Use $dicom:get to load multiple local folders and a remote image Launch

  $dicom:get -l "D:/DICOM/Overlay" -l "D:/DICOM/Shutter" -r "https://nroduit.github.io/demo-archive/us-palette.dcm"

• Use $image:get to load a non DICOM image Launch

  $image:get -u "https://user-images.githubusercontent.com/993975/59107662-6c9ed300-8939-11e9-83ee-28f2725f4ae1.jpg"

Modify the launch parameters

The command for modifying the configuration at launch is $weasis:config which can have different arguments:

• cdb is the Weasis web context (The URL of weasis.war). If the value is null, the weasis version installed from the native installer is used. In the weasis-pacs-connector configuration, the default value is defined by weasis.base.url.
• cdb-ext is the extension web context of Weasis (The URL of weasis-ext.war containing additionnal plugins). In the weasis-pacs-connector configuration, the default value is defined by weasis.ext.url.
• arg is an argument for the launcher. The value must start by $, like arg="$dicom:close –all" (Note: the value can also be directly in the base URI, outside $weasis:config). Single-valued argument but can be specified multiple times.
• pro is a property for the launcher containing a key and a value separate by a space. Single-valued property but can be specified multiple times.
• auth is the web authorization parameter
• wcfg is the URL the remote Weasis configuration service.

Here are some examples that modify the launcher properties without using weasis-pacs-connector:

• Configuration for launching Weasis Dicomizer Launch

  $weasis:config pro="felix.extended.config.properties file:conf/dicomizer.json" pro="gosh.port 17181"

• Change the user, by default is the one of the current system session. The local preferences are associated to a user. Launch

  $weasis:config pro="weasis.user user2"

Building Weasis

These instructions describe how to build Weasis directly from the Git repository on any platform. For building Weasis from an IDE, see Weasis plug-in development guidelines.

Prerequisites

1. JDK 23 or higher
2. Maven 3.6.3 or higher
   If your computer is behind a proxy server, configure maven.
3. Git

Getting the Source

In order to clone the repository, first install GIT and either clone using a graphical GIT client or directly from the command line using the command:

git clone https://github.com/nroduit/Weasis.git

Building all Plug-ins

• Go in the Weasis directory, compile and install all the plug-ins in the local Maven repository:

  mvn clean install

• Package weasis-native.zip (located in target/native-dist/), since Version4.0.0 :

  mvn -P compressXZ -f weasis-distributions clean package

  Tip

  -P compressXZ: Option for compressing the packages in xz, only from Weasis 3.6.0. The compression pack200 is not supported anymore (removed from Java 14), before 3.6.0 the profile was -P pack200.
  

  Tip

  -P purgeI18nPackage: Option to delete the translation package in the local maven repository (active by default). To disable this option, add - before the profile:

  mvn -P compressXZ,-purgeI18nPackage -f weasis-distributions clean package

  Warning

  For production, version must not be SNAPSHOT (otherwise packages will not be kept in cache). So to remove SNAPASHOT or to make your own release (for avoiding package mix-up in cache), modify the changelist property. From the Weasis root folder, execute:

  mvn -Dchangelist=-mybuild-beta clean install
  mvn -Dchangelist=-mybuild-beta -P compressXZ -f weasis-distributions clean package

Building native binaries and installers

Since Version4.0.0 the native installer has completely replaced the portable and the Java Webstart distributions.

The official build is done by Github actions with GitHub-hosted runners (Linux, macOS and Windows).

However, it is possible to run a local script package-weasis.sh on most systems but without guarantee because the system must have a correct configuration of several tools (see jpackage prerequisites).

• Get weasis-native.zip, unzip the archive and then go to the root folder with a bash prompt.
• Build the native binaries and the installer:
  ​

  Bash

  ./build/script/package-weasis.sh --jdk "/home/.jdks/openjdk-22"

Guidelines

Weasis Plug-in Development

This page describes the necessary configurations to be able to debug Weasis using an IDE. For developers who want to create new plug-ins, you can visit How to build and install a plug-in.

We recommend the use of IntelliJ IDEA because the following instructions are based on it. Nevertheless, it is possible to use other IDEs by configuring weasis-launcher with similar instructions described in Add a launcher.

Prerequisites

1. Install IntelliJ IDEA (Community or Ultimate Edition 2024.1 or higher)
2. Use JDK 23 or higher and set the language level to SDK Default in _File > Project Structure… > .
3. In File > Settings… > Plugins install google-java-format plugin from Marketplace and enable it from google-java-format Settings

Code style and convention

Weasis uses google-java-format as coding conventions. The format can be applied by Maven through the Spotless plugin or from the IDE (by importing the IntelliJ Java Google Style file). Formatting code with an IDE is not 100% compatible with Spotless, so it is better to use the latter before submitting new commits. This guarantees identical code formatting regardless of the system or code editor used.

• From Maven command: mvn spotless:apply
• From the Maven panel

Getting the source and building Weasis

• Getting the Source
  • For external Git client, see Building Weasis.
  • From IntelliJ IDEA: New > Project from Version Control…
    • In the Get from Version Control dialog, select the menu Repository URL and enter the following URL: https://github.com/nroduit/Weasis.git (public repository)
• Building Weasis plug-ins
  • In the maven panel, select clean/install in Lifecycle of weasis-framework (root) to compile and to install all the plug-ins in the local Maven repository.

Add a launcher

For running or debugging Weasis, you need to create a launcher:

• Open Run > Edit Configurations…

• Create a new Application

  • Select weasis-launcher as a module (field starting by -cp)
  • Main Class: browse org.weasis.launcher.AppLauncher
  • Click on Modify Options
    • Select Add dependencies with “Provided” scope to classpath
    • Select Do not build before run
    • Select Add VM Options and enter -Xms64m -Xmx768m -Dgosh.port=17179
  • Working Directory: remove the current value and add %MODULE_WORKING_DIR% from the Insert Macros button
    Note

    As the default build task has been removed it is necessary to apply the Maven command install on modules with modified code before launching the Run or Debug mode.
    Keeping the build task and delegating the build to Maven does not seem configurable for a multi-module project, see this issue.

• Examples of launching parameters by entering values in the Program arguments text box

  • Loading DICOM files from a local path:

    $dicom:get -l \"D:\images test\dicom\"

    Note

    Some command interpreters need to escape the quotes or double quotes required for paths or URLs. This is the case with IntelliJ IDEA or Eclipse.
    For more commands at startup see also Weasis commands.

    Warning

    In Eclipse launcher parameters, ‘&’ within URLs needs to be escaped with a backslash.

• Examples of other VM options for overriding the default Preferences

  • Removing the possibility of exporting DICOM: -Dweasis.export.dicom=false
  • Defines a new user (for getting specific preferences): -Dweasis.user=user1
  • Examples with specific configuration files:
    • For launching Weasis Dicomizer: -Dfelix.extended.config.properties=file:target/conf/dicomizer.json
    • Configuration from an URL: -Dfelix.extended.config.properties=https://mysite.com/weasis/conf/config.json
      Note

      felix.config.properties defines the location of base.json (the OSGI configuration and the list of plug-ins to install/start)
      felix.extended.config.properties defines the location of a json file (extends/overrides base.json)

Internationalization

Translation files are hosted and managed on the Transifex website. Get an account and help to translate to your language! If your language is missing, just head over to Transifex and request a new language.

Building Weasis-i18n

weasis-i18n is the internationalization project (i18n) of Weasis. As a separate project, it can have its own release cycle. The OSGi fragments of plug-ins contain only the translation files which are merged during runtime to the matching module of the application.

To obtain daily built packages, see this page.

Prerequisites

1. JDK 11 or higher
2. Maven 3 or higher
   If your computer is behind a proxy server, configure maven.
3. Git or directly download the source code from GitHub

Getting the Source

To clone the repository, first install GIT and either clone using a graphical GIT client (such as Tortoise Git) or directly from the command line using the command:

$ git clone https://github.com/nroduit/weasis-i18n.git

Build the distribution

Go in the weasis-i18n directory, Compile and install all the plug-ins in the local Maven repository

$ mvn clean install -Dtransifex.token="<your-token>"

All the APIs require to be authenticated. So the value “your-token” must be replaced by your generate token, see how to get this token on Transifex.

Command if you are behind a proxy server:

$ mvn clean install -DproxySet=true -DproxyHost="host" -DproxyPort="port" -Dtransifex.token="<your-token>"

Apply the translations

The translation package can be built manually as described below or it is automatically built every 24 hours and can be downloaded from here. When Building Weasis, the last package is downloaded automatically.

• In order to update Weasis with new translations, unzip weasis-i18n.zip and either:
  • Pass the weasis.i18n location into the launch command:

    $weasis:config pro="weasis.i18n <your-uri>"
    $weasis:config pro="weasis.i18n file:/home/weasis-i18n-dist-4.0.0-SNAPSHOT"
    $weasis:config pro="weasis.i18n https://<your-domain>/weasis-i18n-dist-4.0.0"

  • Replace the files in the “bundle-i18n” folder where Weasis is installed (not possible when Weasis is distributed from an application store or the Mac signed package).