This commit is contained in:
David Maisonave
2024-08-24 09:08:17 -04:00

View File

@@ -1,29 +1,26 @@
# This Plugin is under construction!!!
# DupFileManager: Ver 0.1.0 (By David Maisonave)
DupFileManager is a [Stash](https://github.com/stashapp/stash) plugin which manages duplicate file in the Stash system.
### Features
- Can merge potential source in the duplicate file names for tag names, performers, and studios.
- Normally when Stash searches the file name for tag names, performers, and studios, it only does so using the primary file. This plugin scans the duplicate files to see if additional fields are available.
- Normally when Stash searches the file name for tag names, performers, and studios, it only does so using the primary file.
- Delete duplicate file task with the following options:
- Options in plugin UI (Settings->Plugins->Plugins->[DupFileManager])
- Ignore reparse-points. By default, reparse-points are not deleted.
- Ignore symbolic links. By default, symbolic links are not deleted.
- Before deletion, merge potential source in the duplicate file names for tag names, performers, and studios.
- Optionally permanently duplicates or moved them to **trash can** / alternate folder.
- Optionally permanently delete duplicates or moved them to **trash can** / alternate folder.
- Plugin UI options
- Use a white-list of preferential directories to determine which duplicate will be the primary.
- Use a gray-list of preferential directories to determine which duplicate should be the primary.
- Use a black-list to determine which duplicates should be deleted first.
- **Permanent Delete** - Enable to permanently delete files, instead of moving files to trash can.
- **Max Dup Process** - Use to limit the maximum files to process. Can be used to do a limited test run.
- **Merge Duplicate Tags** - Before deletion, merge metadata from duplicate. E.g. Tag names, performers, studios, title, galleries, rating, details, etc...
- Options available via DupFileManager_config.py
- Use a white list of preferential directories to determine which duplicate should be the primary.
- Use a black list to determine which duplicates should be deleted first.
- Use an ignore list to avoid specific directories. No action is taken on any file in the ignore list.
- Target directories list. If this list is populated, only files under these directories are process. If list is empty, all files are processed (excluding those in ignore list).
- Alternative path to move duplicate files. Path needs to be in the same drive as the duplicate file.
- Example: "C:\TempDeleteFolder"
### Using DupFileManager
This Plugin is under construction!!!
- **dup_path** - Alternate path to move deleted files to. Example: "C:\TempDeleteFolder"
- **swapHighRes** - When enabled, swaps higher resolution files between whitelist and blacklist/graylist files.
- **swapLongLength** - When enabled, swaps scene with longer duration.
- **toRecycleBeforeSwap** - When enabled, moves destination file to recycle bin before swapping files.
### Requirements
`pip install stashapp-tools`
`pip install --upgrade stashapp-tools`
`pip install pyYAML`
`pip install Send2Trash`