pat-e/encoding-scripts
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

again: another Readme update

Browse Source
This commit is contained in:
pat-e
2025-07-17 12:28:19 +02:00
parent ea9aa045c8
commit c4a80e4818
1 changed files with 1 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
README_Anime Audio Encoder.md
View File

@@ -7,15 +7,10 @@
## Features ## Features
* **Advanced Video Encoding:** Uses a robust VapourSynth-based pipeline with `av1an` and SVT-AV1 for efficient, high-quality AV1 video encoding. * **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. * **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. * **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. * **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/`. * **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. * **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 ## Requirements
@@ -23,31 +18,20 @@
The following command-line tools must be installed and available in your system's PATH: The following command-line tools must be installed and available in your system's PATH:
* `ffmpeg` * `ffmpeg`
* `ffprobe` * `ffprobe`
* `mkvmerge` * `mkvmerge`
* `mkvpropedit` * `mkvpropedit`
* `sox` * `sox`
* `opusenc` * `opusenc`
* `mediainfo` * `mediainfo`
* `av1an` * `av1an`
* `HandBrakeCLI` * `HandBrakeCLI`
## Usage ## Usage
1. Place your `.mkv` files in the same directory as the script. 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`. 2. Make the script executable (on Linux/macOS) by running `chmod +x anime_audio_encoder.py`.
3. Execute the script from your terminal: 3. Execute the script from your terminal:
```bash ```bash
./anime_audio_encoder.py ./anime_audio_encoder.py
``` ```
@@ -55,9 +39,6 @@ The following command-line tools must be installed and available in your system'
### Optional Arguments ### 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. * `--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 ```bash
./anime_audio_encoder.py --no-downmix ./anime_audio_encoder.py --no-downmix
``` ```
@@ -65,15 +46,11 @@ The following command-line tools must be installed and available in your system'
## Output ## Output
* Processed files are moved to the `completed/` directory. * Processed files are moved to the `completed/` directory.
* Original files are moved to the `original/` directory. * Original files are moved to the `original/` directory.
* Per-file logs are saved in the `conv_logs/` directory. * Per-file logs are saved in the `conv_logs/` directory.
## Notes ## Notes
* The script is primarily designed for **Linux/macOS** environments. * 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 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
* The entire process, especially scene detection and AV1 encoding, can be very time-consuming and CPU-intensive.