Skip to content

Clearmist/google-voice-transformer

Repository files navigation

google-voice-transformer

This application transforms your Google Voice text messages to much more readable formats.

Features

  • Combines all messages, per user, into single files so you can finally search through your messages.
  • Correctly displays media files instead of simply presenting the user with a link to the media file.
  • Converts all video files to mp4.
  • Groups all messages by the full date.
  • Fixes the references to media files in your messages. Google does not include the file extension in the anchor tag. Google also references broken filenames due to having truncated long filenames in the html source.

Screenshots

Requirements

Your Google Takeout data. Make sure that it includes your Google Voice data. Extract the archive and save the Takeout directory to disk.

Test Image 3

Usage

Usage: google-voice-transformer [options]

Convert the Google Takeout format to a more readable format.

Options:
  -V, --version      output the version number
  --path <string>    (optional) The path to your Takeout folder. The program will look for this folder in the same
                     directory
  --template <type>  (optional) The output file template (choices: "default", "whatsapp")
  -h, --help         display help for command

This application is ran from the command line. The options are optional. An output folder will be created in the directory this application is ran.

--path: if you leave this empty the application will default to looking for your Takeout folder in the same directory from which this application was ran.

--template: if you leave this empty the application will use a style similar to Google Voice.

Command line examples

Default template with the Takeout folder in the same directory.

.\gvt-win.exe

WhatsApp template with the Takeout folder in the same directory.

.\gvt-win.exe --template whatsapp

WhatsApp template with the Takeout folder on another drive.

.\gvt-win.exe --template whatsapp --path D:\Takeout

Issues

  • If you have messages that are more than a decade old it is normal to see a warning on the command line about missing media files. This is due to Google not including your very old media files into the Takeout archive.