Differences

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

--- tosort_directories [2020/11/23 16:24] – johnsanc
+++ tosort_directories [2023/07/04 08:37] (current) – johnsanc
@@ Line 1: / Line 1: @@
 ====== ToSort Directories ======
 ToSort directories contain any files that are not included in any of your DATs. You have the ability to add multiple ToSort directories for different purposes. For example, you could assign a ToSort directory for newly downloaded files and another for any files that are removed from your RomRoot.
-----
-\\
+<WRAP info>The settings for ToSort directories are not stored in the RomVault3Cfg.xml file. ToSort directory definitions are stored in the cache and are not editable outside of the RomVault UI.</WRAP>
-==== The Default ToSort ====
-RomVault comes configured with a default ToSort directory. This directory is called "ToSort" and it resides in the same location as the RomVault EXE. **You must create this directory yourself**, it will not be created automatically when RomVault tries to remove a file that is not needed from your RomRoot.
-You must always have at least one ToSort directory which acts as the Primary. You may remove the default ToSort from the tree only if you have at least one other ToSort directory configured.
+===== Overview of ToSort use cases =====
+| ^  ToSort Type  ^^^
+^Use Case^  Primary  ^  Cache  ^  Generic  ^
+|Removing files which are not needed in any set|  X  | | |
+|Downloading cue packs from DATVault (stored in the ''/cues/'' folder)|  X  | | |
+|Compressing and decompressing solid archives|  -  |  X  | |
+|Fixing sets with files not found in any other collected set|  X  |  X  |  X  |
+<WRAP info>If no Cache ToSort is configured, then the Primary ToSort will be used for compressing and decompressing solid archives.</WRAP>
+===== The default primary ToSort =====
+RomVault comes configured with a default Primary ToSort directory. This directory is called "ToSort" and it resides in the same location as the RomVault EXE. **You must create this directory yourself.**
+You may remove the default Primary ToSort from the tree only if you have at least one other ToSort directory configured. RomVault requires a Primary ToSort to function because that is where all removals are placed.
 If you choose to only use a single ToSort directory then it will be multi-purpose for the following use cases:
@@ Line 13: / Line 23: @@
   * Used as a temporary directory for working with 7z files, which are often compressed as solid archives (torrent7z)
   * Used for you to place any files you wish to scan and sort through to move to their proper place in the RomRoot with a fix operation
+  * Used for storing any downloaded cue packs from DATVault. These are stored in the ''/cues/'' folder of your Primary ToSort.
-\\
+===== Adding and removing ToSort directories =====
-==== Adding and Removing ToSort Directories ====
 You can add a new ToSort directory by clicking "Add ToSort" from the top menu. There is no practical limit to the number of ToSorts you can add.
 To Remove a ToSort directory, right click on it in the tree and select the "Remove" option. Once you remove the ToSort, all references to files within that directory are removed from the cache.
-\\
-==== Customizing ToSort Directories ====
+===== Customizing ToSort directories =====
 There are three types of ToSort directories you can use to customize your setup in way that works best for you:
-=== Primary ===
+==== Primary ====
   * You can define one Primary ToSort
   * Any files you put here will be can be scanned and used for fixes if the box is checked
@@ Line 35: / Line 45: @@
 {{ :tosort_primary.png?nolink&400 |}}
-=== Cache ===
+==== Cache ====
   * You can define one Cache ToSort
   * Any files you put here will can be scanned and used for fixes if the box is checked, although you may want to leave this folder alone and let RomVault use it exclusively as a temporary working area
@@ Line 45: / Line 56: @@
 {{ :tosort_cache.png?nolink&400 |}}
-=== Generic ===
+==== Generic ====
   * You can have as many Generic ToSorts as you like
   * Any files you put here will be scanned and used for fixes if the box is checked
@@ Line 53: / Line 64: @@
 {{ :tosort_generic.png?nolink&400 |}}
-To assign a ToSort as Primary or Cache right click on it in the tree and select "Set To Primary ToSort" or "Set To Cache ToSort" respectively.
+<WRAP tip>To assign a ToSort as Primary or Cache right click on it in the tree and select "Set To Primary ToSort" or "Set To Cache ToSort" respectively.</WRAP>
-\\
-==== Using the Read-Only Modifier ====
+===== Using the read-only flag =====
 You can lock a ToSort or any other directory in the tree by right clicking the checkbox.
-The lock icon signifies that the contents of the directory will be read-only for the purposes of fixing. Any files in a directory flagged as read-only will be used for fixes, however the files will not be removed from that directory.
+The lock icon signifies that the contents of the directory will be read-only for the purposes of fixing. Any files in a directory flagged as read-only will be used for fixes, however the files will not be removed from that directory. This feature is particularly useful for an archived set of files, or a Torrent download directory where you would not want to remove files while you are seeding.
-This feature is particularly useful for an archived set of files, or a Torrent download directory where you would not want to remove files while you are seeding.
 The read-only flag can be removed by left-clicking the checkbox.
 {{ :tosort_readonly.png?nolink&400 |}}
+===== Video Tutorial - ToSort Directories =====
+{{youtube>UihzFXXqzvo?full}}