disc-kuraudo(1) disc-kuraudo Documentation disc-kuraudo(1) NAME disc-kuraudo — An ecosystem for managing, generating metadata and streaming (to your CFW PS3) of disc based media. SYNOPSIS dk[various] options DESCRIPTION Various tools prefixed with dk (see SEE ALSO) are provided for managing, generating metadata and streaming (to your CFW PS3) of disc based media and video files. These tools have separate manpages. OPTIONS The various tools prefixed with dk come with their own options, check their separate manpages. Basic behavior is set in the following hierarchy, each overruling the next entries: 1. Command line arguments (e.g. --drive=DRIVE) 2. Environment variables (see ENVIRONMENT) 3. Local configuration file (see FILES) 4. Global configuration file (see FILES) 5. Hardcoded defaults (same as provided with the stock global configura‐ tion file) FILES Configuration files follow a basic fixed VAR=VALUE scheme where the in‐ put after the '=' is read until the end of the line, do not use extra spaces or quotes. E.g. DK_ROOT=/home/user/dk will work while things like DK_ROOT = /home/user/dk DK_ROOT="/home/user/dk" DK_ROOT=${HOME}/dk will simply not work. The configuration files are expected in the following locations: /etc/disc-kuraudo/disc-kuraudo.conf Global configuration file in the default prefix. Overridable with DK_PREFIX, see environment. ${HOME}/.conf/disc-kuraudo/disc-kuraudo.conf Local configuration file. For available variables that can be used in the configuration files, see ENVIRONMENT. ENVIRONMENT Here is a list of available environment variables with their default values in square brackets. DK_ROOT [/srv/dk] The root directory DK_DRIVE [/dev/sr0] The path to the disc drive device file. DK_RETRIES [32] Sets how many retry attempts are set for readom(readcd) when dumping with dkdump. DK_CACHE [/tmp/disc-kuraudo] Path to a cache directory. /tmp/ is usually mounted as a tmpfs (RAMdisk). DK_PS3_IP [192.168.178.3] IP of your PS3 to mount a disc image remotely or send over a list of disc images along with available covers. DK_PREFIX [] This environment variable needs to be set if intsalling to an‐ other location than the default prefix to read the global config. DK_DKM_COPYRIGHT [] Your copyright notice put in the dkm field of a DKM file. Handy to define once in the (local) config. DIRECTORY STRUCTURE Here is an example directory structure of a DK_ROOT directory for DVD- Video: DK_ROOT ├── covers │ └── dvd-video │ └── genre │ └── studio │ ├── studio.title.r2012.12.21.pal.dvd.f.png │ └── studio.title.r2012.12.21.pal.dvd.b.png ├── dkm │ └── dvd-video │ └── genre │ └── studio │ ├── studio.title.disc1.r2012.12.21.pal.dvd9.dkm │ ├── ... │ └── studio.title.disc10.r2012.12.21.pal.dvd9.dkm └── media └── dvd-video └── genre └── studio ├── log │ ├── studio.title.disc1.r2012.12.21.pal.dvd9.dkdump │ ├── ... │ └── studio.title.disc10.r2012.12.21.pal.dvd9.dkdump ├── studio.title.disc1.r2012.12.21.pal.dvd9.iso ├── ... └── studio.title.disc10.r2012.12.21.pal.dvd9.iso MEDIA Media in the DK_ROOT/media directory shall be placed in the following subdirectories DK_ROOT/media/cd-video DK_ROOT/media/dvd-video DK_ROOT/media/hddvd-video DK_ROOT/media/bd-video DK_ROOT/media/pc-cd DK_ROOT/media/ps1 DK_ROOT/media/ps2 DK_ROOT/media/ps3 DK_ROOT/media/psp DK_ROOT/media/video TAGS disc-kuraudo utilizes tags in the file names to hold minimal information about the files to make file system searches possible, with more de‐ tailed information in a DKM file. The tags are named in a way to be hopefully not colliding with studio names or content titles, e.g. .ner‐ oburningrom. is used instead of .nero., which could be part of a movie title. This is because these additional tags (except B-Warez tags) are filtered out when looking for covers or extracting content off the discs. The general pattern of a file name: prefix_tags.date_tag.suffix_tags.iso Example: studio.title.rYYYY.MM.DD.ntsc.dvd9.iso Prefix tags: studio. Studio that authored this disc. .title. Title of the disc content. .disc1., .disc2., ..., .sidea., .sideb. Tells which disc number or side of a disc of a release is refer‐ enced. Date tag: .rYYYY.MM.DD. Release date of the disc. Timestamps and the content of files should not be dated after this date. .tYYYY.MM.DD., .tunknown. Latest timestamp found on disc, indicating a 'not before' date. Used when the exact release date of this disc is not known, e.g. when the timestamps date past a known release date of the content and this re-release was not announced publicly. Some discs have invalidated dates, e.g. dated to year 2036 (maximum NTP time) or year 1900, in this case and when the metadata of files don’t hint a latest timestamp. the tag .tunkown. is used. Suffix tags: .ddrescue. Indicates that the disc was dumped with ddrescue, it usually means that there were issues reading the disc. It is good prac‐ tice to double check the integrity of files even if all sectors were rescued. .readerror. Indicates that the dump has read errors. Probably from an incom‐ plete ddrescue dump. .css. Indicates that the DVD-Video disc is cucked with CSS, stands for Content Scrambling System. Some contents of the disc are ini‐ tially locked for reading. Once an undocumented authentication with the drive that any DVD playback software will gladly per‐ form, the disc will be fully readable permanently until ejected. If you have a habit of first checking the DVD out with DVD Player software, you won’t even notice this locking mechanism in the first place. The VOB files on CSS discs are technically playable but audio/video is distorted (scrambled) to make it unwatchable. A weak 40-bit key holds information about the unscrambling, which can be brute-forced in milliseconds with processors in current year. .nss. Stands for No Scrambling System and indicates that the disc was uncucked from CSS. This was achieved by replacing files on disc with uncucked ones in-place. This keeps all the timestamps and metadata intact and is considered a perfect uncucking. .arccos. Indicates that the DVD-Video disc is cucked with ARccOS, a copy annoyance mechanism deployed around 2004 onwards, usually on top of CSS. A system of intentionally pressing bad sectors on disc that remain unreferenced and are (hopefully) not being read by DVD players during playback. These unreadable sectors waste space that could have been used for a better video quality. Also some official DVD players reportedly have issues playing these properly. .aacs. Indicates that the HD-DVD or Blu-Ray disc is cucked with AACS, standing for Advanced Access Control System. It deeply encrypts the .m2ts files using AES128. The decryption of the content every time the disc is played repeatedly wastes a few Watts of power. AACS provides hashes that you can verify your dumps with, soon with using dkcheck(1) (premium), which is very handy. .nacs. Stands for No Access Control System and indicates that the disc was uncucked from AACS. This was simply achieved by replacing files on disc with uncucked ones in-place and renaming an 'AACS' string found a bunch of sectors into the disc to 'NACS' with a hex-editor so a Blu-Ray player doesn’t assume an encrypted disc. This keeps all the timestamps and metadata intact and is consid‐ ered a perfect uncucking. Some ripping softwares rename the ‘AACS' string to 'ANY!', 'FAB!' or 'SLY!', these can just be re‐ named to 'NACS' accordingly to keep it consistent. dkcheck(1) (premium) will soon provide functionality to re-encrypt the con‐ tent on the fly and check it against the hashes provided in the NACS directory if the disc key is present in .con‐ fig/aacs/KEYDB.cfg. .pal., .ntsc., .ntscu., .ntscj. Indicating the TV standard (DVD-Video) or the region (PS1/PS2/PS3) used on the disc. .cd., .dvd5., .dvd9., .hddvd5., .hddvd9., .hddvd15., .hddvd30., .bd5., .bd9.. .bd25., .bd50., .bdxl100., .bdxl128. Specifies the medium of the disc. .warez. Indicates that the file is to be found on the high seas (Warez) untouched (apart from only uncucking measures) and thus consid‐ ered an honorable release. .bwarez. Indicates that the file is to be found on the high seas but botched by being modified for some reason, thus considered an un‐ honorable release. Examples follow. .videots., .bdmv., .hvdvdts. (B-Warez) Extracted discs where only the directories on disc, e.g. directories like VIDEO_TS, BDMV, HVDVD_TS, are provided. All timestamps and other metadata of the disc are lost. It is almost impossible to date this release by looking at the files. Even DVDs/Blu-Rays that aren’t cucked are often times released like this instead of providing a 1:1 disc image for some reason. .neroburningrom., .imgburn., .mkisofs., .mactheripper., .dvdshrink., .drmp., .clonecd., .clonedvd. (B-Warez) Watermarks of ripping software or reconstruction are contained on disc. .incompletedisc. (B-Warez) Incomplete discs that have content removed because the releaser felt like nobody else would want to have it. Often times come with watermarks as tools like DVDSrink or DRMP are usually used to botch this. .modifieddisc. (B-Warez) Disc image was somehow modified (e.g. region lock re‐ moved, DVD Decrypter (ISO/MDS) does it implicitly with no option to turn it off). If it is only a few bytes that are modified, it is possible to undo the process if the original bytes are pro‐ vided. .f., .b., .i., .bf., .fb Cover tag suffix for Front, Back, Inlay, Back+Front Front+Back for JPG and PNG covers, see DIRECTORY STRUCTURE for an example. BUGS Discord server: [https://discord.gg/KV6brta] AUTHOR Darjan Krijan [https://disc-kuraudo.eu] SEE ALSO dkdiscinfo(1), dkddump(1), dkextract(1), dkiso2mkv(1), dklaunch(1), dkm(1), dkrename(1), dkserver(1), dkthumbnailer(1), ffmpeg(1), makemkv(1) Version 0.5.4 disc-kuraudo(1)