facebook-archive

Analyse everything facebook knows about you, through their own archive.

In light of the recent facebook's data breach, Mark Zuckerberg made all the data available for each user via Facebook. You're going to need to download it, we'll get to it shortly. There are some things that would take a lot of time (too costly API calls) online, but can be easily done on archived data.

Note to KWoC contributors: All issues are available for KWoC, feel free to work on any issue after being assigned.

Table of Contents

• facebook-archive
  • Table of Contents
  • Getting the data
  • Usage
    • Friends
    • Messages
    • Locations
  • Contributing
  • Features
    • Your friends
    • Your Messages
    • Friend Request
    • Your reactions
    • Your posts and comments
    • Your locations
  • Observations
  • Why
  • License

Getting the data

1. Head on to Facebook > Settings > General Settings > Your facebook information.
2. Select the JSON data format and click on download archive. It might take some time to prepare the archive, this might take upto 10-15 minutes. NOTE: The download might be in order of 100s MBs. Disable photo and video download options to save some bandwidth. (My archive was ~300MB).
3. If possible, download the same data in HTML format. It is much easier to browse through your archive and spot some interesting patterns in the HTML format, however this is not necessary. The JSON format will suffice for processing, refer #2.

↥ back to top

Usage

Install requirements with pip install -r requirements.txt

Friends

python plot_friends.py [path] [--from date] [--to date]

• path is the path to the facebook data archive
• --from date specify the beginning of the plot
• --to date specify the end of the plot
• date string is in format YYYY-MM-DD

> python plot_friends.py
Enter facebook archive extracted location: <location of extracted data folder,  e.g.: "facebook-kaustubhhiware">

You can also run the script on sample data included in the examples folder:

> python plot_friends.py
Enter facebook archive extracted location: ./examples

↥ back to top

Messages

Will be updated soon

• Plot messages across all conversations.

> python plot_messages.py
Enter facebook archive extracted location: "location of extracted, downloaded zip: like facebook-kaustubhhiware" 

Locations

Will be updated soon

• Plot your location history.

> python where_have_you_been.py 
Enter facebook archive extracted location: "location of extracted, downloaded zip: like facebook-kaustubhhiware" 

↥ back to top

Contributing

Your contributions are always welcome :smile: ! Please have a look at the contribution guidelines first.

Before working on an issue / feature, it is crucial that you're assigned the task on a GitHub issue.

• If a relevant issue already exists, discuss on the issue and get yourself assigned on GitHub.
• If no relevant issue exists, open a new issue and get it assigned to yourself on GitHub. Please proceed with a Pull Request only after you're assigned. It'd be a waste of your time as well as ours if you have not contacted us before hand when working on some feature / issue.

If you are here for GirlScript's Summer of Code and wish to seek assistance, feel free to contact any of the mentors on slack - @kaustubhhiware, @techytushar, @Anubhav, @fhackdroid, @Roopal.

↥ back to top

Features

(Click to expand)

Your friends

Plot the friends you make every day (blue), and the friends so far (orange).

↥ back to top

Your Messages

The following is available for either a specific chat (person / group) or for all messages.

Plot all messages so far,

↥ back to top

Top_10_friends_whom_I_message and Top_10_friends_who_message_me

Find the top ten friends whom you message and plot each friends no. of messages as a function of time https://github.com/hadesanirban/facebook-archive/tree/master/images/Top_10_Friends_whom_I_message

• Plot Top_ten_Friends.

> python plot Top_ten_Friends.py --num_friends 7 (for example)
enter your official facebook name: "your name as in facebook i.e. Anirban Panda"
Enter facebook archive extracted location: "location of extracted, downloaded zip: like facebook-kaustubhhiware"

Also added a new command line argument named num_friends which helps you to plot as many friends as you want but default value is set to 10.

Friend Request

Plot the friends you make every day(Red) ,friend request send every day(green) and friend request received every day(blue)

Your reactions

Plot count of different reactions to posts

↥ back to top

Your posts and comments

Wordcloud of common words in your posts and comments

Your Locations

Plot all locations so far,

↥ back to top

Observations

1. There is a spike in friends made in March (Election season) and July (new juniors, much higher spike).

2. I tend to message less during exams (Feb, Apr, Sep, Nov).

3. Highest number of messages sent at 9 and 11 pm, confirming with calls from home come at 10pm. Almost no messages shared between 3am-7am.

4. I used to send more friend request as compared to friend request received.

5. I tend to receive more friend request in the month of july,august(new juniors)

↥ back to top

Why

I always wanted to know how many friends I make every month. It would have been infeasible to make a webapp out of this because so many API calls would be so slow, and whosoever wants to work with Facebook's Graph API?

Plus it was raining and I couldn't go to MS's Hall Day till after the rain stopped.

Have a feature request? See an interesting avenue not utilised yet with facebook's archive? Let me know by making a new issue.

↥ back to top

License

The MIT License (MIT) 2018 - Kaustubh Hiware. Please have a look at the LICENSE for more details.