User Tools

Site Tools


how_datvault_works

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
how_datvault_works [2021/11/19 20:26] johnsanchow_datvault_works [2022/03/12 09:06] johnsanc
Line 1: Line 1:
 ====== How DATVault Works ====== ====== How DATVault Works ======
-DATVault was designed to be flexible and it does not force you to organize your DATs in any specific way. DATVault works by detecting special JSON files in your DatRoot. Each DAT you would like to manage has its own corresponding JSON file. Each file provides info about the DAT version you currently have. This info is compared against the DATVault database to determine if there are updates available to download.+DATVault acts as an indexing, updating, and delivery service for DATs. DATVault is designed to be flexible and it does not force you to organize your DATs in any specific way.  
 + 
 +{{ :diagrams:datvault-flow.png?nolink |}} 
 + 
 +===== DATVault JSON Files ===== 
 + 
 +DATVault works by detecting special JSON files in your DatRoot. Each DAT you would like to manage has its own corresponding JSON file. Each file provides info about the DAT version you currently have.  
 + 
 +|**⚠ CAUTION:** \\ The DATVault JSON files are not meant to be manually edited. Modifying the JSON files may cause DAT updates to not work properly. The information provided is for reference only.|
  
 The DATVault JSON files contain the following keys: The DATVault JSON files contain the following keys:
-  * **''name''**: The name of the DAT which is displayed in the DATVault UI +  * **''group''**: The group the DAT belongs to. Used for filters. 
-  * **''date''**: The date the DAT was was last updated on the DATVault server +  * **''system''**: The name of the system. 
-  * **''version''**: The version of the DAT which is displayed in the DATVault UI +  * **''date''**: The date the DAT was was last updated on the DATVault server. 
-  * **''updateURL''**: The URL to this JSON file on the DATVault server. This is used to compare against your local file to know if your DAT is up-to-date or not+  * **''dateCreated''**: The date the DAT was first added to DATVault. Used for the configurable "New" filter. 
-  * **''datURL''**: The download URL for the current DAT +  * **''version''**: The version of the DAT. 
-  * **''cueURL''**: The download URL for the current cue pack for the DAT if applicable +  * **''datURL''**: The download filename for the current DAT. 
-  * **''datName''**: The file name of the current DAT+  * **''cueURL''**: The download filename for cue pack of the DAT (if applicable). 
 +  * **''datName''**: The file name of the current DAT
 +  * **''directory''**: The default subdirectory the DAT will be downloaded to if the "Use default subdirectories" option is used when adding new DATs with the DATVault UI. 
 +  * **''datROMsSize''**: The total uncompressed size of all ROMs in the DAT.
  
 **Example DATVault JSON for MAME:** **Example DATVault JSON for MAME:**
 <code> <code>
 { {
-   "name":"MAME MAME ROMS (listxml)", +   "group":"MAME", 
-   "date":"11/10/2021 2:28:56 PM", +   "system":"MAME ROMS (listxml)", 
-   "version":"V0.237", +   "date":"2/23/2022 9:55:34 AM", 
-   "updateURL":"http://www.datvault.com/public/MAME/info/MAME ROMS (listxml).json", +   "dateCreated":"9/7/2021 1:19:26 PM", 
-   "datURL":"http://www.datvault.com/public/MAME/dat/MAME V0.237 ROMS (listxml).zip",+   "version":"V0.241", 
 +   "datURL":"MAME V0.241 ROMS (listxml).zip",
    "cueURL":"",    "cueURL":"",
-   "datName":"MAME V0.237 ROMS (listxml).dat"+   "datName":"MAME V0.241 ROMS (listxml).dat"
 +   "directory":"MAME ROMS (listxml)", 
 +   "datROMsSize":307346898538
 } }
 </code> </code>
 +
 +The information in the JSON file is compared against the DATVault repository to determine if there are updates available to download. If the JSON file you have does not match the latest version available by DATVault, then the corresponding DAT has an update. When you update a DAT, the JSON file is also updated.
 +
 +|**⚠ CAUTION:** \\ DATVault only manages DAT updates for DATs it has downloaded. It will NOT update DATs you have placed into your DATRoot manually. Its advised to remove any manually managed DATs before having DATVault manage those DATs.|
 +
 +|**ⓘ NOTE:** \\  DATVault will download any updates into the same directory that contains the respective JSON file. Before a DAT is updated, the current DAT you have (which is referenced in your JSON file) will be renamed with a ''.old'' extension. DATVault does not automatically remove these ''.old'' DATs, so you may want to periodically delete them if you do not wish to archive old DATs.|
 +
 +|**ⓘ NOTE:** \\ Some DATs for disc based systems have accompanying cue sheets. DATVault will download cue packs to a folder called ''cues'' in your Primary ToSort directory.|
 +
 +Now that you understand how DATVault works at a high level, refer to the next section to [[datvault_setup|get started using DATVault]].
how_datvault_works.txt · Last modified: 2023/07/04 08:38 by johnsanc