Skip to content

Releases

FallByte v2.1.0

Choose a tag to compare

@brunothinker brunothinker released this 21 Nov 18:26

FallByte v2.1.0 — Media Tools Expansion & UI Polish

This minor release expands FallByte from a compression and conversion utility into a complete local-first Media Tools suite—introducing 6 new processing tools across Images, Videos, and Audio alongside unified branding, hierarchical navigation, and Linux startup window stabilization.


New Features & Media Tools

Images

  • Batch Image Resizing & Scaling: Resize single images or entire folders (JPEG, PNG, WEBP, BMP, TIFF, GIF, PPM, ICO, HEIC, HEIF) using Lanczos resampling either by maximum target bounding dimensions or by percentage scale (1%–100%), with aspect ratio preservation, no-upscale protection, EXIF orientation baking, animated frame support, and automatic HEIC-to-PNG remapping (#89).
  • Standalone Metadata Removal & Compression Sanitization: Strip sensitive EXIF, GPS coordinates, XMP, ICC profiles, PNG textual chunks (tEXt/iTXt), and GIF comments across single files or batch directories while preserving pixel orientation and animation frames. Also adds an optional Remove metadata (EXIF/GPS) toggle directly inside the Image Compression tool (#86).

Videos

  • Batch Video Resolution Downscaling: Downscale high-resolution videos across all 11 supported containers to 1080p (Full HD), 720p (HD), or 480p (SD) for single files or folders. Preserves landscape and portrait aspect ratios with even H.264/HEVC pixel dimensions and automatically bypasses re-encoding (copying streams untouched) for videos already at or below the target resolution (#90).
  • Audio & Subtitle Track Selector (Lossless Stream Remuxing): Inspect embedded audio and subtitle streams (language, codec, channel layout, and Default/Forced flags) across all 11 video containers and export clean copies keeping only the selected tracks via lossless stream remuxing (-c copy) without re-encoding (#87).

Audio

  • Single & Batch Video-to-Audio Extraction: Extract audio tracks from video files directly into MP3, M4A, OPUS, OGG, FLAC, or WAV for single videos or entire folders, featuring rescue stereo fallback and automatic skipping of silent videos (#88).
  • Batch Volume Normalization (EBU R128): Normalize perceived loudness across audio folders (MP3, M4A, AAC, OGG, OPUS, FLAC, WAV) using FFmpeg's loudnorm filter with presets for Music / Streaming (-14 LUFS), Podcast / Voice (-16 LUFS), and Broadcast / Standard (-23 LUFS) (#91).

UI, Navigation & Bug Fixes

  • Unified "Media Tools" Branding & Hierarchical Back Navigation: Updated application branding to Media Tools across all 10 locales with primary-colored glowing brand titles in the sidebar and home view, and updated Back navigation to step up one level in the route hierarchy rather than unwinding linear visit history (#79).
  • Linux Startup Window Geometry Stabilization: Fixed initial window sizing glitches on Linux by starting Flet hidden (FLET_HIDE_WINDOW_ON_START), applying 1100x720 default bounds (800x600 minimum), resizability, and centering prior to revealing the window inside a finally guard.

Documentation, Refactoring & Testing

  • Modularized Test Suite & Full 10-Language Coverage: Split oversized batch, UI, and image test files into focused topic modules for easier maintenance, added complete i18n keys across all 10 supported locales (en, pt, es, fr, de, it, ja, zh, ru, ko), and expanded unit, UI controller, and integration test coverage for all six new tools.
  • Updated Project Documentation: Documented all new Image, Video, and Audio workflows, subsystem responsibilities, and architecture diagrams in README.md, docs/ARCHITECTURE.md, and tests/README.md.

Summary of Technical Changes

  1. Six New Single & Batch Processing Engines (src/):
    Added image_file_resize / image_directory_resize, image_file_metadata / image_directory_metadata, file_downscaler / directory_downscaler, video_track_selector (backed by probe_media_tracks), file_extractor / directory_extractor, and audio_file_normalization / audio_directory_normalization—all honoring atomic writes, cancellation cleanup, and multi-strategy FFmpeg fallbacks.
  2. Expanded Hub Routing & Controllers (ui/):
    Registered 6 new routes and workspace pages (image_resize, image_metadata, video_downscale, video_tracks, audio_extraction, audio_normalization) with dedicated controllers, real-time progress reporting, and hierarchical route resolution.
  3. 10-Locale Parity & Startup Window Lifecycle:
    Synchronized localization keys across _template.yaml and all 10 language files, and hardened Flet startup geometry initialization on Linux desktops.

FallByte v2.0.1

Choose a tag to compare

@brunothinker brunothinker released this 18 Nov 22:54

FallByte v2.0.1 — Maintenance & Localization Release

This maintenance release expands FallByte's localization coverage to 10 languages, introduces redesigned 2-column preference modals, isolates per-file errors during batch runs, and hardens Linux release packaging.


New Features & UI Improvements

  • Expanded Localization (10 Languages): Added complete native translations and automatic Windows locale detection (_WIN_NAMES / _WIN_LANGIDS) for German (de), French (fr), Italian (it), Japanese (ja), Korean (ko), Russian (ru), and Simplified Chinese (zh), alongside English, Portuguese, and Spanish (#71).
  • Scoped 2-Column Preference Modals: Extracted the language and theme selectors from ui/app_layout.py into dedicated modular components (ui/components/language_dialog.py and ui/components/theme_dialog.py). Both modals now render centered over the main workspace in compact 2-column grids with active selection badges and primary-color accent strips.

Bug Fixes & Stability Improvements

  • Batch Error Isolation & Explicit Failure Reporting: Isolated per-file exceptions during batch processing so unexpected errors on individual files no longer abort the remaining queue. Preserved InterruptedError cancellation and cleanup of newly generated outputs, while reporting setup, progress-callback, and batch-level errors explicitly across all six module controllers (#50, #73 by @ocabezas95).
  • Linux Packaging & Release Pipeline Hardening: Updated release metadata, desktop application icons, and automated Docker integration tests for .deb, .rpm, and .AppImage builds (#52).

Architecture, Refactoring & Testing

  • Modular UI Dialog Architecture: Decoupled preference modal rendering and persistence logic from the root navigation frame (ui/app_layout.py), improving maintainability and Ruff / PEP 8 compliance.
  • Expanded Regression & i18n Test Coverage: Updated localization schema and placeholder parity tests in tests/ui/test_i18n.py for all 10 locales, added batch failure isolation and logging regression tests, and updated docs/ARCHITECTURE.md (442 passing tests).

Summary of Technical Changes

  1. Per-File Batch Fault Tolerance:
    BatchRunner now counts processor, destination-building, and output-verification failures individually without halting subsequent items, returning structured error summaries to all image, video, and audio batch controllers.

  2. 10-Language YAML Locale Suite & Windows Detection:
    Added 7 schema-validated .yaml files under resources/locales/ with full placeholder parity against _template.yaml and registered their corresponding Windows locale names and primary LANGID codes in ui/i18n.py.

  3. Workspace-Scoped Modal Overlay & Theme Preview Tiles:
    Replaced full-page AlertDialog lists with a workspace-scoped overlay stack in ui/app_layout.py backed by dedicated 2-column grid cards for Dark/Light theme swatches and native language tiles.

FallByte v2.0.0

Choose a tag to compare

@brunothinker brunothinker released this 17 Nov 17:08

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.

FallByte v1.3.0

Choose a tag to compare

@brunothinker brunothinker released this 10 Nov 19:06

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.

FallByte v1.2.0

Choose a tag to compare

@brunothinker brunothinker released this 29 Oct 19:46

FallByte v1.2.0 — Official Release

This major update brings a complete overhaul to the visual experience, robust multi-language support, safe background process management, and smart batch file organization.

Features

  • Dynamic Theme System: Added multiple visual themes (Blue, Purple, Emerald, Red, and Amber) with full support for Dark and Light variations, along with automatic preference persistence.
  • Redesigned Interface and Navigation: New persistent navigation sidebar and quick language selector (Portuguese, English, and Spanish).
  • Smart Output Directories: Batch operations now generate unique and safe folders (compressed, compressed_1, etc.), preserving files from previous runs.
  • Session Lock: Navigation and theme switching are safely locked during background media processing.

Fixes & Refactors

  • FFmpeg Management: Video processes now respond instantaneously to the cancel button (with safe termination, partial file cleanup, and orphan process prevention).
  • Format Validation: Added a dedicated dialog for unsupported files and preventive pre-flight blocking for empty batches.
  • UI and Theme Stability: Fixed native Flet controls to properly inherit the active theme at runtime.
  • Build Orchestrator: Implemented a master packaging script with support for dynamic version injection (APP_VERSION).

FallByte v1.1.0

Choose a tag to compare

@brunothinker brunothinker released this 27 Oct 04:40
6cf9140

FallByte v1.1.0 — Official Release

FallByte is a fast, lightweight, and local-first media optimization tool designed to reclaim disk space without compromising quality or privacy.

What's New in this Version

  • Core Engine Overhaul (src/): Complete rewrite and optimization of the core media processing pipeline for higher stability and performance.
  • Bug Fixes & Robustness: Resolved multiple edge-case issues in single and batch file conversion/compression.
  • New UI Themes & Customization: Added multiple dark and light theme presets with fully dynamic Flet color schemes.
  • Multi-language Support: Expanded localization options for a more accessible interface.
  • Linux-First Focus: Windows support is temporarily discontinued as development focuses exclusively on streamlining the Linux experience.

Downloads & Installation

Linux

  • Ubuntu / Debian / Pop!_OS / Mint (.deb):
    Download fallbyte_1.1.0_amd64.deb and install via terminal with sudo apt install ./fallbyte_1.1.0_amd64.deb or double-click to open in Software Center.

  • Fedora / RHEL / openSUSE (.rpm):
    Download fallbyte_1.1.0_x86_64.rpm and install with sudo dnf install ./fallbyte_1.1.0_x86_64.rpm.

  • Arch Linux / Universal Portable (.AppImage):
    Download fallbyte_1.1.0_x86_64.AppImage, grant execution permission with chmod +x fallbyte_1.1.0_x86_64.AppImage, and run directly.

FallByte v1.0.0 — Initial Release

Choose a tag to compare

@brunothinker brunothinker released this 14 Aug 13:39

FallByte v1.0.0 — Official Release

FallByte is a fast, lightweight, and local-first media optimization tool designed to reclaim disk space without compromising quality or privacy.

Downloads & Installation

Linux

  • Ubuntu / Debian / Pop!_OS / Mint (.deb):
    Download fallbyte_1.0.0_amd64.deb and install via terminal with sudo apt install ./fallbyte_1.0.0_amd64.deb or double-click to open in Software Center.

  • Fedora / RHEL / openSUSE (.rpm):
    Download fallbyte_1.0.0_x86_64.rpm and install with sudo dnf install ./fallbyte_1.0.0_x86_64.rpm.

  • Arch Linux / Universal Portable (.AppImage):
    Download fallbyte_1.0.0_x86_64.AppImage, grant execution permission with chmod +x fallbyte_1.0.0_x86_64.AppImage, and run directly.


Windows

  • Windows 10 / 11 (Portable .zip):
    Download FallByte-v1.0.0-windows-x64.zip, extract the folder, and execute main.exe (or FallByte.exe).
    (Note: Dedicated Windows setup/installer coming soon!)