[BETA] Media Collector for Isadora

DX – PY – Collect_Media is a User Actor that automatically copies all media referenced in your Isadora project into a clean, organized Media/ folder placed next to your .izz file.
This makes it easy to archive projects, prepare them for touring, package them for collaborators, or simply consolidate scattered media from multiple drives.

The tool reads Isadora’s Generate Media Report file and recreates your media structure locally, grouping files into folders that correspond to each BIN in your project.

How To Use

1. Open your project in Isadora.

2. Choose Help → Generate Media Report…

3. Save the report next to your Isadora (.izz) file using the default name:
   media-report.txt

4. Insert the TT_PY_Collect-Media User Actor into your scene.

5. If needed, set the project_dir or report_name inputs (defaults usually work).

6. Trigger run_trigger to begin the media collection process.

7. When finished, you will find a new Media/ folder beside your .izz file.
   Inside it, the actor creates one subfolder per BIN (e.g., Media/Video Files/).

8. If any files fail to copy, check failed_media_relocations.txt in the project folder for details.

That’s it — your media is now consolidated and ready to travel.

What This Actor Does

• Reads the Isadora media-report.txt and extracts all media paths

• Creates a clean folder structure mirroring your BINs

• Copies each referenced media file into the appropriate subfolder

• Logs missing or inaccessible files

• Supports 3DS model files, detecting referenced textures and copying those alongside the model whenever possible

• Safe to run multiple times — existing files are not overwritten

• Works on both Windows and macOS

Inputs

• project_dir
  Folder containing the .izz project. Leave empty to auto-detect.

• report_name
  The filename of the media report (media-report.txt by default).

• run_trigger
  Trigger (1) to start collecting media.

Outputs

• status
  Summary of how many files were copied and how many failed.

• last_error
  The most recent error encountered (if any).

Note: Open the Monitor window for detailed output, listing all copied files, linked texture images, errors, and more.

Best Practices

• Save your Isadora project under a new filename before relinking.
  When you reopen the project after running this tool, Isadora will re-link media to the newly created local files.
  This means once saved the previous links will be lost. 
  Keeping a backup ensures you can revert to the original external filepaths if needed.

• Keep the original media-report.txt.
  It contains the full list of original filepaths and may be needed to restore or verify links. Renaming this file is a good idea.

Notes

• Non-destructive: existing files are never overwritten

• Resilient: failures never crash the actor — all errors are logged

• Ideal for archiving, touring, or preparing a project handoff

What this Utility does NOT collect.

• This tool ONLY collect media in the media bins. And it will collect all media in the Bins, it does NOT know if a file is unused in your project.

• This tool does not collect external scripts (Python, Javascript, GLSL). It does not collect data array files, text reader files, SRT files or any other external file Isadora may for use. It is best practice to create a local project folder when using external files. One level next to the Isadora (.izz) project file is ideal. Example: Isadora linked to external Python files via a ‘python_modules’ folder next to the project file. This utility, creates a ‘Media’ folder next to the Isadora project file, and second level folders matching each BINs name (this is the depth Isadora searches for media).