/usr/bin/dcm2json

$dcmtk: dcm2json v3.7.1 2026-10-15 $

dcm2json: Convert DICOM file and data set to JSON
usage: dcm2json [options] dcmfile-in [jsonfile-out]

parameters:
  dcmfile-in                   DICOM input filename to be converted
                               ("-" for stdin)
  jsonfile-out                 JSON output filename (default: stdout)

general options:
  -h     --help                print this help text and exit
         --version             print version information and exit
         --arguments           print expanded command line arguments
  -q     --quiet               quiet mode, print no warnings and errors
  -v     --verbose             verbose mode, print processing details
  -d     --debug               debug mode, print debug information
  -ll    --log-level           [l]evel: string constant
                               (fatal, error, warn, info, debug, trace)
                               use level l for the logger
  -lc    --log-config          [f]ilename: string
                               use config file f for the logger
input options:
  input file format:
    +f   --read-file           read file format or data set (default)
    +fo  --read-file-only      read file format only
    -f   --read-dataset        read data set without file meta information
  input transfer syntax:
    -t=  --read-xfer-auto      use TS recognition (default)
    -td  --read-xfer-detect    ignore TS specified in the file meta header
    -te  --read-xfer-little    read with explicit VR little endian TS
    -tb  --read-xfer-big       read with explicit VR big endian TS
    -ti  --read-xfer-implicit  read with implicit VR little endian TS
processing options:
  encoding of infinity and not-a-number:
    -es  --encode-strict       report error for 'inf' and 'nan' (default)
    -ee  --encode-extended     permit 'inf' and 'nan' in JSON numbers
  encoding of IS and DS (integer/decimal string) elements:
    -ia  --is-ds-auto          encode as number if valid, as string
                               otherwise (default)
    -in  --is-ds-num           always encode as number, fail if invalid
    -is  --is-ds-string        always encode as string
  bulk data URI options:
    -b   --bulk-disabled       write everything as inline binary (default)
    +b   --bulk-enabled        write large attributes as bulk data
    +bz  --bulk-size           [s]ize: integer (default: 1)
                               use bulk data for attributes >= s kBytes
    +bp  --bulk-uri-prefix     [u]ri prefix: string
                               use prefix u when generating bulk data URIs
                               (default: file URI)
    +bd  --bulk-dir            [d]irectory: string
                               write bulk data files to d (default: '.')
    +bs  --bulk-subdir         create subdirectory for each SOP instance
                               (default: no subdirectory)
  charset handling:
    +c   --charset-keep        write the original charset to JSON (default)
    -c   --charset-replace     replace the original charset with UTF-8 in JSON
  specific character set:
    +Cr  --charset-require     require declaration of extended charset (def.)
    +Ca  --charset-assume      [c]harset: string
                               assume charset c if no extended charset declared
    +Cc  --charset-check-all   check all data elements with string values
                               (default: only PN, LO, LT, SH, ST, UC and UT)
output options:
  output format:
    +fc  --formatted-code      enable whitespace formatting (default)
    -fc  --compact-code        print only required characters
    +m   --write-meta          write data set with meta information
                               (warning: not conforming to the DICOM standard)