Since May 25th 2018 all EU citizen have the legal right to get their personal data from the services they use. Most websites now have an automated way to download all your data in a computer readable format (or human readable format). But that data package is often very big and can be a lot to take in.
This repository contains a collection of scripts to parse and explore your GDPR exported data from popular websites.
Currently supports:
- Instagram likes
- Instagram messages
- Facebook Messenger messages
- Twitter Direct Messages
Follow this guide and request the data as JSON. It usually takes a day or two to get the archive.
Warning: if you decide to get the high quality pictures the archive might be really heavy.
Follow this guide. It usually takes a few hours to get the archive.
Follow this guide. It usually takes a few hours to get the archive.
Follow this guide. It usually takes a few minutes to get the archive.
Go to guide. Connect with your Apple Account and answer your security questions. You will then have the ability to request an archive of your data. It usually takes a few days to get the archive.
Go to Google Takeout. Select YouTube and YouTube Music, click on "Multiple formats" and pick JSON in the format selector. It usually takes a few minutes to get the archive.
For Android read this guide.
For iOS read this guide.
You can only export one chat at a time. To use it with this tool please export all the chats you want to a directory and then extract the archives keeping the directories. You should have something like this:
my chat archives/WhatsApp Chat - Conversation 1/_chat.txt
my chat archives/WhatsApp Chat - Conversation 2/_chat.txt
- Ruby 2.5 or more recent
- Clone this repository locally.
- Launch the script you want.
Usage: ruby launch_facebook_messenger.rb [path_to_inbox] [output_directory]
'path_to_inbox' is the path to the Facebook Archive folder named 'messages/inbox'
'output_directory' is the directory where you want the script to output its work
Usage: ruby launch_instagram_messages.rb [path_to_messages] [output_directory]
'path_to_messages' is the path to the Instagram file named 'messages.json'
'output_directory' is the directory where you want the script to output its work```
Usage: ruby launch_twitter_dm.rb [path_to_dms] [output_directory]
'path_to_dms' is the path to the Twitter file named 'direct-messages.js'
'output_directory' is the directory where you want the script to output its work
Usage: ruby launch_youtube.rb [path_to_history] [output_directory]
'path_to_history' is the path to the YouTube file named 'watch-history.json'
'output_directory' is the directory where you want the script to output its work
Usage: ruby launch_whatsapp.rb [path_to_input_directory] [output_directory]
'path_to_input_directory' is the path to the folder containing all message archives of the form 'WhatsApp Chat'
'output_directory' is the directory where you want the script to output its work
Usage: launch_apple_music.rb [path_to_play_activity] [output_directory]
'path_to_play_activity' is the path to the file named 'Apple Music Play Activity.csv'
'output_directory' is the directory where you want the script to output its work