馃殌 What's New in v1.5
This release marks a major overhaul of the MergeHelper utility, with a complete rewrite in Python and several powerful new features.
馃攧 Major Enhancements
-
Migration to Python
- Replaces the legacy
mergehelper.shBash script with a more robust and maintainable Python script:mergehelper.py. - Improved cross-platform compatibility, error handling, and extensibility.
- Replaces the legacy
-
CUE File Parsing and Validation
- Parses
.cuefiles to extract track data and validate structure before merging. - Prevents mismatched merges by ensuring the data tracks align with CUE definitions.
- Parses
-
Recursive Processing
- The script now recursively scans directories from any starting path.
- Automatically locates and processes all subfolders containing multi-track BIN/CUE files.
- No need to restructure your game library beforehand鈥攊deal for large-scale batch operations.
鈿欙笍 Functional Improvements
-
Smarter Merge Logic
- Uses cue data and filename heuristics to intelligently determine merge order.
- Ensures consistent naming and emulator-friendly output.
-
Improved Logging
- Structured terminal logging shows clear progress, issues, and summary information for each merge.
-
Safe File Handling
- Prevents accidental overwrites and moves original files into a dedicated
orig/folder after a successful merge.
- Prevents accidental overwrites and moves original files into a dedicated
馃梻 Note: The Bash version (mergehelper.sh) is still included but considered deprecated.
Full Changelog: v1.1...v1.5