{"id":13910800,"url":"https://github.com/simonwongwong/Facebook-Messenger-Statistics","last_synced_at":"2025-07-18T10:31:05.406Z","repository":{"id":40122538,"uuid":"131183805","full_name":"simonwongwong/Facebook-Messenger-Statistics","owner":"simonwongwong","description":"Discover fun stats about your Facebook Messenger usage such as: most used words, most active year, most active hours, etc. using this Jupyter Notebook","archived":false,"fork":false,"pushed_at":"2022-07-30T18:55:54.000Z","size":9827,"stargazers_count":86,"open_issues_count":7,"forks_count":18,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-08-08T00:44:13.396Z","etag":null,"topics":["analytics","facebook","facebook-messenger","jupyter-notebook","metrics","python","statistics"],"latest_commit_sha":null,"homepage":"https://simonwong.io/sample_report.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonwongwong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-26T16:38:11.000Z","updated_at":"2024-06-18T21:27:36.000Z","dependencies_parsed_at":"2022-06-26T18:33:11.936Z","dependency_job_id":null,"html_url":"https://github.com/simonwongwong/Facebook-Messenger-Statistics","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonwongwong%2FFacebook-Messenger-Statistics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonwongwong%2FFacebook-Messenger-Statistics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonwongwong%2FFacebook-Messenger-Statistics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonwongwong%2FFacebook-Messenger-Statistics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonwongwong","download_url":"https://codeload.github.com/simonwongwong/Facebook-Messenger-Statistics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226388776,"owners_count":17617329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","facebook","facebook-messenger","jupyter-notebook","metrics","python","statistics"],"created_at":"2024-08-07T00:01:46.045Z","updated_at":"2024-11-25T19:32:04.597Z","avatar_url":"https://github.com/simonwongwong.png","language":"Python","funding_links":[],"categories":["Python","Social Media"],"sub_categories":["Weather"],"readme":"# Facebook Messenger Statistics\nHave you downloaded your Facebook data? Are you curious/concerned about your Messenger usage?\nDiscover fun stats about your Facebook Messenger usage such as: most used words, most active year, most active hours, etc.\n\nPlots can be created using a Jupyter Notebook for exploratory analysis or a basic HTML report can be generated using the `generate_report.py` script.\n\n![demo](pictures/demo.gif)\n\nFor **instructions** [scroll down](#how-to-use)\n\n# Example Report\nAn interactive sample report can be found on [my website](https://simonwong.io/sample_report.html)\n![report](pictures/screenshot.png)\n\n# How to use\n## Download your Messenger data from Facebook\nDownload your Facebook Messenger data [in your settings page](https://www.facebook.com/settings)\n![facebook settings](pictures/download.png)\n\nMake sure to download in JSON format. Media quality can be set to low for a faster download\n![download](pictures/download_page.PNG)\n## Clone this repository\nClone this repo using:\n```\ngit clone git@github.com:simonwongwong/Facebook-Messenger-Statistics.git\n```\nAnd open the folder/navigate to the directory\n## Install Python and Python libraries\n\n1. If you don't have Python, install Python 3.7+\n2. Open a console on the project directory (or create your own custom environment) and run:\n```\npip install -r \"requirements.txt\"\n```\n\n## Generate an HTML report\nRun the `generate_report.py` script either using your terminal or double-click the file on Windows\n\nLocate your `inbox` folder from your extracted Facebook data using the file dialog. This folder should contain more folders for each chat and each of those folders should contain a `message_1.json` file.\n![filedialog](pictures/file_dialog.png)\n\nIf it runs successfully, you should receive a message similar to:\n```\nParsing data from C:/Users/Simon/Desktop/messages/inbox\nReport generated successfully!\n```\nAnd an HTML report should be at your current working directory.\n\n## Exploratory analysis on Jupyter\nOpen a console in the folder and start Jupyter Notebook using `jupyter notebook` command.\nFrom the Notebook file tree, open the Statistics notebook `Statistics.ipynb`\n\n![notebook](pictures/notebook.png)\n\nMake sure the correct directory is passed into `loader.parse_from_json()` and then have fun!\n\nSee `chatstat.py` or docstrings for parameters you can play with in the plot generators. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonwongwong%2FFacebook-Messenger-Statistics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonwongwong%2FFacebook-Messenger-Statistics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonwongwong%2FFacebook-Messenger-Statistics/lists"}