---
title: "WhatsApp Chat Viewer: 내보낸 채팅을 깔끔한 HTML로 변환하는 도구"
published: 2026-02-08T23:27:03.000Z
canonical: https://jeff.news/article/575
---
# WhatsApp Chat Viewer: 내보낸 채팅을 깔끔한 HTML로 변환하는 도구

WhatsApp에서 내보낸 채팅 텍스트와 미디어 파일을 이미지, 동영상, 오디오가 임베드된 브라우저용 HTML 페이지로 변환하는 오픈소스 도구. OpenAI API를 활용한 오디오 전사, 이미지/PDF 자동 설명 생성, LLM 기반 전사 교정 등 AI 후처리 기능을 제공함.

## 개요

- WhatsApp의 내장 채팅 내보내기 기능은 일반 텍스트 파일과 미디어 폴더만 생성하기 때문에 읽기 불편함
- 이 도구는 내보낸 채팅을 이미지, 동영상, 오디오 플레이어, PDF가 임베드된 깔끔한 HTML 페이지로 변환해 줌
- 긴 대화의 검색과 자동 처리에 특히 유용함

## 주요 기능

- OpenAI의 음성-텍스트 API를 활용한 오디오 자동 전사 기능이 포함됨
- 이미지 및 PDF에 대한 자동 설명 생성이 지원되며, 스캔된 PDF도 비전 모델을 통해 처리됨
- 각 메시지에 해시 기반 고유 앵커 ID가 부여되어 특정 메시지로 직접 링크할 수 있음

## AI 기반 후처리

- LLM을 활용한 전사 교정 기능이 제공되며, 대화 맥락을 반영하여 정확도를 높임
- 인터랙티브 모드에서는 각 교정을 직접 검토하고 수락, 거부 또는 수정할 수 있음
- 전사 및 설명 결과는 캐싱되어 재실행 시 이미 처리된 파일은 건너뜀

## 기술 구성

- 기본 STT 모델은 `gpt-4o-mini-transcribe`, LLM 교정은 `gpt-4o-mini`, PDF/이미지 설명은 `gpt-4o`가 사용됨
- `--me` 플래그로 본인 메시지를 우측 정렬하여 가독성을 높일 수 있음
- 샘플 디렉터리가 포함되어 있어 AI 생성 이미지와 오디오 파일로 바로 테스트해 볼 수 있음

## 핵심 포인트

- WhatsApp 내보내기 파일을 미디어가 임베드된 HTML로 변환함
- OpenAI API를 통한 오디오 전사 및 LLM 기반 교정 기능 포함
- 이미지와 PDF에 대한 자동 설명 생성이 지원되며 스캔 PDF도 비전 처리됨
- 메시지별 고유 퍼머링크로 특정 메시지에 직접 링크 가능
- 전사 및 설명 결과가 캐싱되어 재실행 시 중복 처리를 방지함

## 인사이트

단순한 채팅 뷰어를 넘어 OpenAI의 다양한 모델을 활용해 비정형 미디어 데이터를 검색 가능한 텍스트로 변환하는 접근이 인상적임. 개인 데이터 아카이빙과 AI 후처리를 결합한 실용적인 사례로, 유사한 메시징 앱 데이터 처리에도 확장 적용될 수 있음.