Drop the weight. Keep the quality.
FallByte is a fast, lightweight, and local-first media optimization suite for images, videos, and audio, designed to reclaim disk space without compromising quality or privacy.
Most media optimization tools require uploading sensitive files to cloud servers or dealing with ad-heavy web interfaces. FallByte runs 100% locally on your machine, processing media offline with speed, safety, and precision.
- Local-First & Private: Your files never leave your system. No server uploads, no telemetry, no internet required.
- Embedded Media Engine (FFmpeg): Video and audio processing powered by a bundled static FFmpeg binary, so no external installation is required.
- Single file or whole folder: Tools work on a single file or recursively across folders, preserving the original directory structure in the output.
- Safe by design: Existing files are never overwritten (outputs get a unique name or a new session folder), writes are atomic, and cancelling a batch cleans up only what that session created.
- Themes & languages: 5 dark and 5 light themes, with 10 supported interface languages (auto-detected from your system).
- Compression: Quality control, PNG palette quantization, and optional metadata stripping (EXIF, GPS, XMP, ICC) while strictly keeping the original format (JPEG, PNG, WEBP, TIFF). Formats that cannot be safely re-encoded (BMP, PPM, GIF, ICO, HEIC/HEIF) and animated PNGs are copied untouched. If the result is not smaller (and metadata stripping is not enabled), the original is kept.
- Conversion: Read
JPEG,PNG,WEBP,BMP,TIFF,GIF,PPM,ICO,HEIC, andHEIF, and convert toJPEG,PNG,WEBP,BMP,TIFF,GIF,ICO,PPM, orPDF. Transparency is blended into a background color of your choice for formats without alpha. EXIF rotation, ICC profiles, animations, and multi-page TIFF are handled when the target allows it. - 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 dimensions (bounding box with aspect ratio preserved) or by percentage scale (1%–100%), with an optional safeguard to prevent upscaling smaller images and automatic EXIF orientation handling. - Metadata Removal: Strip sensitive EXIF, GPS coordinates, XMP, ICC profiles, PNG textual chunks (
tEXt/iTXt), and GIF comments across single files or batch directories while baking EXIF orientation into pixel data and preserving animation frames (HEIC/HEIFsources are exported as cleanPNGfiles).
- Conversion: From
MP4,MKV,WEBM,MOV,AVI,WMV,M4V,FLV,TS,3GP, andMPGintoMP4,MKV,WEBM,MOV,AVI, orWMV. FFmpeg strategies go from lossless remux, to partial re-encode, to full re-encode, to a "rescue" mode for damaged files. - Compression: Quality scale mapped to CRF/qscale, keeping the original container. HEVC sources stay HEVC.
- Resolution Downscaling: Downscale high-resolution videos (
MP4,MKV,WEBM,MOV,AVI,WMV,M4V,FLV,TS,3GP,MPG) to 1080p (Full HD), 720p (HD), or 480p (SD) across single files or entire folders. Preserves original aspect ratios across both landscape and portrait orientations with even pixel dimensions, and automatically copies videos already at or below the target resolution without upscaling or re-encoding. - Audio & Subtitle Track Selection: Inspect embedded audio and subtitle streams inside a video file (
MP4,MKV,WEBM,MOV,AVI,WMV,M4V,FLV,TS,3GP,MPG) with language, codec, channel layout, andDefault/Forcedtags, and export a clean copy keeping only the selected tracks via lossless stream remuxing (-c copy) without re-encoding. - HEVC 10-bit / HDR: When conversion or downscaling to MP4, MOV, or MKV requires re-encoding a 10-bit HEVC source, FallByte uses
libx265to keep 10-bit video (yuv420p10le), with 8-bit H.264 as a fallback. MP4 and MOV use thehvc1tag for HEVC playback compatibility.
- Conversion: From
MP3,M4A,AAC,OGG,OPUS,FLAC,WAV,WMA, andAIFFintoMP3,M4A,OPUS,OGG,FLAC, orWAV. Embedded cover art is stripped and only the main audio track is converted. - Compression: Quality scale mapped to bitrate for lossy formats (
MP3,M4A,AAC,OGG,OPUS). Lossless or legacy formats (FLAC,WAV,WMA,AIFF) are copied untouched, and the original is kept if re-encoding would not make the file smaller. - Video-to-Audio Extraction: Extract audio tracks from video files (
MP4,MKV,WEBM,MOV,AVI,WMV,M4V,FLV,TS,3GP,MPG) directly intoMP3,M4A,OPUS,OGG,FLAC, orWAVfor a single video or an entire folder, safely skipping silent video files. - Volume Normalization (EBU R128): Batch-normalize perceived loudness across folders of audio files (
MP3,M4A,AAC,OGG,OPUS,FLAC,WAV) using FFmpeg'sloudnormfilter with target presets for Music / Streaming (-14 LUFS), Podcast / Voice (-16 LUFS), and Broadcast / Standard (-23 LUFS), preserving original formats and sample rates.
| Operating System | Package | Status |
|---|---|---|
| Linux (Ubuntu / Debian / Mint) | Native .deb |
Supported |
| Linux (Fedora / RHEL / openSUSE) | Native .rpm |
Supported |
| Linux (Arch / Universal Linux) | Portable .AppImage |
Supported |
| Windows (x64) | Portable .zip |
Supported |
Get FallByte for your OS (Official Download Page)
Prefer raw build artifacts? Browse all compiled files on the GitHub Releases Page.
You can verify an installation with:
fallbyte --version
fallbyte --smoke-test # checks dependencies, bundled FFmpeg and image encodersgit clone https://github.com/brunothinker/FallByte.git
cd FallByte
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python main.pyTo run the tests:
pip install -r tests/requirements-dev.txt
pytestLogs are written to ~/.config/fallbyte/fallbyte.log on Linux and %APPDATA%\FallByte\fallbyte.log on Windows (run with --debug for verbose output).
Want to contribute? Read CONTRIBUTING.md and ARCHITECTURE.md first.
- Language: Python
- UI Framework: Flet (Flutter for Python)
- Image Processing: Pillow, pillow-heif
- Media Engine: FFmpeg (static binaries, video and audio)
- Localization: YAML locale files
Found a vulnerability? Please follow SECURITY.md instead of opening a public issue.
FallByte is licensed under the GNU General Public License v3.0 (GPLv3).
This project bundles third-party binaries (such as FFmpeg static builds) and depends on open-source libraries (Flet, Pillow, pillow-heif, PyYAML). For licensing terms, source locations, and binary build configurations, see THIRD_PARTY_NOTICES.md.