Files

David Maisonave a71a68ee2e Chrome local link changes

- Added code to handle Chrome, Edge and any other chrome based browser when selecting local file links from Stash URL.
  - On a Chrome based browser, the new code list the local links in text instead of as a button.
  - A note is displayed and highlighted explaining to the user that they have to copy and pasted the link to the browser's address field.
  - On browsers like FireFox, a button is displayed instead, and no note is displayed.
- Removed *.css and *.map files, which were not being used.

2024-12-15 02:17:37 -05:00

9.8 KiB

Raw Blame History

DupFileManager: Ver 1.1.1 (By David Maisonave)

DupFileManager is a Stash plugin which manages duplicate files in the Stash system. It has both task and tools-UI components.

Features

Creates a duplicate file report which can be accessed from the settings->tools menu options.The report is created as an HTML file and stored in local path under plugins\DupFileManager\report\DuplicateTagScenes.html.
- See screenshot at the bottom of this page for example report.
- Items on the left side of the report are the primary duplicates designated for deletion. By default, these duplicates are given a special _duplicate tag.
- Items on the right side of the report are designated as primary duplicates to keep. They usually have higher resolution, duration and/or preferred paths.
- The report has the following options:
  - Delete: Delete file and remove from Stash library.
  - Remove: Remove from Stash library.
  - Rename: Rename file.
  - Copy: Copy file from left (source) to right (to-keep).
  - Move: Copy file and metadata left to right.
  - Cpy-Name: Copy file name left to right.
  - Add-Exclude: Add exclude tag to scene,so that scene is excluded from deletion.
  - Remove-Tag: Remove duplicate tag from scene.
  - Flag-Scene: Flag (mark) scene in report as reviewed (or as requiring further review). Optional flags (yellow, green, orange, cyan, pink, red, strike-through, & disable-scene)
  - Merge: Copy Metadata (tags, performers,& studios) from left to right.
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.
Advance menu
- Advance menu can be access from the Settings->Tools->[DupFileManager Tools and Utilities] menu or from the reports.
  - Only access Advance Menu from the report when using Stash setup requiring a password.
- Here are some of the options available in the Advance Menu.
  - Delete specially tagged duplicates in blacklist path.
  - Delete duplicates with specified file path.
  - Delete duplicates with specific string in File name.
  - Delete duplicates with specified file size range.
  - Delete with specified duration range.
  - Delete with resolution range.
  - Delete duplicates having specified tags.
  - Delete duplicates with specified rating.
  - Delete duplicates with any of the above combinations.
Bottom extended portion of the Advanced Menu is for customizing the report.
Delete duplicate file task with the following options:
- Tasks (Settings->Task->[Plugin Tasks]->DupFileManager)
  - Tag Duplicates - Set tag DuplicateMarkForDeletion to the duplicates with lower resolution, duration, file name length, and/or black list path.
  - Delete Tagged Duplicates - Delete scenes having DuplicateMarkForDeletion tag.
  - Delete Duplicates - Deletes duplicate files. Performs deletion without first tagging.
- Plugin UI options (Settings->Plugins->Plugins->[DupFileManager])
  - Has a 3 tier path selection to determine which duplicates to keep, and which should be candidates for deletions.
    - Whitelist - List of paths NOT to be deleted.
      - E.g. C:\Favorite,E:\MustKeep\
    - Gray-List - List of preferential paths to determine which duplicate should be the primary.
      - E.g. C:\2nd_Favorite,H:\ShouldKeep\
    - Blacklist - List of LEAST preferential paths to determine primary candidates for deletion.
      - E.g. C:\Downloads,F:\DeleteMeFirst\
  - 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...
  - Swap High Resolution - When enabled, swaps higher resolution files between whitelist and blacklist/graylist files.
  - Swap Longer Duration - When enabled, swaps scene with longer duration.
- Options available via DupFileManager_config.py
  - dup_path - Alternate path to move deleted files to. Example: "C:\TempDeleteFolder"
  - toRecycleBeforeSwap - When enabled, moves destination file to recycle bin before swapping files.
  - addPrimaryDupPathToDetails - If enabled, adds the primary duplicate path to the scene detail.
