bibtex2mbox 1.0.0

A utility to convert BibTeX files to mbox archives.

BibTeX to Mbox Converter

A command-line utility to convert a BibTeX (.bib) file into an mbox email archive. Each BibTeX entry becomes an email message, making your reference library searchable and readable in any standard email client.

Features

• Author as Sender: The author field becomes the email's "From" address.
• Title as Subject: The title field becomes the email's "Subject".
• Abstract as Body: The abstract field becomes the main body of the email.
• Link Extraction: Automatically appends url and doi links to the end of the email body.
• LaTeX to Text: Converts common LaTeX commands (e.g., {\'e}, \textit{...}, {...}) into clean, readable plain text.
• Progress Bar: Shows a progress bar via tqdm when processing large files.

Installation

You can install the tool directly from PyPI using pip:

pip install bibtex2mbox

## Usage

The script is a command-line tool. You must provide the path to your input BibTeX file and the desired path for the output mbox file.
You can download a specific BibTeX file from the ADS site, selecting "BibTeX-ABS" as download option.

### Command-Line Syntax

```bash
bibtex2mbox [INPUT_BIB_FILE] [OUTPUT_MBOX_FILE]

### Example
Let's say you have a file named my_library.bib in your current directory. To convert it into an archive named my_archive.mbox, you would run:

```bash
bibtex-to-mbox my_library.bib my_archive.mbox

You will see the following output as the tool processes your file:

```bash
Found 150 entries in 'my_library.bib'. Starting conversion...
Converting entries: 100%|██████████| 150/150 [00:00<00:00, 850.12entry/s]

Successfully converted 150 entries into 'my_archive.mbox'.
The file my_archive.mbox will be created in your current directory.

## Importing the Mbox File into Email Clients

Here are instructions for common clients.

### Mozilla Thunderbird (Recommended)

1.  **Install Add-on**: In Thunderbird, go to `Tools > Add-ons and Themes`, search for and install `ImportExportTools NG`, then restart.
2.  **Import**: Right-click on **Local Folders**, navigate to `ImportExportTools NG > Import mbox file`, choose "Import directly one or more mbox files", and select your `.mbox` file.

### Apple Mail

1.  **Open Import Wizard**: Go to `File > Import Mailboxes...`.
2.  **Select Format**: Choose **"Files in mbox format"** and click "Continue".
3.  **Choose File**: Navigate to and select your `.mbox` file. It will appear in a new "Import" folder under "On My Mac".

### Microsoft Outlook & Webmail (Gmail)

These clients do not directly support mbox imports. The recommended method is to use Thunderbird as an intermediary:

1.  Import the mbox into Thunderbird's "Local Folders".
2.  Set up your Outlook/Gmail account in Thunderbird via IMAP.
3.  Drag and drop the messages from the local mbox folder to a folder in your Outlook/Gmail account. Thunderbird will upload them.