-
1.23 Stable
released this
2026-04-28 15:29:02 +02:00 | 0 commits to main since this releaseWhat's new
Every
.zipproduced byblender_asset_tracer.pack.zipped.ZipPackernow contains a top-levelbat-debug.logcapturing the full DEBUG-level trace of the pack run. Archives are self-describing — you no longer need terminal output to debug what BAT found, where it rewrote paths to, which files were missing, or which references resolved to where.What's captured
- Banner: BAT version, UTC timestamp, blend file(s), project root, target,
noop/relative_only/keep_hierarchyflags,sys.argv, Python version, platform. - Trace phase: every block expansion, every
Resolved/Resolvingline, everyMissing filewarning, library load failures. - Pack phase: every
ZIP src → dstline for files copied (compressed and stored), every path-rewrite update inside blend files. - Closing: a
BAT Pack closing; flushing debug log to bat-debug.logline confirming the buffer was flushed cleanly.
Usage
# After producing a pack unzip -p mypack.zip bat-debug.log | less # Or extract just the log unzip -p mypack.zip bat-debug.log > pack.logNotes
- The capture is independent of CLI verbosity —
-qstill keeps the terminal quiet while the in-zip log stays at DEBUG. No flag needed; it's always on for zip targets. noopmode skips the log embedding (no zip is written).- KeyboardInterrupt and
FileTransferErrorpaths still flush whatever was logged up to the abort point. - Adds ~10–15 MB to a typical production pack; negligible vs. the multi-GB asset payload.
- Only
ZipPackeris affected — filesystem, S3, and Shaman packers are unchanged.
Downloads
- Banner: BAT version, UTC timestamp, blend file(s), project root, target,
-
1.22 Stable
released this
2026-03-24 18:07:50 +01:00 | 1 commits to main since this releaseBAT v1.22 — Sequence Packing
Highlights
Pack entire shot sequences in one go. Select a sequence folder, BAT finds the latest published blend files across all shots, traces and deduplicates shared dependencies, and packs everything into a single ZIP.
New features
Blender addon
- Pack Sequence operator (
File > External Data > BAT > BAT - Pack Sequence) — browse to a sequence folder, scan for latest published blend files, review and toggle individual shots, export to ZIP - Studio template system — dropdown to select folder conventions per studio (Autour de Minuit, La Cabane Productions). Templates define where to look for published files and which task types are available
- Progress indicator — cursor progress bar during tracing and file transfer on all pack operators
- Auto-named output — ZIP filename inferred from the scanned folder name
CLI
- New
bat pack-sequence -t output.zip file1.blend file2.blend ...subcommand for packing multiple blend files with unambiguous argument parsing - Old
bat pack --sequencestill works but is deprecated
Improvements
- Blender 5.0 compatibility fixes (DNA struct changes for nodes, modifiers, sequencer)
- Console logging for all pack operations (trace progress, asset counts, transfer status)
- ZIP write start/finish logging
pack-info.txtnow lists all blend files when packing a sequence
Bug fixes
- Fixed folder matching using prefix instead of exact match (e.g.
Publish_oldcould be picked overPublish) - Fixed Windows UNC and drive letter path normalization in
bpathlib.make_absolute() - Fixed
os.path.commonpathcrash when blend files span multiple drives - Fixed progress bar getting stuck on pack failure (missing
progress_end()cleanup) - Fixed ZIP error handler swallowing tracebacks
- Added per-shot error isolation in sequence scan (one broken folder no longer aborts the entire scan)
- Deduplicate blend file paths when same file appears in both positional arg and
--sequence
Testing
- 28 new tests for sequence packing (
tests/test_sequence_pack.py) - 0 regressions on existing test suite
Downloads
- Source Code (ZIP)
- Source Code (TAR.GZ)
-
image.png
128 KiB
-
image.png
61 KiB
- Pack Sequence operator (
-
1.21 Stable
released this
2026-02-20 11:01:20 +01:00 | 5 commits to main since this releaseWhat's new
Pack operators in Blender
Two pack operators are now available under File > External Data:
- BAT - Zip pack (flat) — Pack all assets into a flat ZIP archive
- BAT - Zip pack (keep hierarchy) — Pack preserving the project directory structure, with configurable project root and optional directory copy mode
Keep hierarchy packing
New
--keep-hierarchyCLI option that preserves the full project directory structure in the pack. Paths in blend files are rewritten to relative paths within the hierarchy.Addon preferences
Added a preferences panel (Edit > Preferences > Add-ons) to configure:
- A default project root directory
- Reading the root from
ZIP_ROOTorPROJECT_ROOTenvironment variables
Improvements
- Refactored addon structure: operators and preferences moved to dedicated modules (
operators.py,preferences.py) - Fixed cyclic package import with the preferences module
Downloads