Repository navigation
FallByte v1.3.0
FallByte v1.3.0 — Official Release
This update introduces significant enhancements to the media processing engine, including support for new video and image formats (HDR 10-bit color depth and HEIC/HEIF), alongside a major architectural refactoring that improves application stability, performance, and maintainability.
New Features
- 10-bit / HDR Video Support (HEVC): The processing engine now preserves 10-bit color depth (
yuv420p10le) when encoding HEVC/H.265 video sources vialibx265, maintaining ayuv420pfallback for 8-bit compatibility (#40). - Native HEIC/HEIF Image Support: Integrated
pillow-heifto enable reading, converting, and compressing HEIC/HEIF images (.heic, .heif), including build configuration updates for Debian and AppImage release packaging (#27). - Smart HEVC Compression: HEVC sources targeting MP4/MOV/MKV containers now retain the H.265 codec using adaptive CRF scaling and optimized encoding presets, preventing unintended file size expansion (#18).
- Automatic System Language Detection: The UI now detects and sets the application language based on the host operating system preferences on first launch (#24).
- Expanded Video Format Coverage: Added scanner and file picker support for additional video input extensions:
.m4v,.flv,.ts,.3gp, and.mpg(#26).
Security, Safety & Concurrency Fixes
- Atomic File Operations: Replaced direct file copies and overwrites with atomic temporary operations (
atomic_replace), ensuring target files are never corrupted or deleted on user cancellation or unexpected failure (#17, #39). - Single-File Overwrite Protection: Implemented unique output path resolution for single-file compression workflows to avoid overwriting existing files (#35).
- Orphan FFmpeg Process Prevention: Ensured immediate termination and cleanup of partial FFmpeg processes on progress callback exceptions, and resolved concurrent pipe race conditions using
process.wait()(#38). - Source/Destination Path Validation: Prevented execution when input and output directories are identical or nested (#16).
User Interface & Experience Improvements
- Batch Progress Accuracy: Added the
is_completedstate flag toProgressInfofor live tracking and eliminated duplicate log entries in the UI (#36). - Log Line Color Precedence: Adjusted UI log highlighting so explicit status tags (
[FAIL],[ERROR]) override generic keyword matches in file names (#42). - File Picker Extension Filtering: Restricted file selection dialogs to display only relevant media types per module page (#26).
- Contrast Adjustments: Mapped stop action button styling to maintain high text legibility (#34).
Architecture, Refactoring & Test Suite
- Unified Batch Execution: Consolidated directory batch processing into a central
batch_runner.pyorchestrator and unified session cleanup logic (#17, PR #32). - Centralized Formats and Route Registries: Centralized supported media formats in
src/formats.pyand dynamic application navigation inui/registry.py(#22). - BaseController Extraction: Extracted common controller logic into a shared
BaseControllerclass to reduce code duplication across UI controllers. - Expanded Test Suite: Restructured tests by layer (
tests/engine,tests/ui) with characterization tests covering FFmpeg process mocks, batch cancellations, concurrent execution, and file preservation.
Summary of Major Technical Changes
-
Media Engine Optimization (10-bit / HDR / HEVC):
StreamInfonow probes stream metadata viaprobe_streams()to detect 10-bit pixel formats and applies theyuv420p10levideo filter during H.265 encoding. HEVC sources keep the H.265 codec with dynamic CRF calculation (CRF = 23 + (100 - quality) * 0.22), preventing re-encoded HEVC files from becoming larger than their originals. -
HEIC/HEIF Pipeline Integration:
Full support for Apple HEIC images (pillow-heif==0.21.0/ Pillow12.3.0), including format detection inSUPPORTED_IMAGE_EXTENSIONS, uncompressible file preservation, and build system configuration (libheif1system dependency and PyInstaller collection flags). -
Data Integrity & Concurrency Hardening:
All engine output writes and fallback operations now use atomic operations (copy_original_file_atomically/os.replace). In case of process cancellation or FFmpeg failures, existing user files remain intact and background subprocesses are cleanly terminated. -
Modular Architecture & Test Coverage:
Batch runners, progress tracking, and session cleanup are unified inbatch_runner.pyandcleanup.py. Format definitions reside insrc/formats.py, and UI controllers inherit from a singleBaseController. The test suite (153+ tests) covers edge cases including missing system FFmpeg binaries and pipe race conditions.