mboxshell v0.6.2
mboxShell. 모든 크기의 MBOX 파일을 위한 빠른 터미널 뷰어. Gmail Takeout 백업(50GB+)의 이메일을 메모리에 로드하지 않고 열기, 검색 및 내보내기가 가능합니다. Rust로 제작되었습니다.
mboxShell
크기에 상관없이 MBOX 파일을 위한 빠른 터미널 뷰어. Gmail Takeout 백업(50 GB 이상)의 이메일을 메모리에 로드하지 않고 열고, 검색하고, 내보낼 수 있습니다.
이 프로젝트가 존재하는 이유
Google Takeout을 사용하여 Gmail에서 이메일을 내보내면 수십 기가바이트에 달할 수 있는 하나 이상의 .mbox 파일을 얻게 됩니다. 여기에 더해 소유한 각 Google 그룹당 하나의 추가 사서함이 있는데, 이는 놓치기 쉽고 Gmail 내보내기 자체보다 클 수도 있습니다. 이러한 파일을 메모리에 전부 로드하지 않고 효율적으로 열고, 검색하고, 탐색할 수 있는 크로스 플랫폼 터미널 도구는 존재하지 않습니다.
mboxShell은 이 문제를 해결하기 위해 만들어졌습니다: 50 GB MBOX를 몇 초 만에 열고, 수십만 개의 메시지를 원활하게 탐색하고, 발신자, 날짜 또는 내용으로 검색하고, 필요한 것을 내보낼 수 있습니다. 모두 터미널에서, GUI도, 서버도, 외부 의존성도 없이 말이죠.
사용 사례
- Gmail 백업 탐색 (Google Takeout) - 원래 라벨과 함께
- 소유한 그룹 읽기 - Takeout이 자체 사서함으로 내보내는 경우가 많으며, 종종 아카이브에서 가장 큰 파일입니다
- 메일 아카이브 분석 - 서버에서, 마이그레이션 또는 감사 중에
- 메시지 검색 - 모든 소스의 MBOX 파일에서 (Thunderbird, Unix 서버 등)
- 메시지 내보내기 - 추가 처리를 위해 EML, CSV 또는 일반 텍스트로
- 첨부 파일 추출 - 개별적으로 또는 일괄적으로
- 여러 MBOX 파일 병합 - 중복을 제거하면서 하나로
Mac에서도: mboxViewer
macOS에서 네이티브 그래픽 환경을 선호한다면 mboxViewer를 확인해 보세요. 같은 팀이 만든 네이티브 Mac 앱입니다. 메일 클라이언트로 가져오지 않고도 MBOX 파일을 열고, 탐색하고, 검색할 수 있는 익숙한 사서함 스타일 인터페이스를 제공합니다. .mbox 파일을 드래그 앤 드롭하면 깔끔한 macOS 네이티브 창에서 모든 메시지, 첨부 파일, 라벨에 즉시 접근할 수 있습니다. mboxShell의 파싱 엔진의 강력함과 데스크톱 GUI의 편안함을 모두 원하는 사용자에게 이상적입니다.
브라우저에서도: Online Mbox Viewer
아무것도 설치하지 않고 MBOX 파일을 살펴봐야 하나요? 같은 저자가 만든 무료 MIT 라이선스 웹 앱인 Online Mbox Viewer를 사용해 보세요. .mbox 파일을 전적으로 브라우저에서 열고 렌더링합니다: 어떤 서버에도 업로드되지 않으므로 이메일이 사용자의 컴퓨터에 남아 있습니다. 어떤 기기에서든 빠르게 확인하기에 완벽합니다. 소스 코드는 github.com/dcarrero/online-mbox-viewer에 있습니다.
기능
- 파일을 메모리에 로드하지 않습니다. 1 MB 버퍼를 사용한 스트리밍 I/O를 사용합니다. 100 GB MBOX는 1 GB 파일과 거의 같은 ~500 MB의 RAM을 사용합니다 (메타데이터 인덱스만 메모리에 상주).
- 영구 인덱싱. 첫 번째 열기에서 바이너리 인덱스(
.mboxshell.idx)를 생성하므로 이후 열기는 1초 미만이 걸립니다. - 완전한 Gmail 지원.
X-Gmail-Labels를 감지하여 사이드바 패널에 가상 폴더로 표시하며, 받은편지함, 보낸편지함, 별표표시, 사용자 정의 라벨 등으로 필터링할 수 있습니다. - Google 그룹 사서함. Takeout 아카이브가 소유한 각 그룹에 대해 제공하는
topics.mbox파일을 읽고, 의미 없는 파일 이름 대신 그룹 이름으로 이름을 지정하고, 그룹을 가상 라벨로 표시하며, 정확한X-GM-THRIDid로 대화를 스레드화합니다. - 올바른 인코딩. RFC 2047 인코딩된 단어를 디코딩하고, UTF-8, ISO-8859-1, Windows-1252, KOI8-R 및
encoding_rs가 인식하는 모든 문자 집합을 지원합니다. - 대화 스레드화. JWZ 알고리즘(Netscape/Mozilla에서 사용하는 것과 동일)을 사용하거나 사서함 자체의 대화 id가 있을 때 이를 사용하여 메시지를 스레드로 그룹화합니다.
- 고급 검색. 필드별 필터링 (
from:,subject:,date:,body:,has:attachment,label:등), 날짜 범위, 크기 필터, AND/OR 연산자, 부정. - 유연한 내보내기. 개별 또는 일괄 내보내기 - EML, CSV (Excel 호환), 일반 텍스트. 디코딩된 첨부 파일 추출.
- 단일 바이너리. 런타임 없음, 의존성 없음. Linux, macOS, Windows에서 실행되는 ~5 MB 실행 파일.
- 완전한 터미널 UI. 키보드 탐색 (vi 스타일), 세 가지 레이아웃 모드, 대화형 검색 바, 구성 가능한 단축키.
- 이중 언어. 영어와 스페인어로 제공되는 인터페이스, 시스템 로케일에서 자동 감지.
설치
사전 빌드된 바이너리 (권장)
Releases 페이지에서 플랫폼에 맞는 최신 릴리스를 다운로드하세요:
| 플랫폼 | 바이너리 |
|---|---|
| Linux x86_64 | mboxshell-linux-x86_64 |
| Linux ARM64 | mboxshell-linux-aarch64 |
| Linux RISC-V 64 | mboxshell-linux-riscv64 |
| FreeBSD x86_64 | mboxshell-freebsd-x86_64 |
| macOS Intel | mboxshell-macos-x86_64 |
| macOS Apple Silicon | mboxshell-macos-aarch64 |
| Windows x86_64 | mboxshell-windows-x86_64.exe |
| Windows ARM64 | mboxshell-windows-arm64.exe |
다운로드 후 실행 가능하게 만들고 PATH로 이동하세요:
# Linux / macOS
chmod +x mboxshell-*
sudo mv mboxshell-* /usr/local/bin/mboxshell
# Or place it in a user-local directory
mv mboxshell-* ~/.local/bin/mboxshell
Windows에서는 mboxshell-windows-x86_64.exe를 PATH에 있는 폴더로 이동하거나 직접 실행하세요.
소스에서 빌드
요구 사항: Rust 1.85 이상.
# Clone and build
git clone https://github.com/dcarrero/mboxshell.git
cd mboxshell
cargo build --release
# The binary is at target/release/mboxshell
# Install it system-wide:
sudo cp target/release/mboxshell /usr/local/bin/
# Or for the current user only:
cp target/release/mboxshell ~/.local/bin/
다른 플랫폼용 크로스 컴파일
# Add the target you need
rustup target add aarch64-apple-darwin # macOS Apple Silicon
rustup target add x86_64-unknown-linux-gnu # Linux x86_64
rustup target add aarch64-unknown-linux-gnu # Linux ARM64
# Build for a specific target
cargo build --release --target aarch64-apple-darwin
Cargo를 통한 설치
cargo install --git https://github.com/dcarrero/mboxshell.git
빠른 시작
# Open an MBOX file in the terminal UI
mboxshell mail.mbox
# Index and show statistics
mboxshell index mail.mbox
mboxshell stats mail.mbox
# Search from the command line
mboxshell search mail.mbox "from:[email protected] date:2024"
mboxshell search mail.mbox "has:attachment subject:invoice" --json
# Export messages
mboxshell export mail.mbox --format eml --output ./emails/
mboxshell export mail.mbox --format csv --output summary.csv
# Hand over only part of an archive: a new mailbox with just the matches
mboxshell export mail.mbox --format mbox --query "from:[email protected]" -o handover.mbox
# Extract attachments
mboxshell attachments mail.mbox --output ./attachments/
# Merge multiple MBOX files (duplicates are removed by default)
mboxshell merge file1.mbox file2.mbox -o merged.mbox
# Merge tagging every message with the mailbox it came from
mboxshell merge Inbox.mbox Sent.mbox -o merged.mbox --source-header
# Generate shell completions
mboxshell completions bash > /etc/bash_completion.d/mboxshell
mboxshell completions zsh > ~/.zfunc/_mboxshell
mboxshell completions fish > ~/.config/fish/completions/mboxshell.fish
CLI 명령어
| 명령어 | 설명 |
|---|---|
mboxshell [FILE] | TUI에서 파일 열기 (기본 동작) |
mboxshell open <path> | TUI에서 MBOX 파일 열기 |
mboxshell index <path> [-f/--force] | 바이너리 인덱스 빌드 또는 재빌드 |
mboxshell stats <path> [--json] | MBOX 파일에 대한 통계 표시 |
mboxshell search <path> <query> [--json] | 명령줄에서 메시지 검색 |
mboxshell export <path> -f <format> -o <output> [--query <q>] | 메시지 내보내기 (형식: eml, csv, txt, html, mbox) |
mboxshell merge <files...> -o <output> [--no-dedup] [--source-header] | 여러 MBOX 파일을 하나로 병합 |
mboxshell attachments <path> -o <output> | 모든 첨부 파일 추출 |
mboxshell completions <shell> | 셸 완성 생성 (bash, zsh, fish, powershell, elvish) |
mboxshell manpage | 맨 페이지 생성 |
전역 플래그:
| 플래그 | 설명 |
|---|---|
-f, --force | 인덱스가 이미 존재하더라도 강제 재빌드 (export에서는 -f가 --format이므로 --force를 명시적으로 사용) |
-v, --verbose | 로그 상세도 증가 (-v info, -vv debug, -vvv trace) |
--lang <en|es> | 인터페이스 언어 강제 (기본값은 자동 감지) |
병합 플래그:
| 플래그 | 설명 |
|---|---|
--no-dedup | 중복 Message-ID 감지를 건너뛰고 입력을 바이트 단위로 연결 (기본적으로 중복 제거 활성화) |
--source-header | 모든 메시지에 X-Mbox-Source: <mailbox name> 헤더를 주입하여 병합된 아카이브가 각 이메일이 어느 사서함에서 왔는지 추적 가능하게 유지 |
소스 라벨은 표시되는 사서함 이름입니다: Apple Mail 내보내기의 경우 — mbox라는 파일을 포함하는 Inbox.mbox 디렉터리 — mbox가 아닌 Inbox.mbox로 읽힙니다. 라벨을 공유하게 될 사서함은 서로 구분됩니다 (Work/Inbox.mbox vs Personal/Inbox.mbox).
터미널 UI
