# Video2ASCII

**Repository Path**: kamik/video2ascii

## Basic Information

- **Project Name**: Video2ASCII
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video2ASCII

Video2ASCII 是一款高性能的桌面应用程序，可将视频和图像转换为令人惊叹的字符画（ASCII Art）。它基于 Python、PySide6 并且采用了现代 Fluent UI 设计原则，提供流畅而强大的用户体验，并内置了独立的批处理中心。

## 特色功能

- **媒体转字符画**：将视频和图片转换为 ASCII 字符画，支持自定义参数调整。
- **批量处理中心**：高性能多核批处理功能，支持独立的参数控制和自定义输出目录。
- **终端播放导出**：支持将视频导出为终端可播放的 Shell 脚本（包含完整的 ANSI 颜色代码支持）。
- **现代 UI/UX**：基于 PySide6 和 QFluentWidgets 的美学设计，支持平滑动画和动态主题切换。
- **高性能架构**：利用多线程及多进程并行处理技术，高效处理大型媒体文件，保障 UI 响应流畅。
- **多语言支持**：内置多语言，支持自由切换。

## 系统要求

请确保已安装 Python 3.8+。项目使用了以下核心依赖：
- `PySide6 >= 6.5`
- `PySide6-FluentWidgets >= 1.5`
- `opencv-python >= 4.8`
- `Pillow >= 10.0`
- `numpy >= 1.24`
- `moviepy >= 1.0.3`

## 安装与运行

1. 克隆或下载本仓库代码。
2. 使用 pip 安装必要的依赖包：
   ```bash
   pip install -r requirements.txt
   ```

## 使用方法

运行 `main.py` 启动应用程序：

```bash
python main.py
```

## 技术原理

Video2ASCII 使用 OpenCV 从视频中逐帧提取图像，利用 NumPy 和 Pillow 进行调整与处理，并将像素亮度和颜色映射到相应的 ASCII 字符。应用程序采用了多进程架构和 UI 节流机制，确保在进行密集计算和转换时保持最大性能和系统的极速响应。