Skip to main content

MBOX to JSON Converter

Project description

Open in Visual Studio Code

Prakhar Sharma - LinkedIn
Adrita Bhattacharya - LinkedIn


A command line tool to convert MBOX file to JSON.
Explore the docs » (Currently NA)

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. License
  6. Contact

About The Project

A small package that converts MBOX files to JSON. Also includes functionality to extract attachments.

(back to top)

Built With

(back to top)

Getting Started

To run this tool on your system locally, follow the installation steps.


Make sure you upgrade pip before moving on. All the required dependencies are in requirements.txt which would be installed at the time of running the setup.

pip install --upgrade pip


  1. Download the repository as zip. Unzip.

  2. cd to the repository folder

  3. Run this command

    pip install .

(back to top)


mbox-to-json -h

Usage example#1

mbox-to-json /Users/prakhar/downloads/random_file.mbox

---> Use -a flag to extract attachments. The files would be available in an attachments folder in the root location of the repo.

Usage example#2

mbox-to-json /Users/prakhar/downloads/random_file.mbox -a

---> Use -o to specify the output file location. It defaults to file.json in the root location of the repo.

Usage example#3

mbox-to-json /Users/prakhar/downloads/random_file.mbox -o /Users/prakhar/downloads/random_output.json

For more examples, please refer to the Documentation

(back to top)


  • TBA

(back to top)


Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)


LinkedIn - Prakhar Sharma, Adrita Bhattacharya

Github: PS1607, adritabhattacharya

Google Developer: PS1607

(back to top)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mbox-to-json-1.0.3.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

mbox_to_json-1.0.3-py3-none-any.whl (8.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page