Repository navigation
Releases
FallByte v2.1.0
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 automaticHEIC-to-PNGremapping (#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/Forcedflags) 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, orWAVfor 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'sloudnormfilter 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), applying1100x720default bounds (800x600minimum), resizability, and centering prior to revealing the window inside afinallyguard.
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, andtests/README.md.
Summary of Technical Changes
- Six New Single & Batch Processing Engines (
src/):
Addedimage_file_resize/image_directory_resize,image_file_metadata/image_directory_metadata,file_downscaler/directory_downscaler,video_track_selector(backed byprobe_media_tracks),file_extractor/directory_extractor, andaudio_file_normalization/audio_directory_normalization—all honoring atomic writes, cancellation cleanup, and multi-strategy FFmpeg fallbacks. - 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. - 10-Locale Parity & Startup Window Lifecycle:
Synchronized localization keys across_template.yamland all 10 language files, and hardened Flet startup geometry initialization on Linux desktops.
FallByte v2.0.1
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.pyinto dedicated modular components (ui/components/language_dialog.pyandui/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
InterruptedErrorcancellation 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.AppImagebuilds (#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.pyfor all 10 locales, added batch failure isolation and logging regression tests, and updateddocs/ARCHITECTURE.md(442 passing tests).
Summary of Technical Changes
-
Per-File Batch Fault Tolerance:
BatchRunnernow 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. -
10-Language YAML Locale Suite & Windows Detection:
Added 7 schema-validated.yamlfiles underresources/locales/with full placeholder parity against_template.yamland registered their corresponding Windows locale names and primaryLANGIDcodes inui/i18n.py. -
Workspace-Scoped Modal Overlay & Theme Preview Tiles:
Replaced full-pageAlertDialoglists with a workspace-scoped overlay stack inui/app_layout.pybacked by dedicated 2-column grid cards for Dark/Light theme swatches and native language tiles.
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.
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.
FallByte v1.2.0
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
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):
Downloadfallbyte_1.1.0_amd64.deband install via terminal withsudo apt install ./fallbyte_1.1.0_amd64.debor double-click to open in Software Center. -
Fedora / RHEL / openSUSE (
.rpm):
Downloadfallbyte_1.1.0_x86_64.rpmand install withsudo dnf install ./fallbyte_1.1.0_x86_64.rpm. -
Arch Linux / Universal Portable (
.AppImage):
Downloadfallbyte_1.1.0_x86_64.AppImage, grant execution permission withchmod +x fallbyte_1.1.0_x86_64.AppImage, and run directly.
FallByte v1.0.0 — Initial Release
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):
Downloadfallbyte_1.0.0_amd64.deband install via terminal withsudo apt install ./fallbyte_1.0.0_amd64.debor double-click to open in Software Center. -
Fedora / RHEL / openSUSE (
.rpm):
Downloadfallbyte_1.0.0_x86_64.rpmand install withsudo dnf install ./fallbyte_1.0.0_x86_64.rpm. -
Arch Linux / Universal Portable (
.AppImage):
Downloadfallbyte_1.0.0_x86_64.AppImage, grant execution permission withchmod +x fallbyte_1.0.0_x86_64.AppImage, and run directly.
Windows
- Windows 10 / 11 (Portable
.zip):
DownloadFallByte-v1.0.0-windows-x64.zip, extract the folder, and executemain.exe(orFallByte.exe).
(Note: Dedicated Windows setup/installer coming soon!)