# video-to-text-conversion

**Repository Path**: MakerLi/video-to-text-conversion

## Basic Information

- **Project Name**: video-to-text-conversion
- **Description**: 视频转文本：专注于将视频内容转化为文字的开源项目，适用于会议记录、字幕制作等多种场景，提升信息处理效率。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2025-07-11
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VideoTextPro

[English](README_en.md) | 简体中文

![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)
![Python](https://img.shields.io/badge/python-3.8--3.12-blue.svg)
![Platform](https://img.shields.io/badge/platform-windows--10--11-lightgrey.svg)

📝 一款专为抖音直播录制优化的字幕生成工具 | 支持 FLV 格式 | 批量处理 | 多种字幕格式 | 高效稳定

**关键词**: 抖音直播转文字, 直播录制字幕提取, 视频转文字, 语音识别, 字幕生成, ASR工具, 视频字幕提取, 音频转写, 语音转文字, 直播回放文字提取

> VideoTextPro 是一个专为抖音直播录制视频优化的文字转换工具，基于 [WEIFENG2333/AsrTools](https://github.com/WEIFENG2333/AsrTools) 开发。
> 特别适合处理直播回放、录制视频的文字提取和字幕生成。
> 感谢原作者 WEIFENG2333 提供的优秀项目基础。
> 
> 最后更新：2024-03-21

## 💡 主要用途

- 📹 抖音直播录制视频的文字转换
- 🎥 直播回放的字幕提取
- 📝 批量处理录播文件
- 🔄 支持多种字幕格式（SRT、ASS、TXT）
- ⚡ 高效率的批量处理能力

## 🔄 修改版新增功能

- 🔄 记忆功能：保存上次使用的目录和导出格式
- 🚀 自动执行：支持启动时自动开始处理任务
- 📂 目录优化：新增一键打开目录功能
- 🎯 状态优化：更清晰的文件处理状态显示
- ⚡ 效率提升：智能跳过已处理文件
- 📄 格式扩展：新增 ASS 字幕格式支持

## ✨ 功能特性

### 直播录制处理
- 🎥 优化支持 FLV 格式（抖音直播录制标准格式）
- 📁 自动扫描录播文件夹
- 🔄 批量处理录播文件
- ⏭️ 智能跳过已处理的录播
- 🚀 支持软件启动时自动处理新录制

### 字幕生成功能
- 📝 生成适合后期剪辑的字幕文件
- 🎬 支持多种字幕格式（SRT、ASS、TXT）
- ⚡ 多线程并发处理，提高效率
- 🔍 清晰的处理状态显示

## 🎯 使用方法

### 单文件处理
- 支持拖拽或选择单个直播录制文件
- 实时显示处理进度和状态
- 右键菜单支持快速操作

### 批量处理
- 支持选择整个直播录制目录进行批量处理
- 自动记忆上次的工作目录
- 一键打开工作目录
- 智能检测已处理文件
- 可选择是否跳过已处理文件
- 支持软件启动时自动执行任务

## 🛠️ 安装指南

### 环境要求
- Python 3.8-3.12
- Windows 10/11
- FFmpeg（用于视频转换，[安装教程](https://www.wikihow.com/Install-FFmpeg-on-Windows)）

### 1. 快速开始（推荐）

1. 下载打包好的[发布版本](https://github.com/WEIFENG2333/AsrTools/releases)
2. 解压到任意目录
3. 运行方式：
   - 双击 `asr_gui.exe` 启动程序
   - 或在命令行中运行 `asr_gui.exe`

### 2. 开发者安装

1. **确保环境满足要求**
   - Python 3.8-3.12
   - FFmpeg
   - Windows 10/11

2. **克隆仓库**
    ```bash
    git clone https://gitee.com/changanreson/video-to-text-conversion.git
    cd video-to-text-conversion
    ```

3. **安装依赖**
    ```bash
    pip install -r requirements.txt
    ```

4. **启动程序**
    ```bash
    # 方式1：直接运行
    python asr_gui.py

    # 方式2：使用 pythonw（无命令行窗口）
    pythonw asr_gui.py
    ```

### 3. 快捷方式创建（可选）

1. 找到 `asr_gui.exe`（打包版）或 `asr_gui.py`（源码版）
2. 右键 → 发送到 → 桌面快捷方式
3. 双击快捷方式即可启动程序

### 4. 开机自启动（可选）

1. 按 `Win + R` 打开运行
2. 输入 `shell:startup` 打开启动文件夹
3. 将程序快捷方式复制到启动文件夹

## 📝 状态说明

- 未处理：灰色
- 处理中：橙色
- 已处理：绿色
- 已存在：蓝色
- 错误：红色

## 📌 注意事项

- 确保系统已安装 FFmpeg
- 优化支持 FLV 格式（抖音直播录制标准格式）
- 支持的视频格式：flv, mp4, avi, mov, ts, mkv, wmv, webm, rmvb
- 支持的音频格式：mp3, wav, ogg, flac, aac, m4a, wma
- 处理视频文件时会自动转换为音频进行处理
- 建议定期备份重要的字幕文件

## 🔄 更新日志

### v1.1.0
- 优化 FLV 格式支持
- 新增 ASS 格式支持
- 新增自动执行功能
- 新增一键打开目录功能
- 优化文件状态显示
- 记忆上次使用的导出格式

## 📬 联系与支持

### 原项目
- 原作者：[WEIFENG2333](https://github.com/WEIFENG2333)
- 原项目：[AsrTools](https://github.com/WEIFENG2333/AsrTools)

### 修改版
- 问题反馈：[提交问题](https://gitee.com/changanreson/video-to-text-conversion/issues)

---

感谢使用 VideoTextPro！希望这款工具能为您的直播录制处理带来便利。😊