From a71a07e2d20d34c6e41878727136106534dc4ef3 Mon Sep 17 00:00:00 2001 From: pat-e Date: Sun, 20 Jul 2025 10:05:20 +0200 Subject: [PATCH] updated readme and move of "crop-detect" --- README.md | 21 ++++++++++----------- cropdetect.py => old/cropdetect.py | 0 2 files changed, 10 insertions(+), 11 deletions(-) rename cropdetect.py => old/cropdetect.py (100%) diff --git a/README.md b/README.md index 5ff5e82..31a6ba1 100644 --- a/README.md +++ b/README.md @@ -16,31 +16,30 @@ Ensure the following command-line tools are installed and available in your syst The scripts are designed to be run in sequence. They create and use local directories (`cuts`, `segments`, `temp`) to store intermediate files. -### 1. (Optional) Detect Crop -If your video has black bars, you can use `cropdetect.py` to find the correct crop values. - -```bash -python cropdetect.py "path/to/your/video.mkv" -``` - -### 2. Cut Video into Scenes +### 1. Cut Video into Scenes Use [`scene_cutter.py`](scene_cutter.py) to analyze the video, detect scene changes, and split the source into lossless segments in the `cuts/` directory. ```bash python scene_cutter.py "path/to/your/video.mkv" ``` -### 3. Encode Segments +If your video has black bars, you can use the `--autocrop` flag to automatically detect and apply the correct crop values during this process. + +```bash +python scene_cutter.py "path/to/your/video.mkv" --autocrop +``` + +### 2. Encode Segments Use [`static_encoder.py`](static_encoder.py) to encode all segments from the `cuts/` directory with a single, fixed CRF value. Encoded files will be placed in the `segments/` directory. ```bash python static_encoder.py --crf 27 ``` -### 4. Mux Final Video +### 3. Mux Final Video Use [`segment_muxer.py`](segment_muxer.py) to combine all the encoded `.mkv` files from the `segments/` directory into a single output file. ```bash python segment_muxer.py --cleanup ``` -Using the `--cleanup` flag will automatically remove the `cuts/` and `segments/` directories \ No newline at end of file +Using the `--cleanup` flag will automatically remove the `cuts/` and `segments/` directories upon successful completion of the muxing process. \ No newline at end of file diff --git a/cropdetect.py b/old/cropdetect.py similarity index 100% rename from cropdetect.py rename to old/cropdetect.py