Changelog

Gather Resources — v0.5.2 Changelog

Follow-up bugfixes after 0.5.1 (Blender 5.x compatibility)

This update finalises the Blender-5 path behaviour introduced in 0.5.1 and fixes the last inconsistencies between scan → map → relink.

1. Unified Blender-5 path normalisation

• compat/v5/normalize() is now the only normalisation used in:
  • v5 scanner
  • v5 relinker
  • root operator (Blender-5 branch)
• All .resolve() calls removed from Blender-5 logic.

Effect: mapping keys now match exactly between scanner, operator and relinker.

2. Operator mapping logic corrected for Blender-5

• Blender-5 mapping keys now use:

  src_key_str = normalize(str(src))
  

src_path derived from this normalised key ensures subpath computation and duplicate detection behave consistently.

Changelog

Gather Resources — v0.5.1 Changelog

Critical Blender-5.0 compatibility bugfix release

This update is essential for anyone using Blender 5.0 or newer.
Blender’s VSE and file-path handling changed in 5.0, which caused several types of external media to fail to relink or relink incorrectly in earlier versions.

v0.5.1 restores correct behaviour in Blender 5 while keeping Blender 4.5 behaviour completely unchanged.

Fixes and Improvements (Blender 5.x only)

1. Unified path normalisation

A single normalize() helper is now used consistently in:

• the Blender-5 scanner
• the operator when building mapping keys
• the Blender-5 relinker

This ensures all components generate matching keys and prevents silent relink failures.

2. Removal of all .resolve() usage in Blender-5 logic

Path.resolve() previously caused directory collapsing and mismatched absolute paths.
Blender-5 logic now uses only:

• bpy.path.abspath()
• Path.absolute()

This stabilises keys across scanner, operator and relinker.

3. Correct MOVIE-strip relinking

Movie strips in Blender 5 now follow the required update sequence:

1. assign an absolute path
2. then finalise as a relative path (//textures/...)

This avoids Blender rejecting updated paths or rewriting them internally.

4. Correct SOUND-strip relinking

Sound datablocks now follow the same absolute-then-relative procedure, ensuring consistent relinking for all audio strips.

5. Correct IMAGE-sequence strip handling

Blender 5 requires stricter handling for image-sequence strips.
The relinker now:

• updates filenames only
• sets strip.directory to an absolute path first
• then finalises it as a relative directory

This restores proper sequence playback and portability in 5.0.

6. Image datablocks correctly finalised as relative paths

Standalone image datablocks (not VSE strips) now always store: //textures/...
after relinking, ensuring clean and portable project files.

7. No changes to Blender 4.2–4.5 behaviour

All code under compat/v4_5 remains untouched.
Blender 4.x continues to behave exactly as before.

Summary

v0.5.1 resolves all known relinking issues introduced by Blender 5.0, including problems with:

• movie strips
• sound strips
• image sequence strips
• texture datablocks

This release is recommended for all Blender-5.x users.

Changelog

v0.5.0 – Multi-Version Compatibility Overhaul

General Architecture

• Split the old monolithic __init__.py into a structured module layout:
  • compat/v4_5/scanner.py, compat/v4_5/relink.py
  • compat/v5/scanner.py, compat/v5/relink.py
  • New unified traversal layer (api.py)
  • Updated internal modules (copier.py, utils.py)
• Added dynamic version resolver that selects the correct compat layer based on bpy.app.version
• Enables seamless support for both Blender 4.5 LTS and Blender 5.0+

Blender 5.0 API Migration

• Added support for Blender 5’s updated VSE architecture:
  • sequence_editor.strips_all replaces deprecated sequences_all
  • Direct traversal rewritten to avoid removed or deprecated attributes
  • Safe scene → sequencer-scene resolution implemented
• Updated path logic for Blender 5:
  • Removed invalid "//" path assumptions
  • Introduced strict path normalisation using pathlib.resolve()

Relinker Overhaul (Core Fix)

• Completely rewritten relinker, fully compatible with Blender 5
• Deterministic absolute→relative transformation logic
• Dedicated handling for all strip types:
  • MOVIE (strip.filepath)
  • SOUND (strip.sound.filepath)
  • IMAGE Sequence (strip.directory + element filenames)
  • MOVIECLIP (strip.clip.filepath)
  • MASK (strip.mask.filepath)
• Avoids illegal property assignments removed in Blender 5
• Added debug-tracing mode:
  • Displays mapping keys and normalised absolute paths
  • Explains why each strip was or was not relinked
  • Confirmed correct across all strip types

Scanner Updates

• V4.5 scanner updated to align with the unified API structure
• V5 scanner rewritten to detect cache, image, video, and sound sources using Blender 5’s Python API
• Both scanners now produce a unified mapping output used by the relinker

Issue #1 – Addon Rejection in Blender 5 (Critical)

• Fixed installation failures when installed via the Extensions system:
  • Corrected directory naming and import paths
  • Removed implicit relative imports that caused runtime load failures
• Verified through GitHub Issue:
  https://github.com/SimonHeggie/GatherResources/issues/1

Quality & Maintenance

• Added iter_vse_strips() (cross-version safe)
• Added path normalisation helpers (_abs(), _abs_from_path())
• Corrected folder creation order for textures/
• Improved resilience around missing paths, invalid properties, and runtime exceptions
• Cleaner logging, clearer user messages, and a more future-proof internal architecture

Known Bugs:

Images are not linking properly here, I'm racing to fix it very soon.

This release establishes the foundation for ongoing support across Blender 4.5 LTS, Blender 5.x, and future versions without breaking legacy installations.

Changelog

v0.4.0 – Major Stability & Relinking Overhaul

• New fully rewritten relink system for images, movies, sounds, and image sequences
• Now gathers and relinks strips from all scenes
• Improved folder-preservation logic (keeps meaningful parent folders; collapses redundant textures/)
• Better duplicate handling (reuse identical files; auto-rename conflicts)
• More robust error handling around file operations
• Faster, more stable multi-threaded copying
• Cleaner directory output (removes empty folders inside textures/)
• Fixes several long-standing issues with path rewriting, saving in new locations, and outdated file references

Please note you will need a later version in order to have compatibility with Blender 5.0.