Skip to content

FallByte v2.0.0

Choose a tag to compare

@brunothinker brunothinker released this 17 Nov 17:08
· 24 commits to main since this release

FallByte v2.0.0 — Official Release

This major release expands FallByte into a complete multimedia processing suite by introducing a dedicated Audio Conversion and Compression Module, alongside native OS configuration directories, rotating file logging, and a YAML-based localization architecture.


New Features

  • Full Audio Processing Module: Added end-to-end single-file and batch audio conversion and compression, featuring stream probing, cover-art stripping (-vn), real ADTS compression for .aac, codec-specific bitrate floors (64k for AAC/M4A), mono-aware Vorbis bitrate capping (256k), and automatic preflight bypass for uncompressible formats such as WMA.
  • Rotating File Logging & --debug Mode: Configured root application logging with a rotating file handler and added the --debug CLI flag for verbose diagnostic troubleshooting (#69).
  • OS-Standard Configuration Directories: Migrated config.yaml to native platform paths ($XDG_CONFIG_HOME/fallbyte or ~/.config/fallbyte on Linux, %APPDATA%\FallByte on Windows) with automatic one-time migration from legacy ~/.fallbyte/config.yaml and atomic file persistence (#57).

Bug Fixes & Stability Improvements

  • Batch Error vs. Cancellation Reporting: Fixed controller exception handling so unexpected batch crashes are accurately reported as errors rather than user cancellations (#68).
  • Windowed Build Stream Safety: Guarded TextRedirector writes and smoke_check fallbacks against None sys.stdout/sys.stderr streams in windowed/GUI builds (#49).
  • Accurate File Size & Reduction Stats: Fixed double-minus formatting (--35.2%) when compressed outputs grow larger than inputs, added warning highlights for size increases, and extended format_size to support bytes (B) and gigabytes (GB) (#65).
  • Bounded Video FFmpeg Buffer & 12-Bit Detection: Replaced unbounded stderr lists with a fixed-size collections.deque(maxlen=50) and restricted high-bit-depth detection to extracted pixel format tokens, preventing metadata false positives and adding 12-bit support (#56).
  • Audio Process & File Protection: Unified active FFmpeg shutdown handlers on application exit and added pre_existed overwrite guards on single-file audio cancellation.

Architecture, Refactoring & Documentation

  • YAML Localization Architecture: Migrated translations to dynamic YAML locale files (en, pt, es) validated against _template.yaml, removing dead keys and hardcoded fallback strings (#55).
  • Centralized Utilities & Code Quality: Consolidated binary_manager.py into src/utils/, standardized domain-prefixed utility modules, added pyproject.toml with full Ruff / PEP 8 compliance, and expanded project documentation (CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, ARCHITECTURE.md, AUDIO_MODULE.md).

Summary of Major Technical Changes

  1. Decoupled Audio Engine & UI Integration:
    Implemented audio format definitions in src/formats.py, pure FFmpeg helpers (audio_ffmpeg_utils.py), and atomic single/batch processors wired to AudioConversionController and AudioCompressionController via ui/registry.py. Supports legacy/exotic streams (such as WMA and AIFF without explicit sample-rate metadata) and protects uncompressible files during batch runs.

  2. Platform-Native Config & Atomic Persistence:
    Configuration storage now resolves XDG/AppData directories automatically, migrates existing user settings on first launch, and writes updates via temporary files + os.replace() to prevent config corruption on abrupt shutdowns.

  3. Dynamic YAML i18n & Diagnostic Logging:
    Replaced static translation dictionaries with a schema-checked YAML loader (_template.yaml), combined with named rotating file log handlers and --debug support so runtime diagnostics are persisted cleanly across sessions.