# epub_reader

**Repository Path**: dashan12/epub_reader

## Basic Information

- **Project Name**: epub_reader
- **Description**: 一个简单的 EPUB 文件查看和朗读工具，支持文本转语音功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EPUB 阅读器

一个简单的 EPUB 文件查看和朗读工具，支持文本转语音功能。

## 功能特性

- ✅ 解析 EPUB 文件（支持 EPUB 2.0/3.0）
- ✅ 显示章节内容
- ✅ 章节导航（上一章/下一章/跳转）
- ✅ 文本转语音朗读
- ✅ 语音设置（语速、音量、语音选择）
- ✅ 朗读控制（开始/暂停/继续/停止）
- ✅ 全文搜索
- ✅ 自动保存阅读进度
- ✅ 恢复上次阅读位置

## 技术栈

- **EPUB 解析**: `ebooklib` + `BeautifulSoup4`
- **TTS 引擎**: `pyttsx3`（Windows 系统自带语音）
- **Web 界面**: `Streamlit`

## 安装步骤

### 1. 安装 Python 依赖

```powershell
cd e:\newworkspace\epub_reader
pip install -r requirements.txt
```

### 2. 运行程序

```powershell
streamlit run app.py
```

程序会自动在浏览器中打开，默认地址：`http://localhost:8501`

## 使用说明

### 上传 EPUB 文件

1. 在左侧侧边栏点击"上传 EPUB 文件"
2. 选择要阅读的 EPUB 文件
3. 程序会自动解析并显示书籍信息

### 阅读功能

- **章节导航**: 使用"上一章"/"下一章"按钮，或通过下拉菜单跳转到指定章节
- **搜索**: 在搜索框输入关键词，点击"搜索"按钮查找内容

### 朗读功能

1. 点击"▶️ 开始朗读"开始朗读当前章节
2. 点击"⏸️ 暂停/继续"暂停或恢复朗读
3. 点击"⏹️ 停止"停止朗读

#### 语音设置

展开"⚙️ 语音设置"可以调整：
- **语速**: 50-500（默认 150）
- **音量**: 0.0-1.0（默认 1.0）
- **语音**: 选择系统可用的语音（推荐选择中文语音）

### 阅读进度

- 程序会自动保存阅读进度
- 下次打开同一文件时，会自动跳转到上次阅读的章节

## 文件结构

```
epub_reader/
├── app.py              # 主程序（Streamlit 界面）
├── epub_parser.py      # EPUB 解析模块
├── tts_reader.py       # TTS 朗读模块
├── requirements.txt    # Python 依赖
├── README.md          # 说明文档
├── temp/              # 临时文件目录
└── progress.json      # 阅读进度文件
```

## 注意事项

1. **语音支持**: Windows 系统需要安装中文语音包才能正常朗读中文内容
2. **EPUB 格式**: 仅支持标准的 EPUB 2.0/3.0 格式
3. **浏览器兼容**: 推荐使用 Chrome、Edge 或 Firefox 浏览器
4. **文件大小**: 大型 EPUB 文件可能需要较长的加载时间

## 常见问题

### Q: 朗读没有声音怎么办？

A: 检查以下几点：
1. 确认系统音量已打开
2. 在"语音设置"中选择中文语音
3. 检查系统是否安装了语音包

### Q: 如何安装中文语音包？

A: Windows 10/11 默认已包含中文语音，如果没有，可以：
1. 打开"设置" → "时间和语言" → "语音"
2. 点击"添加语音"
3. 选择"中文（简体）"并安装

### Q: EPUB 文件无法解析？

A: 确认文件格式是否正确：
1. 文件扩展名必须是 `.epub`
2. 文件没有被损坏
3. 尝试用其他 EPUB 阅读器打开确认文件正常

### Q: 如何修改端口？

A: 运行时指定端口：
```powershell
streamlit run app.py --server.port 8080
```

## 许可证

MIT License

## 作者

Created with ❤️ by AI Assistant