release: project version to v1.5.2

update readme about the new features

Signed-off-by: Jack Lau <[email protected]>

Author: JackLau1222

.augment-guidelines

@@ -18,9 +18,10 @@ OpenConverter is a multimedia conversion application built on **FFmpeg**, **Qt**
 4. Image compression with format/quality control
 5. Audio extraction from video files
 6. Video cutting with precise time selection
-7. Runtime switching of transcoding cores (FFmpeg API, FFTool, BMF)
-8. Smooth progress tracking with accurate time estimation
-9. Both GUI and CLI interfaces
+7. **Batch processing** with queue management for multiple files
+8. Runtime switching of transcoding cores (FFmpeg API, FFTool, BMF)
+9. Smooth progress tracking with accurate time estimation
+10. Both GUI and CLI interfaces
 
 ## Project Structure
 
@@ -93,6 +94,17 @@ OpenConverter/
    - RemuxPage: Change container format without re-encoding
    - TranscodePage: Full transcoding with codec/quality control
 
+7. **Batch Processing System** (`src/builder/`)
+   - BatchQueue: Manages queue of batch items for processing
+   - BatchItem: Represents a single file in the batch queue
+   - BatchQueueDialog: UI for monitoring batch processing progress
+   - BatchFileDialog: Dialog for selecting multiple files with visual filter tags
+   - BatchInputWidget: Widget for managing multiple input files
+   - BatchOutputWidget: Widget for configuring batch output directory and suffix
+   - BatchModeHelper: Coordinates between single file and batch modes
+   - FileSelectorWidget: Unified widget supporting both single and batch file selection
+   - FilterTagWidget: Visual tag-based widget for user-editable file filters
+
 ### Design Patterns
 
 - **Observer Pattern**: ProcessParameter notifies observers (UI) of progress updates
@@ -259,6 +271,17 @@ make -j4
 5. Add to `Converter::set_transcoder()` switch statement
 6. Update CMakeLists.txt with conditional compilation flags
 
+### Code Quality Tools
+
+**Whitespace Cleanup:**
+```bash
+./tool/fix_whitespace.sh
+```
+- Removes trailing whitespace from all lines
+- Ensures exactly one newline at end of file
+- Processes all staged C++ files (.cpp, .h, .hpp, .cc, .cxx)
+- **Does NOT auto-stage** - you must manually review and add changes with `git add`
+
 ## Testing
 
 - Unit tests in `src/tests/`
