dkm(1)                         dkm Documentation                         dkm(1)

NAME
       dkm — Generate metadata of discs.

SYNOPSIS
       dkm [options] disc_image
       dkm [options] disc_device --fake-file=“genre/studio/studio.fake.iso”
       dkm [options] video_file

DESCRIPTION
       Generates  metadata of a disc image, disc device or a video file in form
       of a DKM JSON file.  Intrinsic metadata about the file systems and their
       directories and files is generated automatically, while  other  metadata
       can be provided on the command line or manually added at later time.

       For  generating  metadata  off a disc device, it is recommended to cache
       and lock all the pages into memory with dklock(1) and if that  shows  no
       errors, use dkm.

       For  video  discs and videos, the medium subsection may contain informa‐
       tion about the content,  e.g. movies/episodes/scenes/clips/memes/screen‐
       shots  contained  on the medium that may be extracted with dkextract(1).
       Extraction tools (makemkv(1),  mkvmerge(1),  ffmpeg(1))  and  algorithms
       (deinterlacers,  upscalers,  etc.)  used may improve over time so it ad‐
       vantageous to gather the information once and make this  process  repro‐
       ducible.

       Metadata options can be provided to dkdump(1) as well, which will invoke
       dkm on the dumped disc image with the options provided.

OPTIONS
       -h, --help
              Opens this man page.

       --fake-file=FAKE_FILE
              Fake  the  ‘file'  object in the DKM for if metadata is generated
              directly off a disc device instead of an ISO.  You  may  want  to
              create the ISO as a symlink to the disc device afterwards.

       --skip-if-existing
              Skips DKM generation if a DKM file already exists.

       Metadata options with examples:

       If  an  option  is  not  applicable  for the disc, you may provide --op‐
       tion=null.  A missing option will implicitly set the value to "unknown".

       --barcode=BARCODE
              Barcode of the product, UPC and EAN-13 supported.

       --no-barcode
              Generate no ean_13 object.

       --isbn=ISBN
              Specify the ISBN number.  Some releases come with this along with
              a barcode.

       --no-covers
              Generate no covers object.

       --case-type=CASE TYPE
              Case type, e.g. "keep case", "jewel case".

       --case-color=CASE COLOR
              Case color, e.g. "black", "blue".

       --case-transparent="true"
              Whether the case is transparent or not (true/false).

       --case-slip="false"
              Whether the case has a (paper) slip or not (true/false).

       --mastering-code0="DF/CA\tMOVIE TITLE L0 F1 DVD\t0035-2935"
              Outer mastering code etched/lasered on the disc.

       --mastering-code0="DF/CA\tMOVIE TITLE L1 F1 DVD\t0035-2935"
              Inner mastering code etched/lasered on the disc  (for  dual-layer
              discs).

       --mastering-sid-code="IFPI LT21"
              Mastering SID code etched the disc.

       --mould-sid-code="IFPI 0628"
              Mould  SID  code pressed into the very inner polycarbonate on the
              disc, e.g. "IFPI CD23".

       --title="2012"
              Title of content on disc.

       --production-id=STR
              Production ID of the content on disc.

       --production-date="2012-12-21"
              Production date(s).  US adult films are obligated to provide this
              on the back cover and/or on the disc itself.

       --release-date="2012-12-21"
              Release date of this disc release.  All timestamps on disc should
              be before this date.

       --copyright="Copyright (C) 2012 EndOfWorld Movies"
              Copyright notice found on cover/disc.

       --cast="Director,Producer,Actor 1,Actor 2"
              Cast of a production.

       --nvideos=N
              Generate N video content templates (default: 1).  Setting a  cus‐
              tom value will set the other content types to 0 once.

       --naudio=N
              Generate  N audio content templates (default: 1).  Setting a cus‐
              tom value will set the other content types to 0 once.

       --nimages=N
              Generate N image content templates (default: 1).  Setting a  cus‐
              tom value will set the other content types to 0 once.

       --video-type=TYPE
              Set ‘type' object for all video content templates.

       --audio-type=TYPE
              Set ‘type' object for all audio content templates.

       --image-type=TYPE
              Set ‘type' object for all image content templates.

       --video-tag=TAG
              Set ‘tag' object for all video content templates.

       --audio-tag=TAG
              Set ‘tag' object for all audio content templates.

       --image-tag=TAG
              Set ‘tag' object for all image content templates.

       --aspect-ratio=ASPECT_RATIO
              Set ‘aspect_ratio' object for all content templates.

       --codec=CODEC
              Set ‘codec' object for all content templates.

       --vres-scan-fps=VRES_SCAN_FPS
              Set ‘vres_scan_fps' object for all content templates.

       --dkm-copyright=STR
              Set ‘copyright' object inside the ‘dkm' object.

       Metadata for games:
              TODO

       --dkm-copyright=STR
              Set ‘copyright' object inside the ‘dkm' object.

BUGS
       Discord server: [https://discord.gg/KV6brta]

AUTHOR
       Darjan Krijan [https://disc-kuraudo.eu]

SEE ALSO
       disc-kuraudo(1), dkdump(1), dkextract(1), vmtouch(8)

Version 0.5.4                                                            dkm(1)