===============================================
IndexTTS2 Batch Generation GUI - Setup Guide
快速部署指南 | クイックセットアップガイド | Guía de Configuración Rápida
===============================================

TABLE OF CONTENTS | 目录 | 目次 | Índice
----------------------------------------
1. English
2. 中文（简体）
3. 日本語
4. Español


===============================================
1. ENGLISH
===============================================

Welcome! Thank you for cloning this project.

QUICK START (3 Steps)
---------------------

Step 1: Requirements
  - Python 3.10 or higher
  - Internet connection (for first-time setup)
  - ~8GB disk space

Step 2: Run Setup
  Simply double-click this file:
  
  setup_new_location.bat
  
  The script will automatically:
  ✓ Create virtual environment
  ✓ Install all dependencies from requirements.txt
  ✓ Verify required files
  ✓ Complete in 3-5 minutes

Step 3: Launch Application
  Double-click to start:
  
  run_tts_gui.bat
  
  Or for hidden launch:
  start_gui.pyw


WHAT THIS TOOL DOES
-------------------
A GUI application for IndexTTS2 text-to-speech model with:
- Batch and single sentence processing
- 8 emotion control sliders
- Voice preservation settings
- Multi-GPU parallel processing
- Multilingual interface (CN/EN/JP/ES)
- CPU mode support
- Real-time progress monitoring


TROUBLESHOOTING
---------------
Problem: Setup script fails
Solution: 1. Ensure Python 3.10+ is installed
         2. Check internet connection
         3. Run as administrator

Problem: GUI won't start
Solution: 1. Check if venv folder was created
         2. Manually run: venv\Scripts\python.exe tts_batch_gui.py
         3. Check console for error messages

Problem: GPU not detected
Solution: Use CPU mode in GUI settings, or install CUDA drivers

For detailed guide, see: QUICK_SETUP_GUIDE.txt


SUPPORT
-------
- Documentation: Check docs/ folder
- License: See LICENSE*.txt files
- Issues: Report on project repository


===============================================
2. 中文（简体）
===============================================

欢迎！感谢您克隆此项目。

快速开始（3步）
--------------

步骤 1：系统要求
  - Python 3.10 或更高版本
  - 互联网连接（首次安装时需要）
  - 约 8GB 磁盘空间

步骤 2：运行安装脚本
  双击运行此文件：
  
  setup_new_location.bat
  
  脚本将自动：
  ✓ 创建虚拟环境
  ✓ 从 requirements.txt 安装所有依赖
  ✓ 验证必需文件
  ✓ 3-5分钟内完成

步骤 3：启动应用程序
  双击启动：
  
  run_tts_gui.bat
  
  或隐藏启动：
  start_gui.pyw


此工具的功能
-----------
IndexTTS2 文本转语音模型的图形界面应用，具有：
- 批量和单句处理模式
- 8个情绪控制滑块
- 声纹保护设置
- 多GPU并行处理
- 多语言界面（中英日西）
- CPU模式支持
- 实时进度监控


故障排除
-------
问题：安装脚本失败
解决：1. 确保已安装 Python 3.10+
     2. 检查网络连接
     3. 以管理员身份运行

问题：GUI无法启动
解决：1. 检查是否创建了 venv 文件夹
     2. 手动运行：venv\Scripts\python.exe tts_batch_gui.py
     3. 查看控制台错误信息

问题：GPU未检测到
解决：在GUI设置中使用CPU模式，或安装CUDA驱动

详细指南请查看：QUICK_SETUP_GUIDE.txt


技术支持
-------
- 文档：查看 docs/ 目录
- 许可证：查看 LICENSE*.txt 文件
- 问题反馈：在项目仓库提交 Issue


===============================================
3. 日本語
===============================================

ようこそ！このプロジェクトをクローンしていただきありがとうございます。

クイックスタート（3ステップ）
----------------------------

ステップ1：システム要件
  - Python 3.10 以上
  - インターネット接続（初回セットアップ時）
  - 約8GBのディスク容量

ステップ2：セットアップスクリプトの実行
  このファイルをダブルクリック：
  
  setup_new_location.bat
  
  スクリプトが自動的に：
  ✓ 仮想環境を作成
  ✓ requirements.txt からすべての依存関係をインストール
  ✓ 必要なファイルを検証
  ✓ 3〜5分で完了

ステップ3：アプリケーションの起動
  ダブルクリックで起動：
  
  run_tts_gui.bat
  
  または非表示起動：
  start_gui.pyw