@@ -368,6 +391,48 @@ player->Play();
 player->Seek(5000); // Seek to 5 seconds
 ```
 
+#### FileSelectorWidget
+- **Purpose**: Unified file selection widget supporting both single and batch modes
+- **Key Features**:
+  - Browse button for single file selection
+  - Batch button for multiple file selection
+  - Automatic mode switching
+  - Drag-and-drop support
+  - File filter management
+
+**Usage Example**:
+```cpp
+FileSelectorWidget *selector = new FileSelectorWidget(
+    tr("Input File"),
+    FileSelectorWidget::InputFile,
+    tr("Select a media file..."),
+    tr("Media Files (*.mp4 *.avi);;All Files (*.*)"),
+    tr("Select Media File"),
+    parent
+);
+connect(selector, &FileSelectorWidget::FileSelected, this, &Page::OnFileSelected);
+connect(selector, &FileSelectorWidget::BatchFilesSelected, this, &Page::OnBatchFilesSelected);
+```
+
+#### FilterTagWidget
+- **Purpose**: Visual tag-based widget for managing file filters
+- **Key Features**:
+  - Visual tags for each file extension (e.g., `.mp4`, `.avi`)
+  - Individual delete button (×) for each tag
+  - Add button to add new extensions
+  - Auto-normalization of extensions (e.g., `mp4` → `*.mp4`)
+  - Duplicate prevention
+  - Horizontal scrolling for many tags
+
+**Usage Example**:
+```cpp
+FilterTagWidget *filterWidget = new FilterTagWidget(parent);
+filterWidget->SetFilter("*.mp4,*.avi,*.mkv");
+connect(filterWidget, &FilterTagWidget::FilterChanged, this, [](const QString &filter) {
+    qDebug() << "New filter:" << filter;
+});
+```
+
 ## Implementation Best Practices
 
 ### 1. Non-Blocking UI Operations

README.md

@@ -8,15 +8,16 @@ OpenConverter is software built on the [**FFmpeg**](https://ffmpeg.org/), [**Qt*
 
 The converter includes the following main features:
 
-1. Supports changing video codecs for encoding (e.g., libx264, libx265).
+1. Supports changing video/audio codecs for encoding (e.g., libx264, libx265, aac, ac3) with resolution scaling and pixel format conversion.
 2. Supports lossless multimedia conversion.
 3. Displays information about video and audio streams in multimedia files.
 4. Compresses images with format and quality control.
 5. Extracts audio from video files.
 6. Cuts video with built-in FFmpeg-based player and precise time selection.
-7. Shows smooth progress tracking and accurate remaining time while converting files.
-8. Allows runtime switching of transcoding cores (FFmpeg, FFTool, BMF).
-9. Provides both GUI and Command Line Interface (CLI) for flexible usage.
+7. **Batch processing with queue management for multiple files**.
+8. Shows smooth progress tracking and accurate remaining time while converting files.
+9. Allows runtime switching of transcoding cores (FFmpeg, FFTool, BMF).
+10. Provides both GUI and Command Line Interface (CLI) for flexible usage.
 
 This project is developed using the [Qt framework](./doc/Qt.md), the FFmpeg library, and the [BMF framework](https://github.com/BabitMF/bmf).
 
@@ -40,6 +41,12 @@ After running OpenConverter, you can see and use the following features:
 
 This converter allows users to easily change audio and video codecs. For example, you can choose to use the libx264 or libx265 encoder for higher compression rates and better video quality.
 
+Additionally supports:
+- **Resolution scaling** (e.g., 1920x1080 → 1280x720, 4K → 1080p)
+- **Pixel format conversion** (e.g., yuv420p, yuv444p, rgb24)
+- Bitrate control for both video and audio
+- Quality control with qscale parameter
+
 ### 2. Support for Lossless Multimedia Conversion
 
 The converter also supports lossless multimedia conversion. This means you can directly convert files from one format to another without re-encoding the original video and audio streams. This is very useful for quick file conversions.
@@ -69,38 +76,53 @@ Cut video segments with precision:
 - Accurate start/end time selection
 - Supports all FFmpeg-compatible formats
 
-### 7. Advanced Progress Tracking and Time Estimation
+### 7. Batch Processing
+
+Process multiple files efficiently:
+- **Visual file filter management** with tag-based interface
+- Add files individually or scan entire directories
+- Queue management with progress monitoring
+- Configurable output directory and file suffix
+- Support for transcode, extract audio, compress picture, and create GIF operations
+- Real-time progress tracking for each file in the queue
+
+### 8. Advanced Progress Tracking and Time Estimation
 
 During file conversion, the player provides:
 - Smooth progress updates with UI-friendly refresh rates
 - Accurate remaining time estimation using duration smoothing
 - Real-time progress percentage and duration tracking
 - Detailed console output for monitoring conversion status
 
-### 8. Runtime Switching of Transcoding Cores (FFmpeg, FFTool, BMF)
+### 9. Runtime Switching of Transcoding Cores (FFmpeg, FFTool, BMF)
 
 The software offers three different transcoding cores to choose from:
 - FFmpeg API-based core for direct library integration
 - FFTool core for command-line tool integration
 - BMF framework-based core for advanced processing
 You can also selectively compile these cores based on your needs.
 
-### 9. Command Line Interface (CLI) Support
+### 10. Command Line Interface (CLI) Support
 
 Usage in non-GUI mode:
 ```bash
-./OpenConverter [options] input_file output_file
-
+> ./OpenConverter
+Usage: ./OpenConverter [options] input_file output_file
 Options:
-  -t, --transcoder TYPE    Set transcoder type (FFMPEG, BMF, FFTOOL)
-  -v, --video-codec CODEC  Set video codec
+  --transcoder TYPE        Set transcoder type (FFMPEG, BMF, FFTOOL)
+  -v, --video-codec CODEC  Set video codec (could set copy)
   -q, --qscale QSCALE      Set qscale for video codec
-  -a, --audio-codec CODEC  Set audio codec
+  -a, --audio-codec CODEC  Set audio codec (could set copy)
   -b:v, --bitrate:video BITRATE    Set bitrate for video codec
   -b:a, --bitrate:audio BITRATE    Set bitrate for audio codec
   -pix_fmt PIX_FMT         Set pixel format for video
   -scale SCALE(w)x(h)      Set scale for video (width x height)
+  -ss START_TIME           Set start time for cutting (format: HH:MM:SS or seconds)
+  -to END_TIME             Set end time for cutting (format: HH:MM:SS or seconds)
+  -t DURATION              Set duration for cutting (format: HH:MM:SS or seconds)
   -h, --help               Show this help message
