rodrigogs/whats-reader
rodrigogs/whats-reader has 275 GitHub stars and 29 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-14 19:06 UTC. Last push 2026-10-14.
What you can do
- Date-based organization with calendar navigation
- Bulk select and download as ZIP
- Lightbox preview with navigation back to original message
- Auto-update: Desktop app automatically checks and installs updates (Electron only)
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- Recopilando historial
- in 15 days
- Recopilando historial
- in 1 month
- Recopilando historial
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
Browse WhatsApp chat exports offline with AI-powered voice transcription. Privacy-first desktop/web app with bookmarks, search, and statistics. Built with SvelteKit and Electron.
SeguridadREADME.es.md
OriginalLector de Respaldo de WhatsApp
Navega tus exportaciones de WhatsApp sin conexión. Tus datos permanecen en tu dispositivo.
English • Português • Español • Français • Deutsch • Italiano • Nederlands • 日本語 • 中文 • Русский
Características • Inicio Rápido • Guía de Exportación • Privacidad • Contribuir
¿Qué hace?
Arrastra un archivo .zip exportado de WhatsApp y navega por tus mensajes, fotos y notas de voz. Funciona con chats grandes (probado con más de 10k mensajes).
La Galería de Medios te ofrece una vista visual de todas las fotos, vídeos y archivos de audio organizados por fecha. Selecciona varios elementos y descárgalos como archivo ZIP, o haz clic en cualquier medio para verlo en pantalla completa y saltar al mensaje original.
Los mensajes de voz pueden ser transcritos usando Whisper, que se ejecuta en tu navegador vía WebGPU. Sin servidor, sin clave API necesaria.
Capturas de Pantalla
| Pantalla de Inicio | Vista de Chat |
|---|---|
![]() |
![]() |
| Opciones de Chat | Modo Perspectiva |
|---|---|
![]() |
![]() |
| Marcadores | Estadísticas |
|---|---|
![]() |
![]() |
| Transcripción de Voz | Galería de Medios |
|---|---|
![]() |
![]() |
| Descargar seleccionados | Ir a la fecha |
|---|---|
![]() |
![]() |
Descargar
Descarga la aplicación para tu plataforma:
Windows
- Descarga WhatsApp-Backup-Reader-Setup-{version}.exe de la última versión
- Ejecuta el instalador y sigue el asistente de configuración
- La app se actualizará automáticamente cuando haya nuevas versiones
macOS
- Apple Silicon (M1/M2/M3): Descarga WhatsApp-Backup-Reader-{version}-arm64.dmg
- Intel: Descarga WhatsApp-Backup-Reader-{version}.dmg
- Abre el archivo DMG y arrastra la app a Aplicaciones
- En el primer inicio, haz clic derecho en la app y selecciona "Abrir" para pasar Gatekeeper
Linux
- Debian/Ubuntu: Descarga whats-reader_{version}_amd64.deb o whats-reader_{version}_arm64.deb
sudo dpkg -i whats-reader_{version}_amd64.deb - Fedora/RHEL: Descarga whats-reader-{version}.x86_64.rpm o whats-reader-{version}.aarch64.rpm
sudo rpm -i whats-reader-{version}.x86_64.rpm - Otras distros (Arch, etc.): Descarga WhatsApp-Backup-Reader-{version}.AppImage
chmod +x WhatsApp-Backup-Reader-{version}.AppImage ./WhatsApp-Backup-Reader-{version}.AppImage
O usa la versión web: Visita rodrigogs.github.io/whats-reader - ¡sin instalación!
Características
- Galería de Medios: Navega por todas las fotos, vídeos y audio en una cuadrícula de miniaturas
- Organización por fecha con navegación de calendario
- Selección masiva y descarga como ZIP
- Vista previa en lightbox con navegación al mensaje original
- Transcripción de voz: Transcribe audio con Whisper (se ejecuta localmente, más de 12 idiomas)
- Búsqueda: Búsqueda de texto completo en mensajes y transcripciones
- Marcadores: Guarda mensajes con notas, exporta/importa como JSON
- Modo perspectiva: Ve el chat como cualquier participante
- Estadísticas: Conteo de mensajes, gráficos de actividad, línea de tiempo
- Modo oscuro: Sigue el sistema o cambia manualmente (preferencia guardada)
- Interfaz multilingüe: Inglés, Portugués, Español, Francés, Alemán, Italiano, Holandés, Japonés, Chino, Ruso
- Aplicación de escritorio: macOS, Windows, Linux vía Electron
Inicio Rápido
Requisitos Previos
Necesitas Node.js instalado (versión 18 o posterior). Descárgalo desde nodejs.org y ejecuta el instalador.
Para verificar si lo tienes:
node --version
Ejecutar la aplicación
- Clona o descarga este proyecto
- Abre una terminal en la carpeta del proyecto
- Ejecuta estos comandos:
npm install
npm run dev
- Abre localhost:5173 en tu navegador
- Arrastra tu archivo
.zipde WhatsApp a la página
Aplicación de escritorio (opcional)
Si prefieres una aplicación independiente en lugar de usar tu navegador:
npm run electron:dev # ejecutar en modo desarrollo
npm run electron:build # crear instalador para tu SO
Compilaciones específicas por plataforma:
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)
Cómo Exportar desde WhatsApp
Primero, necesitas exportar un chat desde WhatsApp en tu teléfono. Esto crea un archivo .zip que contiene tus mensajes y medios.
iPhone
- Abre WhatsApp y ve a cualquier chat
- Toca el nombre del contacto o grupo en la parte superior de la pantalla
- Desplázate hacia abajo y toca Exportar Chat
- Elige Adjuntar Medios para incluir fotos, videos y mensajes de voz
- Guarda el archivo (puedes usar AirDrop a tu Mac, guardar en Archivos o enviarlo por correo a ti mismo)
Android
- Abre WhatsApp y ve a cualquier chat
- Toca los tres puntos ⋮ en la esquina superior derecha
- Toca Más → Exportar chat
- Elige Incluir medios
- Guarda o comparte el archivo
.zipa tu computadora
Consejos
- Los chats grandes pueden tardar unos minutos en exportarse
- El archivo se llamará algo como
WhatsApp Chat with John.zip - Funcionan tanto chats individuales como grupales
Privacidad y Seguridad
Esta aplicación está diseñada con la privacidad como máxima prioridad. Tus datos de WhatsApp nunca abandonan tu dispositivo.
Por qué es seguro
- 100% Sin Conexión: La aplicación funciona completamente sin internet. Sin servidores, sin nube, sin transmisión de datos.
- Procesamiento Local: Todo el análisis, búsqueda y análisis ocurre en tu navegador o aplicación Electron.
- IA Local: La transcripción de voz usa Whisper ejecutándose localmente vía WebGPU. No se envía audio a ningún servidor o API.
- Sin Rastreo: Cero analíticas, telemetría o scripts de terceros. Sin Google Analytics, sin cookies.
- Sin cuenta requerida: Sin registro, sin inicio de sesión, sin recopilación de datos personales.
- Código Abierto: El código completo es público bajo AGPL-3.0. Cualquiera puede auditarlo.
Cómo verificar
No solo confíes en nosotros. Veríficalo tú mismo:
Lee el código fuente
Navega por el repositorio de GitHub. La lógica principal está ensrc/lib/ysrc/routes/.Verifica las solicitudes de red
Abre las DevTools del navegador (F12) → pestaña Network → Usa la aplicación. Verás cero solicitudes externas (excepto la carga inicial de la página si usas la versión web).Prueba sin conexión
Desconéctate de internet, luego usa la aplicación. Todo funciona porque nada requiere conexión.Compila desde el código fuente
Clona el repositorio y compílalo tú mismo:git clone https://github.com/rodrigogs/whats-reader.git cd whats-reader npm install npm run buildAudita la aplicación Electron
La aplicación de escritorio usa el mismo código web. Revisaelectron/main.cjsyelectron/preload.cjs. Solo manejan la gestión de ventanas y diálogos de archivos.
Desarrollo
Scripts
| Comando | Descripción |
|---|---|
npm run dev |
Iniciar servidor de desarrollo en localhost:5173 |
npm run build |
Compilar para producción |
npm run preview |
Vista previa de compilación de producción |
npm run check |
Verificación de tipos con svelte-check |
npm run check:watch |
Verificación de tipos en modo watch |
npm run lint |
Linter con Biome |
npm run lint:fix |
Corregir automáticamente problemas de lint |
npm run format |
Formatear código con Biome |
npm run electron |
Compilar y ejecutar aplicación Electron |
npm run electron:dev |
Ejecutar Electron en modo desarrollo |
npm run electron:build |
Compilar instalador Electron |
npm run electron:build:mac |
Compilar para macOS |
npm run electron:build:win |
Compilar para Windows |
npm run electron:build:linux |
Compilar para Linux |
npm run machine-translate |
Auto-traducir con inlang |
Agregar traducciones
Los archivos de traducción están en messages/. Para agregar un nuevo idioma:
- Copia
messages/en.jsonamessages/{locale}.json - Traduce las cadenas
- Agrega el locale a
project.inlang/settings.json
Construido con
- SvelteKit + Svelte 5 - Framework
- Tailwind CSS 4 - Estilos
- Electron - Aplicación de escritorio
- Transformers.js - IA Whisper para transcripción
- JSZip - Manejo de archivos ZIP
- Paraglide JS - Internacionalización
Contribuir
¿Encontraste un error o tienes una idea? Abre un issue en GitHub.
¿Quieres contribuir con código? Haz fork del repositorio, realiza tus cambios y abre un pull request.
Hay archivos de chat de ejemplo en examples/chats/ que puedes usar para pruebas.
Historial de estrellas
Licencia
AGPL-3.0. Puedes usar, modificar y distribuir este software libremente. Si lo modificas y lo ejecutas como servicio o lo distribuyes, debes compartir tu código fuente bajo la misma licencia.