Tools UI Menu
- Can access either Duplicate File Report (DupFileManager) or DupFileManager Tools and Utilities menu options.

Requirements

pip install --upgrade stashapp-tools
pip install requests
pip install Send2Trash

Installation

Follow Requirements instructions.
In the stash plugin directory (C:\Users\MyUserName.stash\plugins), create a folder named DupFileManager.
Copy all the plugin files to this folder.(C:\Users\MyUserName\.stash\plugins\DupFileManager).
Click the [Reload Plugins] button in Stash->Settings->Plugins->Plugins.

That's it!!!

Options

Options are accessible in the GUI via Settings->Plugins->Plugins->[DupFileManager].
More options available in DupFileManager_config.py.

Screenshots

Example DupFileManager duplicate report. (file names have been edited to PG).
- The report displays preview videos that are playable. Will play a few seconds sample of the video. This requires scan setting [Generate animated image previews] to be enabled when scanning all files.
- If there's a scene on the left side that has a higher resolution or duration, it gets a yellow highlight on the report.
- There's an optional setting that allows both preview videos and preview images to be displayed on the report. See settings htmlIncludeImagePreview in the DupFileManager_report_config.py file.
- There are many more options available for how the report is created. These options are targeted for more advanced users. The options are all available in the DupFileManager_report_config.py file, and the settings have commented descriptions preceeding them. See the DupFileManager_report_config.py file in the DupFileManager plugin folder for more details.
Tools UI Menu
- Can access either Duplicate File Report (DupFileManager) or DupFileManager Tools and Utilities menu options.
DupFileManager Report Menu
DupFileManager Tools and Utilities
Full bottom extended portion of the Advanced Menu screen.

Future Planned Features, Changes, or Fixes

Scheduled Changes
- Add chat icon to report which on hover, displays a popup window showing scene details content. Planned for 1.2.0 Version.
- Add image icon to report; on hover show scene cover image. Planned for 1.2.0 Version.
- Add studio icon to report; on hover show studio name. Planned for 1.2.0 Version.
- Add option on report to view rating and change it. Use an icon with a number on it to show rating. Planned for 1.2.0 Version.
- On report make flag toggle logic. In other words, when flag button is selected, and scene is already that color, remove the colored flag. Planned for 1.2.0 Version.
- Add report option to set flag to all scenes missing metadata on Scene-ToKeep or having higher resolution or longer duration on Duplicate-to-Delete scene. Planned for 1.2.0 Version.
- Add option to [Advance Duplicate File Menu] to display cover image for preview image. Planned for 1.2.0 Version.
- On report, when move operation is performed, have it automatically delete the Duplicate-to-Delete scene. Planned for 1.2.0 Version.
- On [Advance Duplicate File Menu], add a flag option to the menu on the left side, and shrink the tag option. Planned for 1.2.0 Version.
  - Change the TagOrFlag option on the right side to a check mark.
- Add option to delete by file type. Planned for 1.2.0 Version.
- On report, have [Flag or Tag] option still enabled after manually disabling scene. Planned for 1.2.0 Version.
- On [Advance Duplicate File Menu], have the details section hide fully, or partially when the page is first displayed. Planned for 1.4.0 Version.
Unscheduled Changes
- Change splitbutton so it hides tooltip when hovering over dropdown side of the button.
- Fix errors on HTML page listed in https://validator.w3.org.
- Add logic to merge performers and galaries seperatly from tag merging on report.
- Add logic to merge group metadata when selecting merge option on report.
- Add advanced menu directly to the Settings->Tools menu.
- Add report directly to the Settings->Tools menu.
- Create cookies for the options in the [Advance Duplicate File Menu].
- Add doulbe strike-through option to flagging.
- Add option to report to avoid reloading page after updating report.
- Add option to report to automatically strip width & height from name on rename.
- Add link to version history to [Advance Duplicate File Menu] and to [DupFileManager Tools and Utilities]

9.8 KiB Raw Blame History