Mbox Viewer

A vibecoded project to quickly browse mbox email archives. Built with Python for cross-platform compatibility.

Features

• Load and browse mbox files via file picker
• Search across sender, recipient, subject, and body
• Dark/light mode toggle
• Resizable split-pane layout
• Supports plain text and HTML emails

Requirements

• Python 3.8+

Installation

macOS / Linux

./install.sh

Windows

install.bat

Usage

Start the viewer

macOS / Linux:

./run.sh

Windows:

run.bat

Then open http://localhost:5000 in your browser.

Load an mbox file

1. Click "Browse..." to open the file picker
2. Select your .mbox file
3. Wait for parsing to complete

Search emails

Type in the search box to filter by sender, recipient, subject, or body content.

Uninstall

macOS / Linux

./uninstall.sh

Windows

uninstall.bat

Project Structure

mbox-viewer/
├── app.py              # Flask backend
├── requirements.txt    # Python dependencies
├── templates/
│   └── index.html      # Main HTML template
├── static/
│   ├── style.css       # Styles
│   └── app.js          # Frontend logic
├── install.sh          # macOS/Linux installer
├── install.bat         # Windows installer
├── uninstall.sh        # macOS/Linux uninstaller
└── uninstall.bat       # Windows uninstaller