kordoulakis / messengeranalyzer Goto Github PK

An analyzer of messages
Report Bug · Request Feature

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Example Visualization

An analysis & plotting tool
This software does NOT use networking of any kind

• Python 3
• matplotlib
• NumPy

To get a local copy up and running follow these simple steps.

List:

• Python 3
• matplotlib

python -m pip install -U matplotlib

• NumPy

python -m pip install -U numpy

• Your FB data

see instructions below

1. Clone the repo

git clone https://github.com/ShadehaterCS/MessengerAnalyzer.git

2. Install pip packages

pip install -r requirements.txt

You can use these scripts for structuring, extracting and visualizing your data taken from Facebook's Messenger.

It is indifferent as to how many people there are in a conversation, the plots and DS will work regardless.

The main use of this tool is to plot your data.

To do that, all you need to do is run main.py, input the folder's name where the JSON files are and you'll be presented with the oh so faithful press 1-5 menu.

First of all you'll need to download your data through Facebook. Now, Facebook does allow you to only download your messages but it's a process. For more info on how to do that visit the link below

• https://www.facebook.com/help/1701730696756992?helpref=hc_global_nav
  OR
• facebook.com -> Settings & Privacy -> Settings -> Your Facebook Information -> Access Your Information -> (top of page) download your information
  OR
• https://facebook.com/dyi
• Deselect them all and then select only your Messages if that's all you want.
• Make sure you choose download data as JSON
• Data Range: All of my Data | Format: JSON | Media Quality: that's up to you

Congratulations, you now have your data

• Inside your downloaded .zip you'll see the folders you selected. We're interested in the messages one. Apparently the folders are named with fb username + a random uid.
• Inside every folder you'll see one or more JSON files. Copy that folder and be ready to rename it because you can't be typing that whole thing.

Now go into the repo's folder

• You'll see that there is a folder named MessagesSources.
  That's the folder the script is going to look into to find the folders containing your JSON files for every specific conversation.
  Move your extracted folders inside that one and name it appropriately so there's no confusion for you.

Now you can start Open the folder in your preferred editor and run it through that or simply open terminal / cmd in the repo's folder

• Run python main.py
• Input your folder's name
• The menu will pop up, you can use the available options through your keyboard 1-5 keys
• Success

As per v1 this codebase only supports Facebook's Messenger files and structure.
Some functionality for instagram's messaging will be added.

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.