离线浏览您的 WhatsApp 导出数据。您的数据保留在设备上。
-00A67E?style=flat-square&logo=openai&logoColor=white){kind=icon}
English • Português • Español • Français • Deutsch • Italiano • Nederlands • 日本語 • 中文 • Русский
拖放从 WhatsApp 导出的 .zip 文件，浏览您的消息、照片和语音备忘录。适用于大型聊天（已测试超过 10,000 条消息）。
语音消息可以使用通过 WebGPU 在浏览器中运行的 Whisper 进行转录。无需服务器，无需 API 密钥。
截图
| 开始屏幕 | 聊天视图 |
|---|---|
 |
 |
| 聊天选项 | 视角模式 |
|---|---|
 |
 |
| 书签 | 统计 |
|---|---|
 |
 |
| 语音转录 | 媒体库 |
|---|---|
 |
 |
| 下载所选 | 前往日期 |
|---|---|
 |
 |
为您的平台下载应用:
- 从最新版本下载 WhatsApp-Backup-Reader-Setup-{version}.exe
- 运行安装程序并按照设置向导操作
- 应用程序将在有新版本时自动更新
- Apple Silicon (M1/M2/M3): 下载 WhatsApp-Backup-Reader-{version}-arm64.dmg
- Intel: 下载 WhatsApp-Backup-Reader-{version}.dmg
- 打开DMG文件并将应用拖到应用程序文件夹
- 首次启动时,右键点击应用并选择"打开"以绕过Gatekeeper
- Debian/Ubuntu: 下载 whats-reader_{version}_amd64.deb 或 whats-reader_{version}_arm64.deb
sudo dpkg -i whats-reader_{version}_amd64.deb - Fedora/RHEL: 下载 whats-reader-{version}.x86_64.rpm 或 whats-reader-{version}.aarch64.rpm
sudo rpm -i whats-reader-{version}.x86_64.rpm - 其他发行版 (Arch等): 下载 WhatsApp-Backup-Reader-{version}.AppImage
chmod +x WhatsApp-Backup-Reader-{version}.AppImage ./WhatsApp-Backup-Reader-{version}.AppImage
或使用Web版本: 访问 rodrigogs.github.io/whats-reader - 无需安装!
- 语音转录：使用 Whisper 转录音频（本地运行，支持 12 种以上语言）
- 搜索：在消息和转录中进行全文搜索
- 书签：保存带有笔记的消息，导出/导入为 JSON
- 视角模式：以任何参与者的身份查看聊天
- 统计：消息计数、活动图表、时间线
- 暗黑模式：跟随系统或手动切换（保存偏好）
- 多语言界面：英语、葡萄牙语、西班牙语、法语、德语、意大利语、荷兰语、日语、中文、俄语
- 桌面应用：通过 Electron 支持 macOS、Windows、Linux
您需要安装 Node.js（版本 18 或更高）。从 nodejs.org 下载并运行安装程序。
检查是否已安装:
node --version- 克隆或下载此项目
- 在项目文件夹中打开终端
- 运行以下命令:
npm install
npm run dev- 在浏览器中打开 localhost:5173
- 将您的 WhatsApp
.zip文件拖放到页面中
如果您更喜欢独立应用而不是使用浏览器:
npm run electron:dev # 在开发模式下运行
npm run electron:build # 为您的操作系统创建安装程序特定平台构建:
npm run electron:build:mac # macOS (dmg, zip)
npm run electron:build:win # Windows (nsis, portable)
npm run electron:build:linux # Linux (deb, rpm, AppImage)首先，您需要在手机上从 WhatsApp 导出聊天。这会创建一个包含您的消息和媒体的 .zip 文件。
- 打开 WhatsApp 并进入任何聊天
- 点击屏幕顶部的联系人或群组名称
- 向下滚动并点击导出聊天
- 选择包含媒体以包含照片、视频和语音消息
- 保存文件（您可以使用 AirDrop 发送到 Mac、保存到文件或通过电子邮件发送给自己）
- 打开 WhatsApp 并进入任何聊天
- 点击右上角的三个点 ⋮
- 点击更多 → 导出聊天
- 选择包含媒体
- 将
.zip文件保存或共享到您的计算机
- 大型聊天可能需要几分钟才能导出
- 文件名类似于
WhatsApp Chat with John.zip - 个人聊天和群聊都可以使用
此应用程序以隐私为最高优先级设计。您的 WhatsApp 数据永远不会离开您的设备。
- 100% 离线：应用程序完全无需互联网即可工作。无服务器、无云、无数据传输。
- 本地处理：所有解析、搜索和分析都在您的浏览器或 Electron 应用中进行。
- 本地 AI：语音转录使用通过 WebGPU 本地运行的 Whisper。不会向任何服务器或 API 发送音频。
- 无追踪：零分析、遥测或第三方脚本。无 Google Analytics、无 cookies。
- 无需账户：无需注册、无需登录、不收集个人数据。
- 开源：整个代码库在 AGPL-3.0 许可证下公开。任何人都可以审计它。
不要只相信我们。自己验证:
-
阅读源代码
浏览 GitHub 仓库。主要逻辑在src/lib/和src/routes/中。 -
检查网络请求
打开浏览器的 DevTools（F12）→ Network 选项卡 → 使用应用。您将看到零外部请求（如果使用 Web 版本，初始页面加载除外）。 -
离线测试
断开互联网连接，然后使用应用。一切都能正常工作，因为不需要连接。 -
从源代码构建
克隆仓库并自己构建:git clone https://github.com/rodrigogs/whats-reader.git cd whats-reader npm install npm run build -
审计 Electron 应用
桌面应用使用相同的 Web 代码。检查electron/main.cjs和electron/preload.cjs。它们只处理窗口管理和文件对话框。
| 命令 | 说明 |
|---|---|
npm run dev |
在 localhost:5173 启动开发服务器 |
npm run build |
构建生产版本 |
npm run preview |
预览生产构建 |
npm run check |
使用 svelte-check 进行类型检查 |
npm run check:watch |
在监视模式下进行类型检查 |
npm run lint |
使用 Biome 进行代码检查 |
npm run lint:fix |
自动修复代码检查问题 |
npm run format |
使用 Biome 格式化代码 |
npm run electron |
构建并运行 Electron 应用 |
npm run electron:dev |
在开发模式下运行 Electron |
npm run electron:build |
构建 Electron 安装程序 |
npm run electron:build:mac |
为 macOS 构建 |
npm run electron:build:win |
为 Windows 构建 |
npm run electron:build:linux |
为 Linux 构建 |
npm run machine-translate |
使用 inlang 自动翻译 |
翻译文件位于 messages/。添加新语言:
- 将
messages/en.json复制到messages/{locale}.json - 翻译字符串
- 将语言代码添加到
project.inlang/settings.json
- SvelteKit + Svelte 5 - 框架
- Tailwind CSS 4 - 样式
- Electron - 桌面应用
- Transformers.js - 用于转录的 Whisper AI
- JSZip - ZIP 文件处理
- Paraglide JS - 国际化
发现错误或有想法？在 GitHub 上提交问题。
想要贡献代码？Fork 仓库，进行更改，然后提交拉取请求。
在 examples/chats/ 中有示例聊天文件可用于测试。
AGPL-3.0。您可以自由使用、修改和分发此软件。如果您修改它并作为服务运行或分发它，则必须在相同许可证下共享您的源代码。