blender-studio-pipeline/scripts/remap/README.md
Nick Alberelli 844c6c7389 Remap: Refactor scripts (#177)
## What's Changed?
 - Remap scripts are consolidated into a single remap script
 - Updated README to explain new remap workflow

### New Remap Tool Demo
<video src="/attachments/b76d1fe5-5eda-4269-a8eb-5f79096decbe" title="2023-12-06 16-25-40.mkv" controls></video>

Reviewed-on: #177
2023-12-07 16:17:25 +01:00

1.1 KiB

Remap Tools

This directory contains scripts that are useful for re-organizing production directories. The tools are intended to be used when some directories need to be changed, and references to these directories need to be updated in .blend files.

Usage

  1. Enter remap directory cd blender-studio-pipeline/scripts/remap
  2. Run the remap tool via python -m remap. You will be prompted for a directory to map, and a location to store the map (outside of your remap directory).
  3. Now you are ready to re-organize your mapped directory, move files into different folders, rename files and remove duplicates.
  4. Re-run the remap tool via python -m remap to update your map with the new file locations. The tool will print a bbatch, copy this for use in step 6.
  5. Enter bbatch directory cd blender-studio-pipeline/scripts/bbatch
  6. Run provided bbatch command, similar to python -m bbatch {my_files}/ --nosave --recursive --script {path_to_script}/remap_blender_paths.py --args "{path_to_json}/dir_map.json" to update all references to the remapped directory contents in your .blend files.