Skip to main content

Converts .eml files to a standards-compliant .mbox archive

Project description

📧 EML → MBOX Converter

✨ Features🧰 Usage🔑 License

This Python tool converts a directory of .eml email files into a single .mbox mailbox file, suitable for import into email clients such as Mozilla Thunderbird.

Unlike simplistic converters, this script preserves the original MIME structure of each message. This ensures that:

  • email bodies (plain text and HTML) display correctly,
  • multipart messages remain intact,
  • attachments and inline content are preserved,
  • character encodings are handled reliably.

The converter uses Python’s standard mailbox module to produce standards-compliant mbox files, avoiding common issues such as missing message content after import.

✨ Features

  • Converts all .eml files in a folder into a single .mbox
  • Preserves full email structure (headers, MIME parts, attachments)
  • Maintains compatibility with major email clients
  • Robust handling of dates and sender metadata
  • Simple and user-friendly CLI powered by typer
  • Safe and deterministic processing (sorted input files)

🧰 Usage

eml2mbox --eml-folder FOLDER_NAME --output-mbox mailbox.mbox

🔑 License

This package is distributed under the MIT License. This license can be found online at http://www.opensource.org/licenses/MIT.

Disclaimer

This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!

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

eml2mbox-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eml2mbox-0.1.0-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file eml2mbox-0.1.0.tar.gz.

File metadata

  • Download URL: eml2mbox-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.14.3 Linux/6.19.7-200.fc43.x86_64

File hashes

Hashes for eml2mbox-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4cd44e072ee2707df6b02518a959cab54f19c8c576a7f1a332945abedb335d0b
MD5 177cd9e0d52a435b112ca2aa7251b5c2
BLAKE2b-256 b1e83c342302b690a083c13e4e1c1d31648353831b598b4c0f4b91c8a450c758

See more details on using hashes here.

File details

Details for the file eml2mbox-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: eml2mbox-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.14.3 Linux/6.19.7-200.fc43.x86_64

File hashes

Hashes for eml2mbox-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14b4c082492ad60fa77e24730ea15a384ec0cc44fa63f27082260951e0705cb3
MD5 0e0f6675784b72aa45b39522e2339f8c
BLAKE2b-256 fa2441d7111e7ede5b47220787b577c6804f08b2a8fb3551b9616bc11cc429c5

See more details on using hashes here.

Supported by

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