Python3

You need to have python 3 installed in the command line

FFmpeg

You need to have ffmpeg installed somehow, there are many ways to download it, one way is to download the binary (.exe) and put it in the same directory (make sure it's called ffmpeg.exe) https://ffmpeg.org/download.html

# windows (run this in powershell)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
choco install -y ffmpeg

# linux ubuntu
sudo apt install -y ffmpeg

# mac
brew install ffmpeg

This project originally started in as a Gist here.

This is a combination from multiple solutions found in the bellow 2 links:

• https://video.stackexchange.com/a/16571/37220
• https://superuser.com/a/1498811/739491

helpful resources

• https://video.stackexchange.com/questions/16564/how-to-trim-out-black-frames-with-ffmpeg-on-windows#new-answer?newreg=d534934be5774bd1938b535cd76608cd
• https://github.com/kkroening/ffmpeg-python/issues/184#issuecomment-493847192

Create test video

python test/gen_bw_video.py --outpath test/bw.mp4  # create test video
python deblack/deblack.py test/bw.mp4  # run deblack on test video

Add pre-commit hooks

this will format files before commiting

pip install pre-commit
pre-commit install