again: another Readme update

This commit is contained in:
2025-07-17 12:28:19 +02:00
parent ea9aa045c8
commit c4a80e4818

View File

@@ -7,15 +7,10 @@
## Features
* **Advanced Video Encoding:** Uses a robust VapourSynth-based pipeline with `av1an` and SVT-AV1 for efficient, high-quality AV1 video encoding.
* **VFR Handling:** Automatically detects Variable Frame Rate (VFR) sources using `mediainfo` and converts them to Constant Frame Rate (CFR) with `HandBrakeCLI` before encoding, ensuring broader playback compatibility.
* **Detailed Logging:** Creates a separate, detailed log file for each processed MKV in the `conv_logs/` directory, capturing the full terminal output for easy review.
* **Sophisticated Audio Processing:** Converts common audio formats to normalized Opus files. It provides an option to downmix surround sound to stereo or preserve the original channel layout.
* **File Organization:** Keeps your workspace tidy by automatically moving original files to `original/` and completed encodes to `completed/`.
* **Resumable & Efficient:** The script processes files one by one and uses `av1an`'s resume feature, making it easy to continue an encoding batch if it's interrupted.
## Requirements
@@ -23,31 +18,20 @@
The following command-line tools must be installed and available in your system's PATH:
* `ffmpeg`
* `ffprobe`
* `mkvmerge`
* `mkvpropedit`
* `sox`
* `opusenc`
* `mediainfo`
* `av1an`
* `HandBrakeCLI`
## Usage
1. Place your `.mkv` files in the same directory as the script.
2. Make the script executable (on Linux/macOS) by running `chmod +x anime_audio_encoder.py`.
3. Execute the script from your terminal:
```bash
./anime_audio_encoder.py
```
@@ -55,9 +39,6 @@ The following command-line tools must be installed and available in your system'
### Optional Arguments
* `--no-downmix`: By default, the script downmixes surround sound audio (e.g., 5.1) to stereo. Use this flag to preserve the original audio channel layout.
Example:
```bash
./anime_audio_encoder.py --no-downmix
```
@@ -65,15 +46,11 @@ The following command-line tools must be installed and available in your system'
## Output
* Processed files are moved to the `completed/` directory.
* Original files are moved to the `original/` directory.
* Per-file logs are saved in the `conv_logs/` directory.
## Notes
* The script is primarily designed for **Linux/macOS** environments.
* The script will check if a file can be decoded by `ffmpeg` before processing and will skip corrupted or unsupported files.
* The entire process, especially scene detection and AV1 encoding, can be very time-consuming and CPU-intensive.
* The entire process, especially scene detection and AV1 encoding, can be very time-consuming and