このツールの機能
---------------
IndexTTS2 テキスト読み上げモデルのGUIアプリケーション：
- バッチおよび単一文処理モード
- 8つの感情制御スライダー
- 声紋保護設定
- マルチGPU並列処理
- 多言語インターフェース（中英日西）
- CPUモードサポート
- リアルタイム進捗監視


トラブルシューティング
---------------------
問題：セットアップスクリプトが失敗する
解決：1. Python 3.10+ がインストールされているか確認
     2. インターネット接続を確認
     3. 管理者として実行

問題：GUIが起動しない
解決：1. venv フォルダが作成されているか確認
     2. 手動実行：venv\Scripts\python.exe tts_batch_gui.py
     3. コンソールのエラーメッセージを確認

問題：GPUが検出されない
解決：GUI設定でCPUモードを使用するか、CUDAドライバをインストール

詳細ガイド：QUICK_SETUP_GUIDE.txt を参照


サポート
-------
- ドキュメント：docs/ フォルダを確認
- ライセンス：LICENSE*.txt ファイルを参照
- 問題報告：プロジェクトリポジトリでIssueを作成


===============================================
4. ESPAÑOL
===============================================

¡Bienvenido! Gracias por clonar este proyecto.

INICIO RÁPIDO (3 Pasos)
-----------------------

Paso 1: Requisitos
  - Python 3.10 o superior
  - Conexión a Internet (para la primera configuración)
  - ~8GB de espacio en disco

Paso 2: Ejecutar Configuración
  Simplemente haga doble clic en este archivo:
  
  setup_new_location.bat
  
  El script automáticamente:
  ✓ Creará el entorno virtual
  ✓ Instalará todas las dependencias desde requirements.txt
  ✓ Verificará los archivos requeridos
  ✓ Se completará en 3-5 minutos

Paso 3: Iniciar Aplicación
  Haga doble clic para iniciar:
  
  run_tts_gui.bat
  
  O para inicio oculto:
  start_gui.pyw


QUÉ HACE ESTA HERRAMIENTA
-------------------------
Aplicación GUI para el modelo de texto a voz IndexTTS2 con:
- Procesamiento por lotes y oraciones individuales
- 8 controles deslizantes de emoción
- Configuración de preservación de voz
- Procesamiento paralelo multi-GPU
- Interfaz multilingüe (CN/EN/JP/ES)
- Soporte de modo CPU
- Monitoreo de progreso en tiempo real


SOLUCIÓN DE PROBLEMAS
---------------------
Problema: El script de configuración falla
Solución: 1. Asegúrese de que Python 3.10+ esté instalado
         2. Verifique la conexión a Internet
         3. Ejecute como administrador

Problema: La GUI no inicia
Solución: 1. Verifique si se creó la carpeta venv
         2. Ejecute manualmente: venv\Scripts\python.exe tts_batch_gui.py
         3. Revise mensajes de error en la consola

Problema: GPU no detectada
Solución: Use el modo CPU en la configuración de la GUI o instale controladores CUDA

Para guía detallada, consulte: QUICK_SETUP_GUIDE.txt


SOPORTE
-------
- Documentación: Consulte la carpeta docs/
- Licencia: Vea archivos LICENSE*.txt
- Problemas: Reporte en el repositorio del proyecto


===============================================
ADDITIONAL RESOURCES | 其他资源 | その他のリソース | Recursos Adicionales
===============================================

English:
  - QUICK_SETUP_GUIDE.txt (Detailed setup guide)
  - DEPLOYMENT_CHECKLIST.txt (Complete checklist)
  - LICENSE_EN.txt (License terms)

中文：
  - LICENSE_ZH.txt（许可证条款）
  - config.json（配置文件）

日本語：
  - LICENSE_JA.txt（ライセンス条項）

Español:
  - LICENSE_ES.txt (Términos de licencia)

All Languages:
  - LICENSE_README.txt (License explanation)
  - i18n.json (UI translations)


===============================================
IMPORTANT NOTES | 重要说明 | 重要な注意事項 | Notas Importantes
===============================================

English:
  - First setup requires internet to download dependencies (~500MB-1GB)
  - Virtual environment (venv/) will be created automatically
  - Model files (checkpoints/) are ~5-10GB
  - GPU is optional, CPU mode available

