git404hub

what is bitcrusher fr?

azureshores/bitcrusher — explained in plain English

Analysis updated 2026-05-18

45PythonAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

BitCrusher compresses video, audio, images and PDFs down to a specific target file size, like Discord's upload limits, without going over.

vibe map

mindmap
  root((BitCrusher))
    What it does
      Compress to target file size
      Codec race vs AV1
      Quality aware compression
    Tech stack
      Python
      ffmpeg
      AV1 and VMAF
    Use cases
      Fit Discord upload limits
      Batch folder compression
      Highlight key video moments
    Audience
      Content creators
      Casual users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Shrink a video file to fit under a Discord or other platform upload limit.

VIBE 2

Compress a folder of files automatically using a watch-and-process pipeline.

VIBE 3

Keep one important moment of a video sharper while compressing the rest more.

VIBE 4

Compare visual quality between your chosen codec and AV1 before exporting.

what's the stack?

PythonffmpegAV1VMAF

how it stacks up fr

azureshores/bitcrusherdeepexperience/hypereyesegocs-400k/dataset
Stars454545
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/55/54/5
Audiencegeneralresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3.10+, ffmpeg and ffprobe are downloaded automatically on first run.

You can use and modify this freely, but if you distribute it or a modified version, you must also share the source code under the same license.

in plain english

BitCrusher shrinks video, audio, image, and PDF files down to a specific target size, without going over it. This is useful for places like Discord that limit how large an uploaded file can be, so instead of guessing at settings, you just tell it the file and the size you want, such as 10 megabytes, and it handles the rest. Under the hood, it tests your requested video format against a newer format called AV1 and measures the actual visual quality of each using a standard called VMAF, then picks whichever one looks better for the same file size. It also applies extra processing steps, like reducing noise or blocky artifacts, but only keeps them if they actually improve the result, rather than applying them automatically every time. There is a mode to keep one specific moment of a video looking sharper than the rest, useful for a clip everyone is going to focus on. Beyond single files, it can watch a folder and automatically compress anything dropped into it, send a message to a Discord webhook when done, and remembers past compression jobs to make smarter choices on new files over time. The tool includes both a desktop application with a visual interface and a command line version for people who prefer typing commands or writing scripts. The author includes a benchmark table showing real compression results across different types of source video, including a concert video shot in low light that was compressed to about an eighth of its original size while still looking good throughout, including its worst individual moment, not just on average. To run it you need Python 3.10 or newer installed, and the tool will automatically download the video processing programs ffmpeg and ffprobe the first time you run it if they are not already present. It works on Windows, macOS, and Linux, and is released under the GNU General Public License version 3.

prompts (copy fr)

prompt 1
Show me the command to compress clip.mp4 down to 8MB using BitCrusher.
prompt 2
Explain how BitCrusher picks between AV1 and my requested video codec.
prompt 3
Help me set up BitCrusher's folder watcher with a Discord webhook.
prompt 4
Walk me through installing Python 3.10 and running BitCrusher for the first time.

Frequently asked questions

what is bitcrusher fr?

BitCrusher compresses video, audio, images and PDFs down to a specific target file size, like Discord's upload limits, without going over.

What language is bitcrusher written in?

Mainly Python. The stack also includes Python, ffmpeg, AV1.

What license does bitcrusher use?

You can use and modify this freely, but if you distribute it or a modified version, you must also share the source code under the same license.

How hard is bitcrusher to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bitcrusher for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.