{"id":16975648,"url":"https://github.com/farishijazi/deblack","last_synced_at":"2025-08-04T01:42:38.492Z","repository":{"id":136138489,"uuid":"553697390","full_name":"FarisHijazi/deblack","owner":"FarisHijazi","description":"remove black frames from a video. Simple python file to create ffmpeg commands. Originally started in a stackexchange question (https://superuser.com/a/1697654/739491)","archived":false,"fork":false,"pushed_at":"2024-11-04T14:12:33.000Z","size":26,"stargazers_count":23,"open_issues_count":5,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T07:41:34.902Z","etag":null,"topics":["automation","ffmpeg","ffmpeg-script","python","script","video-editing","video-editor"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FarisHijazi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-18T16:10:42.000Z","updated_at":"2024-11-05T07:54:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"ddd9f79f-c97c-440a-8b2f-6ada71b06d09","html_url":"https://github.com/FarisHijazi/deblack","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FarisHijazi/deblack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FarisHijazi%2Fdeblack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FarisHijazi%2Fdeblack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FarisHijazi%2Fdeblack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FarisHijazi%2Fdeblack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FarisHijazi","download_url":"https://codeload.github.com/FarisHijazi/deblack/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FarisHijazi%2Fdeblack/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268638819,"owners_count":24282637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-03T02:00:12.545Z","response_time":2577,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","ffmpeg","ffmpeg-script","python","script","video-editing","video-editor"],"created_at":"2024-10-14T01:23:25.526Z","updated_at":"2025-08-04T01:42:38.435Z","avatar_url":"https://github.com/FarisHijazi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# deblack\n\nremove black frames from a video. Simple python file to create ffmpeg commands\n\n## Usage\n\nDownload:\n\n```sh\npip install git+https://github.com/FarisHijazi/deblack\n```\n\nAnd then just run the bellow command, and the output should be saved as `myvideo.out.mp4`\n\n```\ndeblack path/to/myvideo.mp4\n```\n\n\nIf the above doesn't work, then check the [prerequisites](#prerequisites) section for more detailed installation instructions.\n\n## prerequisites\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Python3\n\nYou need to have python 3 installed in the command line\n\n### FFmpeg\n\nYou 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)\nhttps://ffmpeg.org/download.html\n\n\n```sh\n# windows (run this in powershell)\nSet-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'))\nchoco install -y ffmpeg\n\n# linux ubuntu\nsudo apt install -y ffmpeg\n\n# mac\nbrew install ffmpeg\n```\n\u003c/details\u003e\n\n## History\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\nThis project originally started in as a Gist [here](https://gist.github.com/FarisHijazi/eff7a7979440faa84a63657e085ec504).\n\nThis is a combination from multiple solutions found in the bellow 2 links:\n- https://video.stackexchange.com/a/16571/37220\n- https://superuser.com/a/1498811/739491\n\nhelpful resources\n- https://video.stackexchange.com/questions/16564/how-to-trim-out-black-frames-with-ffmpeg-on-windows#new-answer?newreg=d534934be5774bd1938b535cd76608cd\n- https://github.com/kkroening/ffmpeg-python/issues/184#issuecomment-493847192\n\n\u003c/details\u003e\n\n## Development\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n### Create test video\n\n```sh\npython test/gen_bw_video.py --outpath test/bw.mp4  # create test video\npython deblack/deblack.py test/bw.mp4  # run deblack on test video\n```\n\n### Add pre-commit hooks\n\nthis will format files before commiting\n\n```sh\npip install pre-commit\npre-commit install\n```\n\n\u003c/details\u003e\n\n(github actions available) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarishijazi%2Fdeblack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarishijazi%2Fdeblack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarishijazi%2Fdeblack/lists"}