Skip to content
Mbox Viewer

mboxShell

Mbox Viewer의 기반이 되는 무료 터미널 도구입니다. Linux, macOS, FreeBSD, Windows에서 셸로 바로 모든 크기의 MBOX 파일을 열고 검색하고 내보내세요.

최신 v0.7.1 무료 & 오픈소스 Rust로 작성 MIT
mboxshell
터미널에서 실행 중인 mboxShell로, 메시지 목록·폴더·읽기 창이 있는 MBOX 아카이브를 보여줍니다.

터미널에서 완결되는 MBOX 도구 모음

거대한 이메일 아카이브를 다루는 데 필요한 모든 것 — 읽기, 검색, 스레딩, 내보내기 — GUI도 클라우드도 없이.

모든 파일 크기

1 MB 버퍼의 스트리밍 파서가 50 GB가 넘는 Gmail Takeout 백업을 RAM 약 500 MB로 엽니다.

1초 미만 재열기

SHA-256로 검증되는 영구 이진 인덱스가 가장 큰 아카이브도 1초 이내에 다시 엽니다.

필드 기반 검색

from:, subject:, date:, body:, has:attachment, label:과 정확한 구문, 그리고 선택지를 묶는 OR(a OR b c는 (a OR b) AND c)로 TUI나 명령줄에서 필터링하세요.

Gmail 라벨과 Google 그룹스

X-Gmail-Labels를 감지해 탐색하고 필터링할 수 있는 가상 폴더로 만듭니다. Google Takeout 아카이브에서는 각 그룹스 사서함이 해당 그룹 이름으로 표시됩니다.

대화 스레딩

고전적인 JWZ 스레딩 알고리즘으로 관련 메시지를 대화로 묶고, 사서함에 Google의 대화 ID(X-GM-THRID)가 있으면 그것을 사용합니다.

어디든 내보내기

메시지를 EML, CSV, TXT, HTML로 저장하고 첨부 파일을 개별 또는 일괄로 추출하세요.

병합 및 중복 제거

여러 MBOX 파일을 하나로 합치고, 선택적 중복 제거로 같은 항목을 두 번 가져오지 않습니다.

완전한 터미널 UI

ratatui 기반 TUI로 세 가지 레이아웃 모드, vi 스타일 탐색, bash·zsh·fish·PowerShell·elvish 자동 완성을 제공합니다.

크로스플랫폼 & 이중 언어

런타임 의존성이 없는 약 5 MB 단일 바이너리입니다. Linux, macOS, FreeBSD, Windows에서 실행되며 영어/스페인어 인터페이스를 제공합니다.

새로운 기능

가장 최근 세 개의 릴리스입니다. 최신 버전 v0.7.1는 2026년 8월 20일에 공개되었습니다.

v0.7.1

2026년 8월 20일

입력한 대로 해석되는 검색

  • 이제 OR에 우선순위가 생겼습니다. 예전에는 질의 전체에 걸리는 플래그여서, 어디든 OR이 하나만 있으면 모든 항이 선택지로 바뀌었습니다. from:alice OR from:bob subject:청구서는 「둘 중 누구든, 청구서에 관한 것」이 아니라 alice에게서 온 전부와 bob에게서 온 전부, 그리고 보낸 사람과 무관하게 제목에 「청구서」가 든 전부를 돌려줬습니다. 6,787통짜리 사서함에서는 49건과 2,102건의 차이입니다. 이제 질의는 AND로 묶인 그룹들의 목록이고, 각 그룹은 OR로 묶인 항들의 목록이며, OR은 두 항을 같은 그룹에 넣는 역할을 합니다. a OR b c는 (a OR b) AND c로 읽힙니다. 괄호는 여전히 없습니다.
  • after:X before:Y는 표현할 방법이 없었습니다. 질의가 날짜 필터를 하나만 담을 수 있어 두 번째가 첫 번째를 조용히 덮어썼고 before:만 살아남았습니다. 사용자가 입력한 절반이 아무 말 없이 버려진 셈입니다. 이제 날짜와 크기 필터는 쌓이며, 그래서 size:>1mb size:<5mb도 진짜 구간이 됩니다.
  • after:는 이제 그 날짜 자신을 포함하고 before:는 여전히 자기 날짜를 제외합니다. 따라서 after:2024-01-01 before:2025-01-01은 정확히 2024년 한 해입니다. Gmail 연산자가 쓰는 반열린 구간 해석이며, 원래 양끝을 포함하던 date:A..B와도 일관됩니다. 두 매뉴얼과 두 README에 우선순위 규칙과 날짜 경계를 명시했습니다. 테스트 23개 추가(총 234개).
릴리스 노트 v0.7.1

v0.7.0

2026년 8월 20일