+
+Note: Use either -to or -t, not both. If both are specified, -to takes precedence.
 ```
 
 Example:

README_ZH.md

@@ -8,15 +8,16 @@ OpenConverter 是一个基于 **FFmpeg**源代码、**Qt**开源框架、**BMF
 
 这款转换器具有以下主要功能：
 
-1. 支持更改视频编解码器以进行编码（例如libx264，libx265）
+1. 支持更改音视频编解码器以进行编码（例如libx264，libx265，aac，ac3），支持分辨率缩放和像素格式转换
 2. 支持无编码转换多媒体。
 3. 支持显示多媒体文件中视频和音频流的信息。
 4. 支持图片压缩，可调整格式和质量。
 5. 支持从视频中提取音频。
 6. 支持视频剪切，内置FFmpeg播放器，精确时间选择。
-7. 支持平滑的进度跟踪和准确的剩余时间显示。
-8. 运行时切换转码内核（FFmpeg、FFTool、BMF）
-9. 提供图形界面和命令行界面（CLI）双重支持。
+7. **支持批量处理，队列管理多个文件。**
+8. 支持平滑的进度跟踪和准确的剩余时间显示。
+9. 运行时切换转码内核（FFmpeg、FFTool、BMF）
+10. 提供图形界面和命令行界面（CLI）双重支持。
 
 本项目使用[Qt框架](./doc/Qt.md)、FFmpeg库、[BMF框架](https://github.com/BabitMF/bmf)完成开发。
 
@@ -40,6 +41,12 @@ FFmpeg 开发教程可参考 [Learn FFmpeg the Hard Way](https://github.com/TSGU
 
 这款转换器允许用户轻松地更改音视频编解码器。例如，您可以选择使用libx264或libx265编码器，以获得更高的压缩率和更好的视频质量。
 
+此外还支持：
+- **分辨率缩放**（例如：1920x1080 → 1280x720，4K → 1080p）
+- **像素格式转换**（例如：yuv420p、yuv444p、rgb24）
+- 视频和音频的比特率控制
+- 使用qscale参数进行质量控制
+
 ### 2. 支持无编码转换多媒体。
 
 该转换器还支持无需编码即可转换多媒体文件。这意味着您可以在不改变原始视频和音频流的情况下，直接将文件从一种格式转换为另一种格式。这对于快速转换文件非常有用。
@@ -69,38 +76,53 @@ FFmpeg 开发教程可参考 [Learn FFmpeg the Hard Way](https://github.com/TSGU
 - 精确的开始/结束时间选择
 - 支持所有FFmpeg兼容格式
 
-### 7. 高级进度跟踪和时间估算
+### 7. 批量处理
+
+高效处理多个文件：
+- **可视化文件过滤器管理**，基于标签的界面
+- 单独添加文件或扫描整个目录
+- 队列管理，进度监控
+- 可配置输出目录和文件后缀
+- 支持转码、提取音频、压缩图片和创建GIF操作
+- 队列中每个文件的实时进度跟踪
+
+### 8. 高级进度跟踪和时间估算
 
 在转换文件时，该播放器提供：
 - 平滑的进度更新，具有UI友好的刷新率
 - 使用持续时间平滑的准确剩余时间估算
 - 实时进度百分比和持续时间跟踪
 - 详细的控制台输出，用于监控转换状态
 
-### 8. 运行时切换转码内核（FFmpeg、FFTool、BMF）
+### 9. 运行时切换转码内核（FFmpeg、FFTool、BMF）
 
 该软件提供三种不同的转码内核供选择：
 - 基于FFmpeg API的内核，用于直接库集成
 - FFTool内核，用于命令行工具集成
 - 基于BMF框架的内核，用于高级处理
 您还可以根据需求选择性编译这些内核。
 
-### 9. 命令行界面（CLI）支持
+### 10. 命令行界面（CLI）支持
 
 非图形界面模式使用方法：
 ```bash
-./OpenConverter [options] input_file output_file
-
+> ./OpenConverter
+Usage: ./OpenConverter [options] input_file output_file
 Options:
-  -t, --transcoder TYPE    Set transcoder type (FFMPEG, BMF, FFTOOL)
-  -v, --video-codec CODEC  Set video codec
+  --transcoder TYPE        Set transcoder type (FFMPEG, BMF, FFTOOL)
+  -v, --video-codec CODEC  Set video codec (could set copy)
   -q, --qscale QSCALE      Set qscale for video codec
-  -a, --audio-codec CODEC  Set audio codec
+  -a, --audio-codec CODEC  Set audio codec (could set copy)
   -b:v, --bitrate:video BITRATE    Set bitrate for video codec
   -b:a, --bitrate:audio BITRATE    Set bitrate for audio codec
   -pix_fmt PIX_FMT         Set pixel format for video
   -scale SCALE(w)x(h)      Set scale for video (width x height)
+  -ss START_TIME           Set start time for cutting (format: HH:MM:SS or seconds)
+  -to END_TIME             Set end time for cutting (format: HH:MM:SS or seconds)
+  -t DURATION              Set duration for cutting (format: HH:MM:SS or seconds)
   -h, --help               Show this help message
+
+Note: Use either -to or -t, not both. If both are specified, -to takes precedence.
 ```
 
 使用示例：

src/CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.10...3.24)
 
-project(OpenConverter VERSION 1.5.0 LANGUAGES CXX)
+project(OpenConverter VERSION 1.5.2 LANGUAGES CXX)
 
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)