Skip to content
Mbox Viewer Pro

mboxShell

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

최신 v1.2.0 무료 & 오픈소스 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나 명령줄에서 필터링하세요. 앱 안에서 F1을 누르면 전체 문법을 볼 수 있습니다.

Gmail 라벨과 Google 그룹스

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

대화 스레딩

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

어디든 내보내기

메시지를 MBOX, Maildir, EML, CSV, TXT, HTML로 저장하고 첨부 파일을 개별 또는 일괄로 추출하세요. HTML 페이지에는 메시지에 포함된 이미지가 별도 파일 없이 함께 들어갑니다.

병합 및 중복 제거

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

완전한 터미널 UI

ratatui 기반 TUI로 세 가지 레이아웃 모드, vi 스타일 탐색, 어두운 테마·밝은 테마·색을 쓰지 않는 테마, 화면 낭독기가 따라갈 수 있는 커서, bash·zsh·fish·PowerShell·elvish 자동 완성을 제공합니다.

크로스플랫폼 & 이중 언어

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

새로운 기능

가장 최근 세 개의 릴리스입니다. 최신 버전 v1.2.0는 2026년 10월 18일에 공개되었습니다.

v1.2.0

2026년 10월 18일

HTML 내보내기에 메일 속 이미지까지 그대로

  • HTML 내보내기에 이제 메시지에 포함된 이미지가 함께 들어갑니다(#49). 각 <img src="cid:…">를 메시지 안의 이미지 자체로 만든 data: URI로 바꾸기 때문에, 옆에 별도 파일을 두거나 아무것도 내려받지 않아도 로고와 이미지가 보입니다. 예전에는 이미지가 사라졌습니다. export -f html과 앱의 HTML 내보내기에서 기본으로 켜져 있으며, --no-inline-images로 끌 수 있습니다.
  • PNG, JPEG, GIF, WebP만 포함하며, 선언된 형식이 아니라 파일 앞부분의 바이트로 판별합니다. 그래서 스크립트를 담을 수 있는 SVG는 절대 포함되지 않습니다.
  • 설정 파일에 알 수 없는 theme이 있으면 아무 말 없이 무시했지만, 이제 다른 잘못된 값처럼 경고를 띄우고 그 경고도 번역되어 나옵니다. 테스트 5개 추가(총 316개).
릴리스 노트 v1.2.0

v1.1.0

2026년 10월 18일

앱을 벗어나지 않고 보는 전체 검색 문법

  • 도움말(?)에 이제 모든 검색 연산자(from:, to:, cc:, subject:, body:, filename:, label:, id:, has:attachment, date:, 날짜 범위, after:/before:, size:, OR, -)가 날짜 형식, 설명서 안내와 함께 나옵니다(#48). 예전에는 15개 중 8개만 보였습니다. 테스트 3개 추가(총 311개).
  • F1을 누르면 도움말이 검색 문법 부분에서 바로 열립니다. ?가 검색어의 일부가 되는 검색 창에서도 쓸 수 있고, Esc를 누르면 입력하던 검색어로 그대로 돌아갑니다. 명령줄에서도 search --help와 export --help 끝에 같은 연산자 목록이 영어나 스페인어로 나옵니다.
  • 보안: HTML 내보내기를 정화하는 라이브러리 ammonia를 RUSTSEC 권고 세 건(RUSTSEC-2026-0373, RUSTSEC-2021-0157, RUSTSEC-2021-0158)에 따라 4.2.4로 올렸습니다. 이전 버전의 mboxShell은 영향을 받으므로 업데이트를 권장합니다.
릴리스 노트 v1.1.0

v1.0.0

2026년 10월 6일

첫 안정 버전, 이제 제대로 작동하는 설정 파일

  • 첫 안정 버전입니다. 앞으로 명령줄과 설정 파일은 유의적 버전(SemVer)을 따르므로, 호환성을 깨는 변경은 새 메이저 버전에서만 들어갑니다. 테스트 7개 추가(총 308개).
  • 새 명령 mboxshell config [path|show|defaults](#40). path는 설정 파일의 위치와 파일이 이미 있는지를 알려 주고, show는 파일 내용을 보여 주면서 무시되는 값마다 경고하며, defaults는 모든 옵션을 기본값과 함께 주석이 달린 파일 형태로 출력합니다. 아무것도 바꾸지 않고 표준 출력에만 쓰므로, defaults를 파일로 리디렉션하면 바로 출발점이 됩니다.
  • 설정 파일의 옵션 대부분은 아무 효과가 없었습니다. 읽히는 것은 로그 수준, 테마, 첨부 파일 관련 옵션 두 개뿐이었습니다. 이제 default_sort, sort_order, date_format, layout, show_sidebar, max_cached_messages, csv_separator, cache_dir가 작동하며, 잘못된 값은 조용히 무시되지 않고 경고와 함께 기본값으로 돌아갑니다. macOS에서 설정 파일 위치는 README에 적혀 있던 ~/.config/mboxshell이 아니라 ~/Library/Application Support/mboxshell/config.toml입니다.
릴리스 노트 v1.0.0
전체 변경 기록 보기

명령 한 번이면 충분

mboxshell
$ mboxshell archive.mbox
# 대화형 터미널 UI를 엽니다
$ mboxshell search archive.mbox "from:jane has:attachment"
# 명령줄에서 바로 검색합니다
$ mboxshell export archive.mbox -f eml -o out/
# 메시지를 MBOX, Maildir, 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