Using metadata from your Stash to rename/move your file.

• renamerOnUpdate
  • Table of Contents
• Requirement
• Installation - ❗ Make sure to configure the plugin by editing config.py before running it ❗
• Usage
• Configuration
• Config.py explained
  • Template
  • - You can find the list of available variables in config.py
  • Filename
    • - Based on a Tag
    • - Based on a Studio
    • - Change filename no matter what
  • Path
    • - Based on a Tag
    • - Based on a Studio
    • - Based on a Path
    • - Change path no matter what
    • - Special Variables
  • Advanced
    • Groups
  • Option
    • p_tag_option
    • field_replacer
    • replace_words
    • removecharac_Filename
    • performer_limit

• Stash (v0.15+)
• Python 3.6+ (Tested on Python v3.9.1 64bit, Win10)
• Request Module (https://pypi.org/project/requests/)
• Tested on Windows 10/Synology/docker.

• Download the whole folder 'renamerOnUpdate' (config.py, log.py, renamerOnUpdate.py/.yml)
• Place it in your plugins folder (where the config.yml is)
• Reload plugins (Settings > Plugins > Reload)
• renamerOnUpdate appears

• Everytime you update a scene, it will check/rename your file. An update can be:

  • Saving in Scene Edit.
  • Clicking the Organized button.
  • Running a scan that updates the path.

• By pressing the button in the Task menu.

  • It will go through each of your scenes.
  • :warning: It's recommended to understand correctly how this plugin works, and use DryRun first.

• Read/Edit config.py

  • Change template filename/path
  • Add log_file path

• There are multiple buttons in Task menu:

  • Enable: (default) Enable the trigger update
  • Disable: Disable the trigger update
  • Dry-run: A switch to enable/disable dry-run mode

• Dry-run mode:

  • It prevents editing the file, only shows in your log.
  • This mode can write into a file (dryrun_renamerOnUpdate.txt), the change that the plugin will do.
    • You need to set a path for log_file in config.py
    • The format will be: scene_id|current path|new path. (e.g. 100|C:\Temp\foo.mp4|C:\Temp\bar.mp4)
    • This file will be overwritten everytime the plugin is triggered.

To modify your path/filename, you can use variables. These are elements that will change based on your metadata.

• Variables are represented with a word preceded with a $ symbol. (E.g. $date)
• If the metadata exists, this term will be replaced by it:
  • Scene date = 2006-01-02, $date = 2006-01-02
• You can find the list of available variables in config.py

In the example below, we will use:

• Path: C:\Temp\QmlnQnVja0J1bm55.mp4
• This file is Big Buck Bunny.

Change your filename (C:\Temp\QmlnQnVja0J1bm55.mp4)

Priority : Tags > Studios > Default

tag_templates  = {
	"rename_tag": "$year $title - $studio $resolution $video_codec",
	"rename_tag2": "$title"
}

studio_templates  = {
	"Blender Institute": "$date - $title [$studio]",
	"Pixar": "$title [$studio]"
}

use_default_template  =  True
default_template  =  "$date $title"

The file became: C:\Temp\2008-05-20 - Big Buck Bunny.mp4

Change your path (C:\Temp\QmlnQnVja0J1bm55.mp4)

p_tag_templates  = {
	"rename_tag": r"D:\Video\",
	"rename_tag2": r"E:\Video\$year"
}

p_studio_templates  = {
	"Blender Institute": r"D:\Video\Blender\",
	"Pixar": r"E:\Video\$studio\"
}

p_path_templates = {
	r"C:\Temp": r"D:\Video\",
	r"C:\Video": r"E:\Video\Win\"
}

p_use_default_template  =  True
p_default_template  =  r"D:\Video\"

The file is moved to: D:\Video\QmlnQnVja0J1bm55.mp4

$studio_hierarchy - Create the entire hierarchy of studio as folder (E.g. ../MindGeek/Brazzers/Hot And Mean/video.mp4). Use your parent studio.

^* - The current directory of the file. Explanation:

• If: p_default_template = r"^*\$performer"
• It creates a folder with a performer name in the current directory where the file is.
• C:\Temp\video.mp4 so ^*=C:\Temp\, result: C:\Temp\Jane Doe\video.mp4
• If you don't use prevent_consecutive option, the plugin will create a new folder everytime (C:\Temp\Jane Doe\Jane Doe\...\video.mp4).

You can group elements in the template with {}, it's used when you want to remove a character if a variable is null.

Example:

With date in Stash:

• [$studio] $date - $title -> [Blender] 2008-05-20 - Big Buck Bunny

Without date in Stash:

• [$studio] $date - $title -> [Blender] - Big Buck Bunny

If you want to use the - only when you have the date, you can group the - with $date Without date in Stash:

• [$studio] {$date -} $title -> [Blender] Big Buck Bunny