rb2engine 0.6.1

rb2engine 0.6.1

This release continues the Last-Xuan-ai fork under shizuon/rb2engine, preserving its history and existing conversion and overview features. Install this build from the GitHub assets below; the upstream PyPI project is separately maintained.

Fixes

• Preserve source Unicode spelling when macOS FAT directory enumeration decomposes names, while retaining actual filename casing and requiring the proposed path to resolve to the same file.
• Preserve verified macOS FAT/SMB SFM special-character aliases. Alias paths must resolve to the same non-symlink file; ordinary filenames are not blindly rewritten.
• Recover materially inaccurate duration estimates for unindexed VBR MP3 files only when a complete, contiguous MPEG frame scan exactly matches decoded PCM. Partial frames, skipped junk, stream changes and decoder warnings still fail validation.
• Keep indexed/native audio clocks unchanged and avoid truncating audio tails based on a faulty bitrate estimate.
• Correct platform gating for literal-colon filename tests on Windows.

Validation and scope

Local validation: 969 tests plus 19 subtests passed, 6 physical-stick tests excluded; coverage 89.24%. Ruff and mypy passed. Release CI runs nine OS/Python combinations and an Apple Silicon native waveform integration job.

The converter leaves source audio and the Pioneer export unchanged. This release does not automatically rename source files, deduplicate libraries, or publish private USB contents. Windows filename checks and automated CI do not establish playback in Windows Engine DJ/rekordbox or on physical players. Waveform generation retains its existing platform limitations.

Install

Download rb2engine-0.6.1-py3-none-any.whl and verify it against SHA256SUMS, then run:

python -m pip install ./rb2engine-0.6.1-py3-none-any.whl

For optional waveform generation, install the waveforms extra and the external audio dependencies described in the README.