中文：
  - 首次安装需要联网下载依赖包（约500MB-1GB）
  - 虚拟环境（venv/）将自动创建
  - 模型文件（checkpoints/）约5-10GB
  - GPU可选，支持CPU模式

日本語：
  - 初回セットアップには依存関係のダウンロードのためインターネットが必要（約500MB-1GB）
  - 仮想環境（venv/）が自動的に作成されます
  - モデルファイル（checkpoints/）は約5-10GB
  - GPUはオプション、CPUモードも利用可能

Español:
  - La primera configuración requiere internet para descargar dependencias (~500MB-1GB)
  - El entorno virtual (venv/) se creará automáticamente
  - Los archivos del modelo (checkpoints/) son ~5-10GB
  - GPU es opcional, modo CPU disponible


===============================================
COMMAND REFERENCE | 命令参考 | コマンドリファレンス | Referencia de Comandos
===============================================

Setup | 安装 | セットアップ | Configuración:
  setup_new_location.bat

Launch GUI | 启动GUI | GUI起動 | Iniciar GUI:
  run_tts_gui.bat
  start_gui.pyw (hidden | 隐藏 | 非表示 | oculto)

Check Python | 检查Python | Python確認 | Verificar Python:
  python --version

Reinstall Dependencies | 重装依赖 | 依存関係再インストール | Reinstalar Dependencias:
  venv\Scripts\activate
  pip install -r requirements.txt


===============================================
PROJECT STRUCTURE | 项目结构 | プロジェクト構造 | Estructura del Proyecto
===============================================

Essential Files | 核心文件 | 必須ファイル | Archivos Esenciales:

  tts_batch_gui.py          - Main application | 主程序 | メインアプリ | Aplicación principal
  batch_generate.py         - Batch processor | 批量处理 | バッチ処理 | Procesador por lotes
  indextts/                 - Core code | 核心代码 | コアコード | Código principal
  checkpoints/              - AI models | 模型文件 | AIモデル | Modelos IA
  assets/                   - Resources | 资源文件 | リソース | Recursos
  i18n.json                 - Translations | 翻译文件 | 翻訳 | Traducciones
  config.json               - Settings | 配置 | 設定 | Configuración
  requirements.txt          - Dependencies | 依赖列表 | 依存関係 | Dependencias

Generated Folders | 生成的文件夹 | 生成フォルダ | Carpetas Generadas:

  venv/                     - Virtual environment (auto-created)
                             虚拟环境（自动创建）
                             仮想環境（自動作成）
                             Entorno virtual (auto-creado)

  outputs/                  - Generated audio | 生成音频 | 生成音声 | Audio generado
  batch_outputs/            - Batch results | 批量结果 | バッチ結果 | Resultados por lotes
  single_outputs/           - Single results | 单句结果 | 単一結果 | Resultados individuales


===============================================
THANK YOU | 感谢 | ありがとうございます | Gracias
===============================================

English:
  Thank you for using IndexTTS2 Batch Generation GUI!
  If you find this tool useful, please consider:
  - Starring the repository
  - Sharing with others
  - Contributing improvements
  - Supporting the developer

中文：
  感谢您使用 IndexTTS2 批量生成 GUI 工具！
  如果您觉得此工具有用，请考虑：
  - 给仓库点星
  - 分享给其他人
  - 贡献改进
  - 支持开发者

日本語：
  IndexTTS2 バッチ生成 GUI ツールをご利用いただきありがとうございます！
  このツールが役立つと思われる場合は、以下をご検討ください：
  - リポジトリにスターを付ける
  - 他の人と共有する
  - 改善に貢献する
  - 開発者をサポートする

Español:
  ¡Gracias por usar la Herramienta GUI de Generación por Lotes IndexTTS2!
  Si encuentra esta herramienta útil, por favor considere:
  - Dar una estrella al repositorio
  - Compartir con otros
  - Contribuir mejoras
  - Apoyar al desarrollador


===============================================
VERSION INFORMATION | 版本信息 | バージョン情報 | Información de Versión
===============================================

Document Version: 1.0
Last Updated: 2025-11-22
Compatible with: IndexTTS2 GUI v1.0+

For latest version, check the project repository.
获取最新版本，请查看项目仓库。
最新バージョンについては、プロジェクトリポジトリを確認してください。
Para la última versión, consulte el repositorio del proyecto.


===============================================
END OF GUIDE | 指南结束 | ガイド終了 | Fin de la Guía
===============================================

