deblack

remove black frames from a video. Simple python file to create ffmpeg commands

Usage

Download:

pip install git+https://github.com/FarisHijazi/deblack

And then just run the bellow command, and the output should be saved as myvideo.out.mp4

deblack path/to/myvideo.mp4

If the above doesn't work, then check the prerequisites section for more detailed installation instructions.

prerequisites

<details> <summary>Click to expand</summary>

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

</details>

History

<details> <summary>Click to expand</summary>

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

</details>

Development

<details> <summary>Click to expand</summary>

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

</details>

(github actions available)