/messenger-data-analysis

Analytics for your Facebook Messenger data dump

Primary LanguagePythonUniversity of Illinois/NCSA Open Source LicenseNCSA

messenger-data-analysis

Analytics for your Facebook Messenger1 data dump (quantitative metrics and textual analysis)

Usage

⚠️ Due to privacy concerns this program is built to be used locally on downloaded data by individuals who have claim to said data

Downloading Data

  1. To download your Facebook Messenger data follow instructions relevant to your Facebook version as described by the Facebook Help Center.

⚠️ Ensure you have selected the "Messages" category. All other categories can be safely deselected to a users discretion

  1. Clone this repository git clone https://github.com/SirajChokshi/messenger-data-analysis.git or download as zip.

  2. Proceed to extract the facebook-<name>.zip folder and navigate to the contents of messages/. Place the contents of this folder in your clone of this repository2.

Ensure that your file structure looks something like this:

├── 📄 .gitignore
├── 📄 README.md
├── 📄 LICENSE
├── 📄 analyze.py
├── 📄 requirements.txt
├── 📁 inbox/
├── 📁 message_requests/
└── 📁 stickers_used/

Running the program

  1. Install dependencies pip install -r requirements.txt

  2. Proceed to run the script in a Python 3 environment.

Licensing

NCSA/University of Illinois license. Feel free to fork, remix, share, and incorporate into your own work.

Footnotes

  1. not associated, authorized, or endorsed by Facebook. Software and related trademarks regarding Messenger are owned by Facebook

  2. this program only requires an inbox/ folder to function