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: Every tool works on one file or on a folder (subfolders included), keeping the original folder 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 English, Portuguese, and Spanish interfaces (auto-detected from your system).
- Compression: Quality control and PNG palette quantization 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, 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.
- 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.
- HEVC 10-bit / HDR: 10-bit pixel formats (
yuv420p10le) are preserved during HEVC (libx265) work.
- 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.
| 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.