Skip to content

About

Fast, private, and local-first media compression. Drop the weight, keep the quality.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

114 Commits

Folders and files

Repository files navigation

FallByte

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.


About the Project

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.


Key Features

  • 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).

Images

  • 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, and HEIF, and convert to JPEG, PNG, WEBP, BMP, TIFF, GIF, ICO, PPM, or PDF. 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.

Videos

  • Conversion: From MP4, MKV, WEBM, MOV, AVI, WMV, M4V, FLV, TS, 3GP, and MPG into MP4, MKV, WEBM, MOV, AVI, or WMV. 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.

Audio

  • Conversion: From MP3, M4A, AAC, OGG, OPUS, FLAC, WAV, WMA, and AIFF into MP3, M4A, OPUS, OGG, FLAC, or WAV. 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.

OS Support & Download

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 encoders

Development

git clone https://github.com/brunothinker/FallByte.git
cd FallByte
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python main.py

To run the tests:

pip install -r tests/requirements-dev.txt
pytest

Logs 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.


Stack

  • 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

Security

Found a vulnerability? Please follow SECURITY.md instead of opening a public issue.

License & Third-Party Notices

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.

About

Fast, private, and local-first media compression. Drop the weight, keep the quality.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages