You can optionally use any of these flags to perform only certain actions:

The tool will then index your friend list, download friend's profiles, geocode coordinates, and create the map.

env file for use in subsequent runs (eg if you add more friends). On the first run, it'll ask for your Facebook username/password and Mapbox API Key. This is optional if you already have the required packages installed in your environment.

Run pipenv shell to activate the virtual environment.

Run pipenv install to install dependencies.

You'll need this so the tool can geocode city names into coordinates to use on the map.

Make sure that python 3 and pipenv are installed.

Creates friends-map.html, a self-contained, moveable, searchable map of your friends all over the world!Īll data is saved locally in db/data.db as a sqlite database.

Find the lat/long for each location (using Mapbox API) and save to db/points.geojson.

Parse profiles for 'Current City' or 'Address' and add to location list.

Download your friend's profiles (on ) to db/profiles/.

Open your friends list page (on m.) and save to db/friend_list.html.

If the amount or content of the data freaks you (like it did to me!), then it's a good reminder for us all to check our profiles/privacy settings to make sure that we only share what we want others to be able to see.

This tool will only extract the data that your friends have already explicitly made it available to you. I am not responsible for this or any other outcomes that may occur as a result of the use of this software. There is a risk that Facebook may decide to put a temporary or permanent ban on your account (though I haven't heard of this happening to anyone yet).

When using this tool, Facebook can see that you're using an automated tool, which violates their terms. Create a map of your facebook friends! Useful for when you're passing through a city and can't remember all the people you want to grab coffee with.

Facebook friend mapper license key