Analytics for your Facebook Messenger1 data dump (quantitative metrics and textual analysis)
⚠️ Due to privacy concerns this program is built to be used locally on downloaded data by individuals who have claim to said data
- 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
-
Clone this repository
git clone https://github.com/SirajChokshi/messenger-data-analysis.git
or download as zip. -
Proceed to extract the
facebook-<name>.zip
folder and navigate to the contents ofmessages/
. 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/
-
Install dependencies
pip install -r requirements.txt
-
Proceed to run the script in a Python 3 environment.
NCSA/University of Illinois license. Feel free to fork, remix, share, and incorporate into your own work.
-
not associated, authorized, or endorsed by Facebook. Software and related trademarks regarding Messenger are owned by Facebook
-
this program only requires an
inbox/
folder to function