Differences

This shows you the differences between two versions of the page.

--- directory_dir2dat_guide [2021/12/31 17:20] – hiccup
+++ directory_dir2dat_guide [2023/11/17 12:33] (current) – hiccup
@@ Line 1: / Line 1: @@
-If the "ROM" consists of a folder with multiple sub-folders and files, you will want to use the "dir2dat" function of clrmarepro with {{:submission:clrmamepro_dir2dat_directory_hashing.png?linkonly|these}} settings. Make sure the "PXXX00000" directory you want to hash is inside of two empty folders, and point clrmamepro towards that first empty folder - this is so that the "PXXX00000" directory is treated as a sub-directory of the "game" entry in the datfile. You can test this setup is working correctly by hashing the contents of {{ :test_dir_structure.zip |this zip}} and comparing the datfile that clrmamepro creates with {{ :test_dir_structure.dat.zip |this pre-made datfile}} . Currently there is no solid solution for "directory hashing" that supports SHA256, so you can leave that out.
+====== Directory Dir2Dat Guide ======
+todo: document how to use RomVault for this, as that is a much better option
-{{:carts:sony:vita:folder_structure_to_get_correct_datfile_structure.png?400|}}
+**Warning: there currently is no supported dir2dat tool that properly distinguishes between empty files and folders. As a workaround, you should use store the output of
+`dir /s` (if you are using Windows) or `ls -R` (if you are using Linux) alongside the datfile.**
+If the "ROM" consists of of multiple directories, you will want to use the "dir2dat" function of [[https://mamedev.emulab.it/clrmamepro/|clrmamepro]] with the following settings in the "Options" section.
+{{:submission:clrmamepro_dir2dat_directory_hashing.png?400}}
+In other words, make sure only the following boxes are checked in that section:
+  * Scan Subfolders
+  * Add MD5
+  * Add SHA1
+  * Add 0-File For Empty Folder
+  * Set-Subfolder Mode
+  * Keep Archives As Files
+  * Keep CHDs As ROMs
+You can also press the Load button and load {{ :general:dir2dat-directory.d2d.zip |this}} dir2dat config file to achieve the same thing.
+Make sure to lay out the data as with the following example.
+{{:general:directory_dir2_dat_folder_structure.png?400|}}
+You can test this setup is working correctly by hashing the contents of {{ :test_dir_structure.zip |this zip}} and comparing the datfile that clrmamepro creates with {{ :test_dir_structure.dat.zip |this pre-made datfile}} . Currently there is no solid solution for "directory hashing" that supports SHA256, so you can leave that hash type out.
+There will also be a top-level entry called "Default" with a single empty folder, which should be ignored/deleted.