Google Takeout 아카이브의 나머지 절반

  • 이제 Google 그룹스 사서함도 다른 사서함과 똑같이 열립니다. Takeout 아카이브에는 한 종류가 아니라 두 종류의 mbox가 들어 있습니다. Gmail 내보내기 외에, 계정이 소유한 각 그룹이 Groups/googlegroups.com/<그룹>@googlegroups.com/topics.mbox로 나오며 폴더와 파일 이름은 계정 언어로 번역됩니다. 개발에 사용한 아카이브에서는 이것이 전체 내보내기 중 가장 큰 파일로 636 MB에 6,787통이었고, Gmail mbox는 292 MB였습니다.
  • 그룹스 메시지의 From 봉투 날짜가 더 이상 지어낸 날짜로 해석되지 않습니다. Google 그룹스는 시간대 오프셋을 연도 앞에 적는데(Thu Apr 16 09:53:04 +0000 2015) asctime이 허용하지 않는 형식이라, 읽을 수 있는 Date: 헤더가 없는 메시지는 최후의 수단 파싱으로 넘어가 그럴듯하지만 틀린 2000-09-16을 돌려받았습니다. 오류는 없었고 정렬 순서와 날짜 필터만 망가졌습니다.
  • 그룹이 사이드바에 가상 라벨로 나타나, 라벨 패널이 Gmail 절반이 아니라 Takeout 아카이브 전체에 쓰입니다. 사서함 이름도 「topics」가 아니라 실제로 그것을 식별하는 그룹 이름(<그룹>@googlegroups.com)으로 표시됩니다.
  • 대화는 제목이 아니라, 있을 경우 Google의 실제 대화 ID(X-GM-THRID)로 묶입니다. 기준 사서함에서는 스레드가 1,927개에서 1,958개가 되었고, 가장 큰 스레드에서는 원래 속하지 않던 7통이 빠졌습니다.
  • 묵은 버그 두 개도 잡았습니다. Message-ID가 중복된 메시지가 스레드 보기에서 사라지던 문제와, --force와 export의 --format이 동시에 -f를 차지하던 문제입니다. 업데이트하기 전에 알아둘 점으로, 인덱스 형식이 바뀌므로 기존 .mboxshell.idx는 사서함을 처음 열 때 알아서 다시 만들어집니다.
릴리스 노트 v0.7.0

v0.6.2

2026년 8월 7일

추적 가능한 병합과 실제와 맞는 문서

  • merge --source-header가 이제 사용자가 아는 메일박스 이름을 기록합니다. Apple Mail은 메일박스를 "Inbox.mbox" 폴더로 내보내고 그 안에 말 그대로 "mbox"라는 파일을 두기 때문에, 모든 메시지에 X-Mbox-Source: mbox가 찍혀 이 헤더의 유일한 목적을 잃었습니다. 이름이 겹치는 메일박스는 폴더로 구분합니다.
  • 문서에는 존재하지 않는 merge --dedup이 적혀 있었습니다. 중복 제거는 기본으로 켜져 있고 실제 플래그는 --no-dedup입니다. 두 README와 두 매뉴얼을 바로잡았고, 0.6.1에서 문서 없이 나온 --source-header도 이제 설명합니다.
  • 병합 요약의 "Tagged with source" 줄만 영어로 고정돼 있었는데, 이제 다른 줄처럼 언어 카탈로그를 거칩니다. 테스트 7개 추가(총 202개).
릴리스 노트 v0.6.2
전체 변경 기록 보기

명령 한 번이면 충분

mboxshell
$ mboxshell archive.mbox
# 대화형 터미널 UI를 엽니다
$ mboxshell search archive.mbox "from:jane has:attachment"
# 명령줄에서 바로 검색합니다
$ mboxshell export archive.mbox -f eml -o out/
# 메시지를 EML, CSV, TXT, HTML로 내보냅니다
$ mboxshell merge a.mbox b.mbox -o all.mbox --source-header
# 파일을 병합합니다 — 중복은 기본으로 제거되며(유지하려면 --no-dedup), 각 메시지가 어느 메일박스에서 왔는지 기록합니다
$ mboxshell attachments archive.mbox -o files/
# 모든 첨부 파일을 한 번에 추출합니다

설치

릴리스 페이지에서 Linux, macOS, FreeBSD, Windows용 사전 빌드 바이너리를 받거나 Cargo로 직접 빌드하세요:

$ cargo install --git https://github.com/dcarrero/mboxshell.git

Mbox Viewer를 움직이는 오픈소스 엔진

Mac과 Windows용 Mbox Viewer는 mboxShell에서 출발했습니다. 이 앱은 같은 아이디어 — 모든 크기의 MBOX 파일을 완전히 오프라인으로 읽기 — 를 검색, 라벨, 스레딩, EML 지원을 갖춘 세련된 네이티브 인터페이스로 구현합니다. 터미널을 선호하나요? mboxShell은 무료이며 MIT 라이선스입니다.

github.com/dcarrero/mboxshell