Google Voice HTML to CSV Converter

This tool converts Google Voice HTML exports (SMS messages and call logs) into a single CSV file that can be viewed in any spreadsheet program.

Features

• Processes both SMS messages and call logs from Google Voice HTML exports
• Extracts timestamps, contact information, message content, and call details
• Consolidates all communication into a chronologically sorted spreadsheet
• Works with standard Google Voice HTML export format
• Simple command-line interface with minimal dependencies

Requirements

• Python 3.6 or newer
• BeautifulSoup4 library (pip install beautifulsoup4)

Installation

1. Clone this repository or download the script:

git clone https://github.com/yourusername/google-voice-converter.git
# OR
wget https://raw.githubusercontent.com/yourusername/google-voice-converter/main/google_voice_converter.py

2. Install the required dependency:

pip install beautifulsoup4

Usage

1. Place the script in the same directory as your Google Voice HTML files
2. Run the script:

python google_voice_converter.py

3. Find the resulting CSV file (google_voice_combined.csv) in the same directory

Options

You can modify the following variables in the script:

• input_directory - Path to the directory containing HTML files (default: current directory)
• output_csv - Name of the output CSV file (default: "google_voice_combined.csv")

How It Works

The script:

1. Detects and processes all HTML files in the specified directory
2. Identifies whether each file contains SMS messages or call logs
3. Extracts relevant data from each file using BeautifulSoup4
4. Combines all data into a single list of messages/calls
5. Sorts the combined data chronologically
6. Outputs the data to a CSV file

Output Format

The CSV file contains the following columns:

• timestamp - ISO format timestamp from the HTML
• readable_time - Human-readable time string
• type - Communication type (SMS, Missed Call, Placed Call, Received Call)
• direction - Direction of communication (incoming/outgoing)
• contact - Name of the contact
• phone_number - Phone number associated with the contact
• body - Message content or call description
• file_name - Source HTML file name

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.