Skip to content

FallByte v1.3.0

Choose a tag to compare

@brunothinker brunothinker released this 10 Nov 19:06
· 54 commits to main since this release

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 via libx265, maintaining a yuv420p fallback for 8-bit compatibility (#40).
  • Native HEIC/HEIF Image Support: Integrated pillow-heif to 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_completed state flag to ProgressInfo for 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.py orchestrator and unified session cleanup logic (#17, PR #32).
  • Centralized Formats and Route Registries: Centralized supported media formats in src/formats.py and dynamic application navigation in ui/registry.py (#22).
  • BaseController Extraction: Extracted common controller logic into a shared BaseController class 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

  1. Media Engine Optimization (10-bit / HDR / HEVC):
    StreamInfo now probes stream metadata via probe_streams() to detect 10-bit pixel formats and applies the yuv420p10le video 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.

  2. HEIC/HEIF Pipeline Integration:
    Full support for Apple HEIC images (pillow-heif==0.21.0 / Pillow 12.3.0), including format detection in SUPPORTED_IMAGE_EXTENSIONS, uncompressible file preservation, and build system configuration (libheif1 system dependency and PyInstaller collection flags).

  3. 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.

  4. Modular Architecture & Test Coverage:
    Batch runners, progress tracking, and session cleanup are unified in batch_runner.py and cleanup.py. Format definitions reside in src/formats.py, and UI controllers inherit from a single BaseController. The test suite (153+ tests) covers edge cases including missing system FFmpeg binaries and pipe race conditions.