Repository navigation
FallByte v2.0.0
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 (64kfor AAC/M4A), mono-aware Vorbis bitrate capping (256k), and automatic preflight bypass for uncompressible formats such as WMA. - Rotating File Logging &
--debugMode: Configured root application logging with a rotating file handler and added the--debugCLI flag for verbose diagnostic troubleshooting (#69). - OS-Standard Configuration Directories: Migrated
config.yamlto native platform paths ($XDG_CONFIG_HOME/fallbyteor~/.config/fallbyteon Linux,%APPDATA%\FallByteon Windows) with automatic one-time migration from legacy~/.fallbyte/config.yamland 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
TextRedirectorwrites andsmoke_checkfallbacks againstNonesys.stdout/sys.stderrstreams 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 extendedformat_sizeto 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_existedoverwrite 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.pyintosrc/utils/, standardized domain-prefixed utility modules, addedpyproject.tomlwith 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
-
Decoupled Audio Engine & UI Integration:
Implemented audio format definitions insrc/formats.py, pure FFmpeg helpers (audio_ffmpeg_utils.py), and atomic single/batch processors wired toAudioConversionControllerandAudioCompressionControllerviaui/registry.py. Supports legacy/exotic streams (such as WMA and AIFF without explicit sample-rate metadata) and protects uncompressible files during batch runs. -
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. -
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--debugsupport so runtime diagnostics are persisted cleanly across sessions.