PyPI - chat-export - Versions diffs - 0.9.2__tar.gz → 0.9.4__tar.gz - Mend

chat-export 0.9.2tar.gz → 0.9.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

{chat_export-0.9.2/chat_export.egg-info → chat_export-0.9.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chat-export
-Version: 0.9.2
+Version: 0.9.4
 Summary: Convert WhatsApp chat exports to HTML format
 Author-email: matlon GmbH <software@matlon.ch>
 License: MIT License
@@ -60,7 +60,7 @@ Dynamic: license-file
 This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):
 [![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
 ## Binary Release Downloads
@@ -101,7 +101,28 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
 3. **Install and Run the Tool:**
-   **Option 1: Install via pip (Recommended)**
+### Option 1: Download Binary Executables: Easy for non-technical users
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+   Once installed on Mac:
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+   This will start the chat export tool from anywhere in the terminal.
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+   The executables have been built with pyinstaller.
+### Option 2: Install via pip
    If you have Python installed, you can install chat-export as a command-line tool:
    ```
@@ -122,43 +143,41 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
    pip install chat-export[windows]
    ```
    *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
    After installation, you can run it from anywhere in your terminal:
    ```
    chat-export
+   ```
+   or
+   ```
    chat-export --help
    ```
    To uninstall:
    ```
    pip uninstall chat-export
    ```
-   **Option 2: Download Binary Executables**
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-   This will start the chat export tool from anywhere in the terminal.
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path.
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
-   The executables have been built with pyinstaller.
+   `uv tool install chat-export[windows]`
+   or
+   `uv tool install chat-export[macos]`
+   or just
+   `uv tool install chat-export`
+   uninstall with:
+   `uv tool uninstall chat-export`
-   **Option 3: Run Directly (No Installation)**
+###Option 3: Run Directly (No Installation)
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
      ```
      python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
@@ -167,11 +186,14 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
      python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
-**Usage**
+## Usage
 The tool supports both interactive and non-interactive modes:
 ### Interactive Mode (Default)
+Just run `chat-export` in your terminal.
 **CLI Parameters:**
 `-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)
@@ -186,6 +208,22 @@ The tool supports both interactive and non-interactive modes:
 For automation, scripting, or when you know all parameters in advance, you can use the non-interactive CLI mode. This mode processes the chat without any prompts and is perfect for batch processing or integration into other tools.
+#### Media Embedding Options
+The tool offers two approaches for handling media files:
+**Default Behavior (External Media Files):**
+- Creates a folder structure with HTML files and a separate `media/` folder
+- Media files are extracted and linked to from the HTML
+- Results in multiple files that need to be kept together
+- Smaller HTML files, but requires managing multiple files
+**Embedded Media (`--embed-media` option):**
+- Creates a single self-contained HTML file with all media embedded as base64
+- No external media files are created or needed
+- Perfect for sharing, archiving, or when you want everything in one file
+- Larger HTML file size, but completely portable
 **Basic Usage:**
 ```
 chat-export -n -z "path/to/chat.zip" -p "Your Name"
@@ -199,6 +237,7 @@ chat-export -n -z "path/to/chat.zip" -p "Your Name"
 - `--from-date`: Optional start date for filtering (formats: DD.MM.YYYY, MM/DD/YYYY, DD.MM.YY, MM/DD/YY)
 - `--until-date`: Optional end date for filtering
 - `-o, --output-dir`: Base directory where the chat folder will be created (default: current directory)
+- `--embed-media`: Embed media files as base64 in HTML instead of linking to external files (optional)
 **Examples:**
@@ -227,9 +266,15 @@ Windows paths (important: no trailing backslash):
 chat-export -n -z "chat.zip" -p "Your Name" -o "C:\temp"
 ```
+With embedded media (creates a single self-contained HTML file):
+```
+chat-export -n -z "chat.zip" -p "Your Name" --embed-media
+```
 **Important Notes:**
 - The participant name must match exactly as it appears in the chat (case-sensitive)
 - If the participant name is not found, the tool will display all available participants and exit
+- When using `--embed-media`, media files are encoded as base64 and embedded directly in the HTML, creating a single self-contained file that doesn't require external media files
 * When printing an HTML page, most web browsers are set by default to exclude background colors to save ink or toner. If you want to include them, you need to enable background graphics in your browser settings. See the section below for instructions.

{chat_export-0.9.2 → chat_export-0.9.4}/README.md RENAMED Viewed

@@ -1,207 +1,252 @@
-# chat-export: Convert WhatsApp Chats to HTML
-This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):
-[![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
-## Binary Release Downloads
-* Windows: [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe)
-* Mac: [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
-## Why is this useful?
-The HTML export is:
-* **Printable:** You can print the chat or save as a PDF.
-* **Searchable:** You can search for specific messages in the browser.
-* **Shareable:** You can share the chat with others, but make sure to get consent from all other participants first.
-* **Durable:** You can keep the chat as a record for years to come. Apps come and go. Plain HTML is here to stay.
-* **Automatable:** With the non-interactive CLI mode, you can script batch processing of multiple chat exports or integrate the tool into other workflows.
-Maybe you want to:
-* keep a record of a conversation with a former loved one, friend, or business partner. You want to delete the chat from your phone, but you don’t want to lose the memories.
-* save a chat with important information, such as addresses, phone numbers, or other data.
-* keep a chat with a person who has passed away.
-* export just an excerpt of a chat from a specific date range.
-* archive a chat before freeing up space on your phone by deleting photos, videos, and other documents that were part of the chat.
-* ask another chat participant who still has a complete version of the chat (including all pictures) on his or her phone to send you a chat export, so you can convert and archive it.
-* batch process multiple chat exports automatically using the CLI mode.
-* integrate chat conversion into backup or archival scripts.
-* process chat exports on headless servers or in automated workflows.
-Furthermore, the tool is [open-source](https://github.com/mtln/chat-export) and runs offline on your computer, so you can be sure that your data is not being sent to any server.
-And by the way, it’s free! If you find it useful, you can [donate](https://donate.stripe.com/3csfZLaIj5JE6dO4gg).
-## Instructions
-1. **Export the Chat:** Begin by exporting a chat from the WhatsApp app, preferably with media included. For detailed instructions, refer to [WhatsApp FAQ](https://faq.whatsapp.com/search?helpref=search&query=%20export%20chat).
-You can for example save it on Google Drive or Dropbox or send it to yourself with WhatsApp.
-2. **Transfer the File:** Move the exported ZIP file to your computer. If you have sent it to yourself with WhatsApp, you can download it with WhatsApp Web or with the WhatsApp App on your computer. Delete the WhatsApp message afterwards to save space.
-3. **Install and Run the Tool:**
-   **Option 1: Install via pip (Recommended)**
-   If you have Python installed, you can install chat-export as a command-line tool:
-   ```
-   pip install chat-export
-   ```
-   **Optional: Install with platform-specific dependencies for native file dialogs**
-   For better user experience with native file picker dialogs, you can install platform-specific dependencies:
-   **On macOS:**
-   ```
-   pip install chat-export[macos]
-   ```
-   **On Windows:**
-   ```
-   pip install chat-export[windows]
-   ```
-   *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
-   After installation, you can run it from anywhere in your terminal:
-   ```
-   chat-export
-   chat-export --help
-   ```
-   To uninstall:
-   ```
-   pip uninstall chat-export
-   ```
-   **Option 2: Download Binary Executables**
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-   This will start the chat export tool from anywhere in the terminal.
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
-   The executables have been built with pyinstaller.
-   **Option 3: Run Directly (No Installation)**
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
-     ```
-     python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
-     ```
-     or
-     ```
-     python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
-     ```
-**Usage**
-The tool supports both interactive and non-interactive modes:
-### Interactive Mode (Default)
-**CLI Parameters:**
-`-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)
-* After starting the tool, a file picker dialog will open. Select the ZIP file of the chat export you want to convert. If your installation does not support file dialogs, you will be prompted for the path to the ZIP file.
-* You can enter start and end dates to export only a specific date range. If you leave the fields empty, the entire chat will be exported. **If the terminal window doesn't accept your keyboard input, click with your mouse right after the colon in `Enter the number corresponding to your name:`** to set the focus to the terminal window.
-* A list of chat participants will appear. Select your name so that your messages are displayed in green chat bubbles, just like on WhatsApp.
-* Once the conversion completes, you can choose to open the HTML files immediately in your browser (just hit enter). From there, you can save the chat as a PDF or print it if needed.
-### Command Line Interface (Non-Interactive Mode)
-For automation, scripting, or when you know all parameters in advance, you can use the non-interactive CLI mode. This mode processes the chat without any prompts and is perfect for batch processing or integration into other tools.
-**Basic Usage:**
-```
-chat-export -n -z "path/to/chat.zip" -p "Your Name"
-```
-**CLI Parameters:**
-- `-n, --non-interactive`: Enable non-interactive mode (required)
-- `-z, --zip-file`: Path to WhatsApp chat export ZIP file (required)
-- `-p, --participant`: Your name exactly as it appears in the chat (required)
-- `--from-date`: Optional start date for filtering (formats: DD.MM.YYYY, MM/DD/YYYY, DD.MM.YY, MM/DD/YY)
-- `--until-date`: Optional end date for filtering
-- `-o, --output-dir`: Base directory where the chat folder will be created (default: current directory)
-**Examples:**
-Basic conversion:
-```
-chat-export -n -z "WhatsApp Chat with John.zip" -p "Your Name"
-```
-With absolute path to ZIP file (Windows):
-```
-chat-export -n -z "c:\temp\WhatsApp Chat with John.zip" -p "Your Name"
-```
-With date filtering:
-```
-chat-export -n -z "chat.zip" -p "Your Name" --from-date "01.01.2024" --until-date "31.12.2024"
-```
-Custom output directory (creates chat folder in /tmp instead of current directory):
-```
-chat-export -n -z "chat.zip" -p "Your Name" -o "/tmp"
-```
-Windows paths (important: no trailing backslash):
-```
-chat-export -n -z "chat.zip" -p "Your Name" -o "C:\temp"
-```
-**Important Notes:**
-- The participant name must match exactly as it appears in the chat (case-sensitive)
-- If the participant name is not found, the tool will display all available participants and exit
-* When printing an HTML page, most web browsers are set by default to exclude background colors to save ink or toner. If you want to include them, you need to enable background graphics in your browser settings. See the section below for instructions.
-   * **In Google Chrome**: Go to `Print` → `More settings` → Check `Background graphics`.
-   * **In Mozilla Firefox**: Go to `File` → `Print` → `Page Setup` → Check `Print Background (colors & images)`.
-   * **In Microsoft Edge**: Go to `Print` → `More settings` → Check `Background graphics`.
-## Supported languages
-WhatsApp chat exports vary depending on your phone’s system language.
-chat-export has been tested with many languages and regional settings.
-If it doesn't work for your language, please let me know.
-## Supported Operating Systems
-* Windows
-* Mac
-* Linux
-## Limitations
-There is information in chats, that is not included in the export.zip created by WhatsApp. As a consequence, this information cannot be rendered by chat-export.
-This includes:
-* Reactions (thumbs up and other emojis that are not a stand-alone message, but created by long tapping a previous message)
-* Message relations (in WhatsApp, you can right-swipe a previous message and then write a message in relation to this)
-* Chat group metadata (e.g. list of all members, admins, ...)
-## Disclaimer
-chat-export comes with no warranty. Use it responsibly and respect the privacy of other chat participants. The tool is not affiliated with WhatsApp or Meta.
+# chat-export: Convert WhatsApp Chats to HTML
+This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):
+[![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
+## Binary Release Downloads
+* Windows: [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe)
+* Mac: [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+## Why is this useful?
+The HTML export is:
+* **Printable:** You can print the chat or save as a PDF.
+* **Searchable:** You can search for specific messages in the browser.
+* **Shareable:** You can share the chat with others, but make sure to get consent from all other participants first.
+* **Durable:** You can keep the chat as a record for years to come. Apps come and go. Plain HTML is here to stay.
+* **Automatable:** With the non-interactive CLI mode, you can script batch processing of multiple chat exports or integrate the tool into other workflows.
+Maybe you want to:
+* keep a record of a conversation with a former loved one, friend, or business partner. You want to delete the chat from your phone, but you don’t want to lose the memories.
+* save a chat with important information, such as addresses, phone numbers, or other data.
+* keep a chat with a person who has passed away.
+* export just an excerpt of a chat from a specific date range.
+* archive a chat before freeing up space on your phone by deleting photos, videos, and other documents that were part of the chat.
+* ask another chat participant who still has a complete version of the chat (including all pictures) on his or her phone to send you a chat export, so you can convert and archive it.
+* batch process multiple chat exports automatically using the CLI mode.
+* integrate chat conversion into backup or archival scripts.
+* process chat exports on headless servers or in automated workflows.
+Furthermore, the tool is [open-source](https://github.com/mtln/chat-export) and runs offline on your computer, so you can be sure that your data is not being sent to any server.
+And by the way, it’s free! If you find it useful, you can [donate](https://donate.stripe.com/3csfZLaIj5JE6dO4gg).
+## Instructions
+1. **Export the Chat:** Begin by exporting a chat from the WhatsApp app, preferably with media included. For detailed instructions, refer to [WhatsApp FAQ](https://faq.whatsapp.com/search?helpref=search&query=%20export%20chat).
+You can for example save it on Google Drive or Dropbox or send it to yourself with WhatsApp.
+2. **Transfer the File:** Move the exported ZIP file to your computer. If you have sent it to yourself with WhatsApp, you can download it with WhatsApp Web or with the WhatsApp App on your computer. Delete the WhatsApp message afterwards to save space.
+3. **Install and Run the Tool:**
+### Option 1: Download Binary Executables: Easy for non-technical users
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+   Once installed on Mac:
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+   This will start the chat export tool from anywhere in the terminal.
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+   The executables have been built with pyinstaller.
+### Option 2: Install via pip
+   If you have Python installed, you can install chat-export as a command-line tool:
+   ```
+   pip install chat-export
+   ```
+   **Optional: Install with platform-specific dependencies for native file dialogs**
+   For better user experience with native file picker dialogs, you can install platform-specific dependencies:
+   **On macOS:**
+   ```
+   pip install chat-export[macos]
+   ```
+   **On Windows:**
+   ```
+   pip install chat-export[windows]
+   ```
+   *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
+   After installation, you can run it from anywhere in your terminal:
+   ```
+   chat-export
+   ```
+   or
+   ```
+   chat-export --help
+   ```
+   To uninstall:
+   ```
+   pip uninstall chat-export
+   ```
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path.
+   `uv tool install chat-export[windows]`
+   or
+   `uv tool install chat-export[macos]`
+   or just
+   `uv tool install chat-export`
+   uninstall with:
+   `uv tool uninstall chat-export`
+###Option 3: Run Directly (No Installation)
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
+     ```
+     python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
+     ```
+     or
+     ```
+     python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
+     ```
+## Usage
+The tool supports both interactive and non-interactive modes:
+### Interactive Mode (Default)
+Just run `chat-export` in your terminal.
+**CLI Parameters:**
+`-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)
+* After starting the tool, a file picker dialog will open. Select the ZIP file of the chat export you want to convert. If your installation does not support file dialogs, you will be prompted for the path to the ZIP file.
+* You can enter start and end dates to export only a specific date range. If you leave the fields empty, the entire chat will be exported. **If the terminal window doesn't accept your keyboard input, click with your mouse right after the colon in `Enter the number corresponding to your name:`** to set the focus to the terminal window.
+* A list of chat participants will appear. Select your name so that your messages are displayed in green chat bubbles, just like on WhatsApp.
+* Once the conversion completes, you can choose to open the HTML files immediately in your browser (just hit enter). From there, you can save the chat as a PDF or print it if needed.
+### Command Line Interface (Non-Interactive Mode)
+For automation, scripting, or when you know all parameters in advance, you can use the non-interactive CLI mode. This mode processes the chat without any prompts and is perfect for batch processing or integration into other tools.
+#### Media Embedding Options
+The tool offers two approaches for handling media files:
+**Default Behavior (External Media Files):**
+- Creates a folder structure with HTML files and a separate `media/` folder
+- Media files are extracted and linked to from the HTML
+- Results in multiple files that need to be kept together
+- Smaller HTML files, but requires managing multiple files
+**Embedded Media (`--embed-media` option):**
+- Creates a single self-contained HTML file with all media embedded as base64
+- No external media files are created or needed
+- Perfect for sharing, archiving, or when you want everything in one file
+- Larger HTML file size, but completely portable
+**Basic Usage:**
+```
+chat-export -n -z "path/to/chat.zip" -p "Your Name"
+```
+**CLI Parameters:**
+- `-n, --non-interactive`: Enable non-interactive mode (required)
+- `-z, --zip-file`: Path to WhatsApp chat export ZIP file (required)
+- `-p, --participant`: Your name exactly as it appears in the chat (required)
+- `--from-date`: Optional start date for filtering (formats: DD.MM.YYYY, MM/DD/YYYY, DD.MM.YY, MM/DD/YY)
+- `--until-date`: Optional end date for filtering
+- `-o, --output-dir`: Base directory where the chat folder will be created (default: current directory)
+- `--embed-media`: Embed media files as base64 in HTML instead of linking to external files (optional)
+**Examples:**
+Basic conversion:
+```
+chat-export -n -z "WhatsApp Chat with John.zip" -p "Your Name"
+```
+With absolute path to ZIP file (Windows):
+```
+chat-export -n -z "c:\temp\WhatsApp Chat with John.zip" -p "Your Name"
+```
+With date filtering:
+```
+chat-export -n -z "chat.zip" -p "Your Name" --from-date "01.01.2024" --until-date "31.12.2024"
+```
+Custom output directory (creates chat folder in /tmp instead of current directory):
+```
+chat-export -n -z "chat.zip" -p "Your Name" -o "/tmp"
+```
+Windows paths (important: no trailing backslash):
+```
+chat-export -n -z "chat.zip" -p "Your Name" -o "C:\temp"
+```
+With embedded media (creates a single self-contained HTML file):
+```
+chat-export -n -z "chat.zip" -p "Your Name" --embed-media
+```
+**Important Notes:**
+- The participant name must match exactly as it appears in the chat (case-sensitive)
+- If the participant name is not found, the tool will display all available participants and exit
+- When using `--embed-media`, media files are encoded as base64 and embedded directly in the HTML, creating a single self-contained file that doesn't require external media files
+* When printing an HTML page, most web browsers are set by default to exclude background colors to save ink or toner. If you want to include them, you need to enable background graphics in your browser settings. See the section below for instructions.
+   * **In Google Chrome**: Go to `Print` → `More settings` → Check `Background graphics`.
+   * **In Mozilla Firefox**: Go to `File` → `Print` → `Page Setup` → Check `Print Background (colors & images)`.
+   * **In Microsoft Edge**: Go to `Print` → `More settings` → Check `Background graphics`.
+## Supported languages
+WhatsApp chat exports vary depending on your phone’s system language.
+chat-export has been tested with many languages and regional settings.
+If it doesn't work for your language, please let me know.
+## Supported Operating Systems
+* Windows
+* Mac
+* Linux
+## Limitations
+There is information in chats, that is not included in the export.zip created by WhatsApp. As a consequence, this information cannot be rendered by chat-export.
+This includes:
+* Reactions (thumbs up and other emojis that are not a stand-alone message, but created by long tapping a previous message)
+* Message relations (in WhatsApp, you can right-swipe a previous message and then write a message in relation to this)
+* Chat group metadata (e.g. list of all members, admins, ...)
+## Disclaimer
+chat-export comes with no warranty. Use it responsibly and respect the privacy of other chat participants. The tool is not affiliated with WhatsApp or Meta.

{chat_export-0.9.2 → chat_export-0.9.4/chat_export.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chat-export
-Version: 0.9.2
+Version: 0.9.4
 Summary: Convert WhatsApp chat exports to HTML format
 Author-email: matlon GmbH <software@matlon.ch>
 License: MIT License
@@ -60,7 +60,7 @@ Dynamic: license-file
 This tool converts a WhatsApp chat export into two HTML formats: one with inline media (such as images, videos, and audio files) and a compact version with media links.
-Video Tutorial (still refers to the previously used tool name instead of `chat-export`):
+Video Tutorial (still refers to the previously used tool name instead of `chat-export`, doesn't cover new features like the non-interactive CLI mode yet):
 [![YouTube](https://img.youtube.com/vi/s1dMO8pjkC8/0.jpg)](https://www.youtube.com/watch?v=s1dMO8pjkC8)"
 ## Binary Release Downloads
@@ -101,7 +101,28 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
 3. **Install and Run the Tool:**
-   **Option 1: Install via pip (Recommended)**
+### Option 1: Download Binary Executables: Easy for non-technical users
+   If you don't know what Python is and just want to use the tool without having to deal with technical details, you can download the binary executables.
+   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
+   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
+   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
+   Once installed on Mac:
+   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
+   2. Type: `chat-export`
+   This will start the chat export tool from anywhere in the terminal.
+   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
+   The executables have been built with pyinstaller.
+### Option 2: Install via pip
    If you have Python installed, you can install chat-export as a command-line tool:
    ```
@@ -122,43 +143,41 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
    pip install chat-export[windows]
    ```
    *Note: Without these optional dependencies, the tool will fall back to command-line input for file selection or use tkinter (if available) for file dialogs. If you're planning to use the tool in non-interactive mode, you don't need to install these dependencies.*
    After installation, you can run it from anywhere in your terminal:
    ```
    chat-export
+   ```
+   or
+   ```
    chat-export --help
    ```
    To uninstall:
    ```
    pip uninstall chat-export
    ```
-   **Option 2: Download Binary Executables**
-   - For Windows, download [chat-export.exe](https://github.com/mtln/chat-export/releases/latest/download/chat-export.exe).
-   Because the .exe is unsigned, you will see a warning, but after clicking on "More Information" you should have the option to run it anyway. An EV code signing certificate for Windows costs a lot. If I get enough donations, I will buy one, so I can release signed exe files.
-   - For Mac, download [chat-export-installer.pkg](https://github.com/mtln/chat-export/releases/latest/download/chat-export-installer.pkg)
-   Once installed on Mac:
-   1. Open the **Terminal** app (e.g. by typing "terminal" in Spotlight Search).
-   2. Type: `chat-export`
-   This will start the chat export tool from anywhere in the terminal.
+#### Using uv tool instead of pip
+   If you have uv installed, you can use `uv tool install` instead of `pip install`. This is perfect for tools like chat-export because it will install the dependencies in a virtual environment and not in the global environment - while still making the tool available globally in your shell / path.
-   To uninstall `chat-export` from Mac, open the Terminal and run: `sudo rm /usr/local/bin/chat-export`
-   The executables have been built with pyinstaller.
+   `uv tool install chat-export[windows]`
+   or
+   `uv tool install chat-export[macos]`
+   or just
+   `uv tool install chat-export`
+   uninstall with:
+   `uv tool uninstall chat-export`
-   **Option 3: Run Directly (No Installation)**
+###Option 3: Run Directly (No Installation)
-   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no installation required) with the following command:
+   If Python is installed on your Windows, Mac or Linux computer, run the tool directly (no pip installation required, no venv required, no additional dependencies required because it's just vanilla standard lib Python in a single scriptfile, always run the latest up to date version directly from GitHub) with the following command:
      ```
      python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
@@ -167,11 +186,14 @@ You can for example save it on Google Drive or Dropbox or send it to yourself wi
      python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/mtln/chat-export/refs/heads/main/main.py').read().decode())"
      ```
-**Usage**
+## Usage
 The tool supports both interactive and non-interactive modes:
 ### Interactive Mode (Default)
+Just run `chat-export` in your terminal.
 **CLI Parameters:**
 `-o, --output-dir`: Base directory where the chat folder will be created (optional, default: current directory)
@@ -186,6 +208,22 @@ The tool supports both interactive and non-interactive modes:
 For automation, scripting, or when you know all parameters in advance, you can use the non-interactive CLI mode. This mode processes the chat without any prompts and is perfect for batch processing or integration into other tools.
+#### Media Embedding Options
+The tool offers two approaches for handling media files:
+**Default Behavior (External Media Files):**
+- Creates a folder structure with HTML files and a separate `media/` folder
+- Media files are extracted and linked to from the HTML
+- Results in multiple files that need to be kept together
+- Smaller HTML files, but requires managing multiple files
+**Embedded Media (`--embed-media` option):**
+- Creates a single self-contained HTML file with all media embedded as base64
+- No external media files are created or needed
+- Perfect for sharing, archiving, or when you want everything in one file
+- Larger HTML file size, but completely portable
 **Basic Usage:**
 ```
 chat-export -n -z "path/to/chat.zip" -p "Your Name"
@@ -199,6 +237,7 @@ chat-export -n -z "path/to/chat.zip" -p "Your Name"
 - `--from-date`: Optional start date for filtering (formats: DD.MM.YYYY, MM/DD/YYYY, DD.MM.YY, MM/DD/YY)
 - `--until-date`: Optional end date for filtering
 - `-o, --output-dir`: Base directory where the chat folder will be created (default: current directory)
+- `--embed-media`: Embed media files as base64 in HTML instead of linking to external files (optional)
 **Examples:**
@@ -227,9 +266,15 @@ Windows paths (important: no trailing backslash):
 chat-export -n -z "chat.zip" -p "Your Name" -o "C:\temp"
 ```
+With embedded media (creates a single self-contained HTML file):
+```
+chat-export -n -z "chat.zip" -p "Your Name" --embed-media
+```
 **Important Notes:**
 - The participant name must match exactly as it appears in the chat (case-sensitive)
 - If the participant name is not found, the tool will display all available participants and exit
+- When using `--embed-media`, media files are encoded as base64 and embedded directly in the HTML, creating a single self-contained file that doesn't require external media files
 * When printing an HTML page, most web browsers are set by default to exclude background colors to save ink or toner. If you want to include them, you need to enable background graphics in your browser settings. See the section below for instructions.

{chat_export-0.9.2 → chat_export-0.9.4}/main.py RENAMED Viewed

@@ -1,4 +1,5 @@
 import argparse
+import base64
 import difflib
 import os
 import sys
@@ -286,7 +287,7 @@ def windows_file_picker():
-version = "0.9.2"
+version = "0.9.4"
 donate_link = "https://donate.stripe.com/3csfZLaIj5JE6dO4gg"
@@ -355,6 +356,10 @@ Examples:
                        type=str,
                        help='Base directory where the ZIP-derived output folder will be created (default: current working directory)')
+    parser.add_argument('--embed-media',
+                       action='store_true',
+                       help='Embed media files as base64 in HTML instead of linking to external files')
     args = parser.parse_args()
     # Validate non-interactive mode requirements
@@ -455,6 +460,44 @@ class MessageParser:
         except (ValueError, AttributeError):
             return None
+    @staticmethod
+    def trim_zero_widths(text: str) -> str:
+        """Trim harmless zero-width characters from the start and end of a string.
+        Safe to strip: ZWSP, ZWNJ, ZWJ, BOM.
+        Does NOT strip directional controls like LRM, RLM, FSI, PDI, etc.
+        """
+        SAFE_ZERO_WIDTHS = "\u200B\u200C\u200D\uFEFF"  # ZWSP, ZWNJ, ZWJ, BOM
+        return text.strip(SAFE_ZERO_WIDTHS).strip()
+    @staticmethod
+    def mark_invisible_chars(text: str) -> str:
+        """Replace zero-width and directional Unicode control chars with ASCII markers."""
+        replacements = {
+            "\u200B": ":ZWSP:",   # Zero Width Space
+            "\u200C": ":ZWNJ:",   # Zero Width Non-Joiner
+            "\u200D": ":ZWJ:",    # Zero Width Joiner
+            "\uFEFF": ":BOM:",    # Zero Width No-Break Space / BOM
+            "\u200E": ":LRM:",    # Left-to-Right Mark
+            "\u200F": ":RLM:",    # Right-to-Left Mark
+            "\u2066": ":LRI:",    # Left-to-Right Isolate
+            "\u2067": ":RLI:",    # Right-to-Left Isolate
+            "\u2068": ":FSI:",    # First Strong Isolate
+            "\u2069": ":PDI:",    # Pop Directional Isolate
+            "\u202A": ":LRE:",    # Left-to-Right Embedding
+            "\u202B": ":RLE:",    # Right-to-Left Embedding
+            "\u202C": ":PDF:",    # Pop Directional Formatting
+            "\u202D": ":LRO:",    # Left-to-Right Override
+            "\u202E": ":RLO:",    # Right-to-Left Override
+        }
+        return "".join(replacements.get(ch, ch) for ch in text)
     def get_senders(self, chat_content):
         """Extract all unique senders from chat content."""
         senders = set()
@@ -463,6 +506,8 @@ class MessageParser:
             match = pattern.match(line)
             if match:
                 sender = match.group(2)
+                sender = self.trim_zero_widths(sender)
+                sender = self.mark_invisible_chars(sender)
                 senders.add(sender)
         return sorted(list(senders))
@@ -585,6 +630,8 @@ class MessageParser:
             if match:
                 timestamp, sender, content = match.groups()
+                sender = self.trim_zero_widths(sender)
+                sender = self.mark_invisible_chars(sender)
                 messages.append(Message.create_with_context(
                     timestamp=timestamp,
                     sender=sender,
@@ -610,16 +657,25 @@ class MessageParser:
 class HTMLRenderer(Renderer):
     """Renders messages to HTML format."""
-    def __init__(self, output_dir, has_media=False):
+    def __init__(self, output_dir, has_media=False, embed_media=False, zip_path=None):
         super().__init__(output_dir)
         self.has_media = has_media
+        self.embed_media = embed_media
+        self.zip_path = zip_path
         self.html_filename = 'chat.html'
         self.html_filename_media_linked = 'chat_media_linked.html'
+        if embed_media:
+            # replace .zip with .html
+            self.html_filename = Path(self.zip_path).stem + '.html'
+            self.html_filename_media_linked = None
         self.attachments_to_extract = set()
     def get_generated_files(self) -> list[Path]:
         """Get the generated files."""
-        return [Path(self.output_dir, self.html_filename), Path(self.output_dir, self.html_filename_media_linked)]
+        result = [Path(self.output_dir, self.html_filename)]
+        if self.html_filename_media_linked:
+            result.append(Path(self.output_dir, self.html_filename_media_linked))
+        return result
     def get_css_styles(self):
         """Return the CSS styles for the HTML output."""
@@ -654,6 +710,30 @@ class HTMLRenderer(Renderer):
             border-radius: 5px;
             margin: 5px 0;
         }
+        .text-file {
+            border: 1px solid #ddd;
+            border-radius: 5px;
+            padding: 10px;
+            background-color: #f9f9f9;
+            margin: 5px 0;
+        }
+        .text-file h4 {
+            margin: 0 0 10px 0;
+            color: #333;
+            font-size: 0.9em;
+        }
+        .text-content {
+            background-color: #fff;
+            border: 1px solid #e0e0e0;
+            border-radius: 3px;
+            padding: 10px;
+            font-family: 'Courier New', monospace;
+            font-size: 0.8em;
+            max-height: 300px;
+            overflow-y: auto;
+            white-space: pre-wrap;
+            word-wrap: break-word;
+        }
         .timestamp {
             color: #667781;
             font-size: 0.75em;
@@ -711,6 +791,83 @@ class HTMLRenderer(Renderer):
 </body>
 </html>"""
+    def get_mime_type(self, filename):
+        """Get MIME type based on file extension."""
+        ext = filename.lower()
+        if ext.endswith(('.jpg', '.jpeg')):
+            return 'image/jpeg'
+        elif ext.endswith('.png'):
+            return 'image/png'
+        elif ext.endswith('.gif'):
+            return 'image/gif'
+        elif ext.endswith('.webp'):
+            return 'image/webp'
+        elif ext.endswith('.mp4'):
+            return 'video/mp4'
+        elif ext.endswith('.opus'):
+            return 'audio/ogg'
+        elif ext.endswith('.mp3'):
+            return 'audio/mpeg'
+        elif ext.endswith('.wav'):
+            return 'audio/wav'
+        elif ext.endswith('.m4a'):
+            return 'audio/mp4'
+        elif ext.endswith('.pdf'):
+            return 'application/pdf'
+        elif ext.endswith(('.doc', '.docx')):
+            return 'application/msword'
+        elif ext.endswith(('.xls', '.xlsx')):
+            return 'application/vnd.ms-excel'
+        elif ext.endswith(('.ppt', '.pptx')):
+            return 'application/vnd.ms-powerpoint'
+        elif ext.endswith('.txt'):
+            return 'text/plain'
+        elif ext.endswith('.rtf'):
+            return 'application/rtf'
+        elif ext.endswith('.zip'):
+            return 'application/zip'
+        elif ext.endswith('.rar'):
+            return 'application/x-rar-compressed'
+        elif ext.endswith('.7z'):
+            return 'application/x-7z-compressed'
+        elif ext.endswith('.tar'):
+            return 'application/x-tar'
+        elif ext.endswith('.gz'):
+            return 'application/gzip'
+        elif ext.endswith('.csv'):
+            return 'text/csv'
+        elif ext.endswith('.json'):
+            return 'application/json'
+        elif ext.endswith('.xml'):
+            return 'application/xml'
+        elif ext.endswith('.html'):
+            return 'text/html'
+        elif ext.endswith('.css'):
+            return 'text/css'
+        elif ext.endswith('.js'):
+            return 'application/javascript'
+        elif ext.endswith('.py'):
+            return 'text/x-python'
+        elif ext.endswith('.java'):
+            return 'text/x-java-source'
+        elif ext.endswith(('.cpp', '.c', '.h')):
+            return 'text/x-c'
+        else:
+            return 'application/octet-stream'
+    def encode_media_to_base64(self, attachment_name):
+        """Read media file from zip and encode to base64."""
+        try:
+            with zipfile.ZipFile(self.zip_path, 'r') as zip_ref:
+                with zip_ref.open(attachment_name) as media_file:
+                    media_data = media_file.read()
+                    base64_data = base64.b64encode(media_data).decode('utf-8')
+                    mime_type = self.get_mime_type(attachment_name)
+                    return f"data:{mime_type};base64,{base64_data}"
+        except Exception as e:
+            print(f"Warning: Could not encode {attachment_name} to base64: {e}")
+            return None
     def render_media_element(self, attachment_name, is_media_linked=False):
         """Render a media element based on its file extension."""
         media_path = f"./media/{attachment_name}"
@@ -721,6 +878,32 @@ class HTMLRenderer(Renderer):
         # Render media inline in main version
         ext = attachment_name.lower()
+        # If embed_media is enabled, try to encode as base64
+        if self.embed_media and self.zip_path:
+            base64_data = self.encode_media_to_base64(attachment_name)
+            if base64_data:
+                # Images
+                if ext.endswith(('.jpg', '.jpeg', '.png', '.webp', '.gif')):
+                    return f'<img class="media" src="{base64_data}"><br>'
+                # Videos
+                elif ext.endswith('.mp4'):
+                    return f'<video class="media" controls><source src="{base64_data}" type="video/mp4"></video><br>'
+                # Audio files
+                elif ext.endswith('.opus'):
+                    return f'<audio class="media" controls><source src="{base64_data}" type="audio/ogg"></audio><br>'
+                elif ext.endswith('.wav'):
+                    return f'<audio class="media" controls><source src="{base64_data}" type="audio/wav"></audio><br>'
+                elif ext.endswith('.mp3'):
+                    return f'<audio class="media" controls><source src="{base64_data}" type="audio/mpeg"></audio><br>'
+                elif ext.endswith('.m4a'):
+                    return f'<audio class="media" controls><source src="{base64_data}" type="audio/mp4"></audio><br>'
+                # Other documents - provide download link with base64 data
+                else:
+                    return f'<a href="{base64_data}" download="{attachment_name}">📎 {attachment_name}</a><br>'
+        # Fallback to file references
         if ext.endswith(('.jpg', '.jpeg', '.png', '.webp', '.gif')):
             return f'<img class="media" src="{media_path}"><br>'
         elif ext.endswith('.mp4'):
@@ -796,7 +979,11 @@ class HTMLRenderer(Renderer):
         self.chat = chat
         # Prepare file paths
         main_html_path = os.path.join(self.output_dir, self.html_filename)
-        media_linked_html_path = os.path.join(self.output_dir, self.html_filename_media_linked)
+        if self.html_filename_media_linked:
+            media_linked_html_path = os.path.join(self.output_dir, self.html_filename_media_linked)
+        else:
+            # temp file
+            media_linked_html_path = "_temp.tmp"
         # Open both files for writing
         with open(main_html_path, 'w', encoding='utf-8') as main_f, \
@@ -833,11 +1020,14 @@ class HTMLRenderer(Renderer):
             main_f.write(footer)
             media_f.write(footer)
+        if self.embed_media:
+            os.remove(media_linked_html_path)
         return self.attachments_to_extract
 class ChatExport:
-    def __init__(self, zip_path, from_date=None, until_date=None, participant_name=None, base_output_dir=None):
+    def __init__(self, zip_path, from_date=None, until_date=None, participant_name=None, base_output_dir=None, embed_media=False):
         # Validate zip file existence
         if not os.path.exists(zip_path):
             raise FileNotFoundError(f"Could not find the file: {zip_path}\nPlease check if the file path is correct.")
@@ -851,15 +1041,22 @@ class ChatExport:
         self.from_date = from_date
         self.until_date = until_date
         self.participant_name = participant_name
+        self.embed_media = embed_media
         # Set up output directory: base_output_dir/zip_filename or just zip_filename
         zip_stem = Path(zip_path).stem
-        if base_output_dir:
-            # Normalize the base output directory path (handle Windows paths, quotes, etc.)
-            normalized_base_dir = parse_path(base_output_dir)
-            self.output_dir = os.path.join(normalized_base_dir, zip_stem)
+        if self.embed_media:
+            if base_output_dir:
+                self.output_dir = parse_path(base_output_dir)
+            else:
+                self.output_dir = ""
         else:
-            self.output_dir = zip_stem
+            if base_output_dir:
+                # Normalize the base output directory path (handle Windows paths, quotes, etc.)
+                normalized_base_dir = parse_path(base_output_dir)
+                self.output_dir = os.path.join(normalized_base_dir, zip_stem)
+            else:
+                self.output_dir = zip_stem
         self.media_dir = os.path.join(self.output_dir, "media")
         self.own_name = participant_name
@@ -930,7 +1127,9 @@ class ChatExport:
         # Setup renderer
         self.renderer = HTMLRenderer(
             output_dir=self.output_dir,
-            has_media=self.has_media
+            has_media=self.has_media,
+            embed_media=self.embed_media,
+            zip_path=self.zip_path
         )
     @staticmethod
@@ -969,13 +1168,18 @@ class ChatExport:
         # Get the base name of the zip file without extension
         zip_base_name = Path(self.zip_path).stem
-        if os.path.exists(self.output_dir):
-                print(f"Cleaning existing directory: {self.output_dir}")
-                shutil.rmtree(self.output_dir)
+        # safety: clean only if it's a subfolder with zip_base_name
+        if os.path.exists(self.output_dir) and str(self.output_dir).endswith(zip_base_name):
+            print(f"Cleaning existing directory: {self.output_dir}")
+            shutil.rmtree(self.output_dir)
+        os.makedirs(self.output_dir, exist_ok=True)
+        # if not embed_media, create media directory
+        if not self.embed_media:
         # Create fresh output directories
-        os.makedirs(self.output_dir)
-        os.makedirs(self.media_dir)
+            os.makedirs(self.media_dir)
@@ -1004,7 +1208,9 @@ class ChatExport:
             print(f"ZIP file is an {'iOS' if self.is_ios else 'Android'} export with media/attachments, '{chat_file}' is the chat text file.")
         else:
             print(f"ZIP file is an {'iOS' if self.is_ios else 'Android'} export without media/attachments, '{chat_file}' is the chat text file.")
-            shutil.rmtree(self.media_dir)
+            # delete if exists
+            if os.path.exists(self.media_dir):
+                shutil.rmtree(self.media_dir)
         # Setup modular components now that we know the platform and media status
         self.setup_modular_components()
@@ -1047,7 +1253,7 @@ class ChatExport:
         # Render messages using the new HTMLRenderer
         attachments_to_extract = self.renderer.render(chat)
-        if self.has_media:
+        if self.has_media and not self.embed_media:
             print("Extracting attachments/media...")
             # extract attachments of rendered messages
             with zipfile.ZipFile(self.zip_path, 'r') as zip_ref:
@@ -1055,6 +1261,8 @@ class ChatExport:
                 for file in zip_ref.namelist():
                     if file in attachments_to_extract:
                         zip_ref.extract(file, self.media_dir)
+        elif self.has_media and self.embed_media:
+            print("Media will be embedded as base64 in HTML (no file extraction needed)")
         processing_end_time = time.time()
         print(f"Processing took {processing_end_time - processing_start_time:.3f} seconds")
@@ -1081,13 +1289,16 @@ class ChatExport:
         # Get the base name of the zip file without extension
         zip_base_name = Path(self.zip_path).stem
-        if os.path.exists(self.output_dir):
+        # safety: clean only if it's a subfolder with zip_base_name
+        if os.path.exists(self.output_dir) and str(self.output_dir).endswith(zip_base_name):
             print(f"Cleaning existing directory: {self.output_dir}")
             shutil.rmtree(self.output_dir)
+        os.makedirs(self.output_dir, exist_ok=True)
-        # Create fresh output directories
-        os.makedirs(self.output_dir)
-        os.makedirs(self.media_dir)
+        if not self.embed_media:
+            # Create fresh output directories
+            os.makedirs(self.media_dir)
         # Validate that it's a proper ZIP file
         try:
@@ -1120,7 +1331,10 @@ class ChatExport:
             print(f"ZIP file is an {'iOS' if self.is_ios else 'Android'} export with media/attachments, '{chat_file}' is the chat text file.")
         else:
             print(f"ZIP file is an {'iOS' if self.is_ios else 'Android'} export without media/attachments, '{chat_file}' is the chat text file.")
-            shutil.rmtree(self.media_dir)
+            # delete if exists
+            if os.path.exists(self.media_dir):
+                shutil.rmtree(self.media_dir)
         # Setup modular components now that we know the platform and media status
         self.setup_modular_components()
@@ -1150,7 +1364,7 @@ class ChatExport:
         # Render messages using the new HTMLRenderer
         attachments_to_extract = self.renderer.render(chat)
-        if self.has_media:
+        if self.has_media and not self.embed_media:
             print("Extracting attachments/media...")
             # extract attachments of rendered messages
             with zipfile.ZipFile(self.zip_path, 'r') as zip_ref:
@@ -1158,6 +1372,8 @@ class ChatExport:
                 for file in zip_ref.namelist():
                     if file in attachments_to_extract:
                         zip_ref.extract(file, self.media_dir)
+        elif self.has_media and self.embed_media:
+            print("Media will be embedded as base64 in HTML (no file extraction needed)")
         processing_end_time = time.time()
         print(f"Processing took {processing_end_time - processing_start_time:.3f} seconds")
@@ -1170,7 +1386,7 @@ def check_tkinter_availability():
         root = tk.Tk()
         root.destroy()
         return True
-    except Exception as e:
+    except Exception:
         print("Tkinter is not available on your system. Using prompt input instead of file picker dialog.")
         return False
@@ -1225,7 +1441,7 @@ def main():
             from_date = args.from_date if args.from_date else None
             until_date = args.until_date if args.until_date else None
-            chat_export = ChatExport(args.zip_file, from_date, until_date, args.participant, args.output_dir)
+            chat_export = ChatExport(args.zip_file, from_date, until_date, args.participant, args.output_dir, args.embed_media)
             chat_export.process_chat_non_interactive()
             print(f'Written: {", ".join([str(p.absolute()) for p in chat_export.renderer.get_generated_files()])}')
             print("Done.")
@@ -1253,7 +1469,7 @@ def main():
             if not selected_zip_file:
                 raise FileNotFoundError("No file selected.")
             print(f"Processing selected file: {selected_zip_file}...")
-            chat_export = ChatExport(selected_zip_file, base_output_dir=args.output_dir)
+            chat_export = ChatExport(selected_zip_file, base_output_dir=args.output_dir, embed_media=args.embed_media)
             chat_export.process_chat()
             print(f'Written: {", ".join([str(p.absolute()) for p in chat_export.renderer.get_generated_files()])}')
             print("Done.")

{chat_export-0.9.2 → chat_export-0.9.4}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "chat-export"
-version = "0.9.2"
+version = "0.9.4"
 description = "Convert WhatsApp chat exports to HTML format"
 readme = "README.md"
 license = {file = "LICENSE"}