azureshores/bitcrusher — explained in plain English
Analysis updated 2026-05-18
Shrink a video file to fit under a Discord or other platform upload limit.
Compress a folder of files automatically using a watch-and-process pipeline.
Keep one important moment of a video sharper while compressing the rest more.
Compare visual quality between your chosen codec and AV1 before exporting.
| azureshores/bitcrusher | deepexperience/hypereyes | egocs-400k/dataset | |
|---|---|---|---|
| Stars | 45 | 45 | 45 |
| Language | Python | Python | Python |
| Setup difficulty | easy | hard | moderate |
| Complexity | 2/5 | 5/5 | 4/5 |
| Audience | general | researcher | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires Python 3.10+, ffmpeg and ffprobe are downloaded automatically on first run.
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.
BitCrusher compresses video, audio, images and PDFs down to a specific target file size, like Discord's upload limits, without going over.
Mainly Python. The stack also includes Python, ffmpeg, AV1.
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.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.