Command-line options
The viewer can be started by any other software by calling 'DICOMviewer.exe'. Via the command-line the DICOM viewer can:
-Open one or more DICOM files
-Search one or more folders for DICOM files
-Perform a DICOM query from a PACS and display the results
-Display all sensitive data anonymously
-be terminated
The general command-line syntax is the following:
DICOMviewer.exe -OptionWithData optiondata
-OptionWithoutData
"filename or folder"
-A space is used to separate options and/or option-data
-Options start with '-' and may appear in any order
-Option-data do not start with '-'
-Option-data, filenames or folders which may include spaces must be entered between double quotes
Command-line options 'Rubo DICOM viewer'
[general options]
"filename" Pass one or more DICOM files to display in the image window
"folder" Pass one or more folders to scan/search for DICOM files. Found DICOM image files are displayed in
the overview window
Examples:
DICOMviewer.exe "d:\dicom\patientX"
DICOMviewer.exe "d:\dicom\patientY\angio.dcm"
DICOMviewer.exe "d:\dicom\patientX" "d:\dicom\patientY\angio.dcm"
-anony Display privacy sensitive data anonymously
Example:
DICOMviewer.exe -anony "d:\dicom\patientX"
-ini Ini file with specific settings. Will be ignored if 'DICOMviewer.ini' is present
Example:
DICOMviewer.exe -ini "DefaultSettings.ini"
-quit Close the DICOM viewer. Do not use in combination with other command-line options
Example:
DICOMviewer.exe -quit
-reset Resets all settings of the DICOM viewer and associated application (Waveform viewer, IVUS longviewer,
DICOM parser, DICOM burner, DICOM anonymizer, DICOM communication).
A pop-up will ask for confirmation of the reset
Example:
DICOMviewer.exe -reset
[general communication options]
-host ip/hostname IPv4 or IPv6 address or hostname of DICOM server/PACS or client
-port number Port number of DICOM server or client
-lport number Listen port number for the incoming connection initiated by the DICOM server/PACS.
Used for retrieving DICOM data using CMOVE.
Specify if port number is different from '-port'
-rae AE Remote Application Entity, maximum 16 characters. May be required by DICOM server/PACS
-lae AE Local Application Entity, maximum 16 characters. May be required by DICOM server/PACS
[query options]
-qp Perform a query for patients
-qs Perform a query for studies
-pn abcd Patient name starting with "abcd"
-pid ab12 Patient ID starting with "ab12"
-pbd YYYYMMDD Patient birth-date. Date format is 4 digits for year and 2 for month and date (YYYYMMDD)
-stdate YYYYMMDD Study date
YYYYMMDD-YYYYMMDD Study date range. First date MUST be earlier/less than the second date
[secured TLS encryption options]
-tls Enable TLS secured communication
-tlscrt "filename" TLS certificate. PEM or PKCS12(p12) format is supported
-tlskey "filename" TLS private key file. Mandatory with a PEM certificate
-tlspwd "pass-phrase" Pass-phrase/password. Use if private key file is protected with pass-phrase or password
[logging options]
-log level Specify the level of logging of DICOM communications.
Levels:
0 : default
1 : expand incoming data
2 : expand outgoing data
3 : expand both incoming and outgoing data
-mhx bytes Maximum bytes in a bytes-dump when expanding data. Default is 4096 bytes
[advanced options]
-aa Allow all Abstract Syntaxes (SOP classes) suggested by the Calling AE. Default
-na Only accept known Abstract Syntaxes (SOP classes)
Command-line examples
Search folders, displaying DICOM files
DICOMviewer.exe "Z:\DICOM\PatientX"
Search this folder for DICOM files and display them in the overview window
DICOMviewer.exe "Z:\DICOM\PatientX\StudyY\Image0001.dcm"
Open and display this DICOM file
DICOMviewer.exe "Z:\DICOM\PatientX" "Z:\DICOM\PatientX\StudyY\Image0001.dcm" -anony
Search the folder and display in overview window, and display the single DICOM file.
Patient sensitive data is anonymized.
Query examples
Assume a DICOM server/PACS at IP address 10.0.1.12, using port 11112 with Application Entity 'OURDICOMPACS', listen port (for retrieval) same as port.
The DICOM viewer Application Entity is set at 'RUBODICOMVIEWER'.
DICOMviewer.exe -qp -pn "b" -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Patient query (-qp) for names starting with "b" (-pn "b")
DICOMviewer.exe -qp -pid "1234" -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Patient query (-qp) for ID's starting with '1234' (-pid "1234")
DICOMviewer.exe -qp -pbd "19701022" -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Patient query (-qp) with birthdate on 22 October 1970 (-pbd "19701022")
DICOMviewer.exe -qs -pn "ba" -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Study query (-qs) with patient names starting with "ba" (-pn "ba")
DICOMviewer.exe -qs -stdate 20220501 -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Study query (-qs) for studies from May 1st 2022 (-stdate 20220501)
DICOMviewer.exe -qs -stdate 20190701-20191231 -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
Study query (-qs) for studies in the last 6 months of 2019 (-stdate 20190701-20191231)
DICOMviewer.exe -qp -pn "*" -host 10.0.1.12 -port 11112 -rae OURDICOMPACS -lae RUBODICOMVIEWER
-tls -tlscrt "C:\MyCertificate.pem" -tlskey "C:\MyPrivateKey.key"
TLS (-tls) encrypted/secured query for all patient names. The DICOM server MUST support TLS or this will fail.
Pass your certificate (-tlscrt) and private key file (-tlskey), the private key file is not protected by a pass-phrase