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 create an ISO as a symlink to the disc device afterwards. --skip-if-existing PREMIUM Skips updating a DKM file if it 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. PREMIUM A num‐ ber of 12 or 13 digits on the command line will be auto-detected as barcode. --no-barcode Generate no ean_13 object. --isbn=ISBN Specify the ISBN number. Some releases come with this along with a barcode. --f-cover=FRONT COVER URL/URI for a front cover. --b-cover=BACK COVER URL/URI for a back cover. --i-cover=INLAY COVER URL/URI for an inlay cover. --j-cover=INLAY FLIP COVER URL/URI for an inlay flip cover. --fb-cover=FRONT BACK COVER URL/URI for a front back cover. --bf-cover=BACK FRONT COVER URL/URI for a back front cover. --d-cover=DISC COVER URL/URI for a disc cover. --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. PREMIUM Auto detect on com‐ mand line. --mould-sid-code="IFPI 0628" Mould SID code pressed into the very inner polycarbonate on the disc, e.g. "IFPI CD23". PREMIUM Auto detect on command line. --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. PREMIUM Auto detect from disc tags. --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: 0). --naudio=N Generate N audio content templates (default: 0). --nimages=N Generate N image content templates (default: 0). --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. Your copyright notice put in the dkm field of a DKM file. Metadata for games: TODO ENVIRONMENT A list of available environment variables with their default values in square brackets. DKM_DKM_COPYRIGHT [] Your copyright notice put in the dkm field of a DKM file. Handy to define once in the (local) config. 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.6.1 dkm(1)