# socialysis
[](https://pypi.org/project/socialysis/)
[](LICENSE)
socialysis is a Python package for analyzing and visualizing Facebook Messenger data. It provides tools for creating and customizing various types of charts and graphs from your Messenger data, such as bar charts, line charts, pie charts, sunburst charts, dot charts, and gantt charts. With socialysis, you can easily gain insights from your Messenger data, including messages, media, links, reacts, photos, audio records, videos, emoji, words and more.
## Installation
`pip install socialysis`
## Getting Started
To use `socialysis`, you first need to download your Facebook Messenger data from Facebook.
To download your Facebook Messenger data, follow these steps:
1. Go to your Facebook settings by clicking the dropdown arrow in the top right corner of the page, and selecting "Settings" from the dropdown menu.
2. In the left-hand menu, click on the "Your Facebook Information" option.
3. In the "Your Facebook Information" section, click on the "Download Your Information" option.
4. In the "Download Your Information" window, select the "Deselect All" button to deselect all data categories.
5. Scroll down to the "Messages" category and click on the "Messages" checkbox to select it.
6. In the "Format" dropdown menu, select the "JSON" option.
7. In the "Media Quality" dropdown menu, select the "Low" option.
8. Click on the "Create File" button to start the download process.
9. Once the download is complete, you will receive a notification and an email with a link to download the file. Click on the download link to download the file to your computer.
10. Extract the downloaded file to obtain the JSON files containing your Messenger data.
### Sample Data
Socialysis includes a sample data set that you can use to get started without needing to download your own Facebook data. To access the sample data, you can use the `restore` parameter when initializing the `Stats` class and set it to `'sample'`. For example:
```python
from socialysis import Stats
stats = Stats(restore='sample')
```
You can then use the `Stats` class and its attributes and modules to analyze the sample data.
## Usage
See [Demos](https://github.com/abdulrahmankhayal/socialysis/tree/master/Demos) for detailed examples with explanations.
## Gallery
Raw data
{
"_id": null,
"home_page": "https://github.com/abdulrahmankhayal/socialysis",
"name": "socialysis",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Facebook Messenger Analysis",
"author": "Abdul-Rahman Khayyal",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/ed/e1/fa53bf4bae63716df36bfc8d5a08d2da3ce6a826d548cdc7a56ddb0e706e/socialysis-0.1.0.tar.gz",
"platform": null,
"description": "# socialysis\n\n[](https://pypi.org/project/socialysis/)\n\n[](LICENSE)\n\n\n\nsocialysis is a Python package for analyzing and visualizing Facebook Messenger data. It provides tools for creating and customizing various types of charts and graphs from your Messenger data, such as bar charts, line charts, pie charts, sunburst charts, dot charts, and gantt charts. With socialysis, you can easily gain insights from your Messenger data, including messages, media, links, reacts, photos, audio records, videos, emoji, words and more.\n\n\n\n## Installation\n\n\n\n\u00a0\u00a0\u00a0\u00a0`pip install socialysis`\n\n \n\n## Getting Started\n\n\n\nTo use `socialysis`, you first need to download your Facebook Messenger data from Facebook.\n\nTo download your Facebook Messenger data, follow these steps:\n\n\n\n1. Go to your Facebook settings by clicking the dropdown arrow in the top right corner of the page, and selecting \"Settings\" from the dropdown menu.\n\n2. In the left-hand menu, click on the \"Your Facebook Information\" option.\n\n3. In the \"Your Facebook Information\" section, click on the \"Download Your Information\" option.\n\n4. In the \"Download Your Information\" window, select the \"Deselect All\" button to deselect all data categories.\n\n5. Scroll down to the \"Messages\" category and click on the \"Messages\" checkbox to select it.\n\n6. In the \"Format\" dropdown menu, select the \"JSON\" option.\n\n7. In the \"Media Quality\" dropdown menu, select the \"Low\" option.\n\n8. Click on the \"Create File\" button to start the download process.\n\n9. Once the download is complete, you will receive a notification and an email with a link to download the file. Click on the download link to download the file to your computer.\n\n10. Extract the downloaded file to obtain the JSON files containing your Messenger data.\n\n\n\n### Sample Data\n\n\n\nSocialysis includes a sample data set that you can use to get started without needing to download your own Facebook data. To access the sample data, you can use the `restore` parameter when initializing the `Stats` class and set it to `'sample'`. For example:\n\n ```python\n\n from socialysis import Stats\n\n stats = Stats(restore='sample')\n\n ```\n\nYou can then use the `Stats` class and its attributes and modules to analyze the sample data.\n\n\n\n## Usage\n\n See [Demos](https://github.com/abdulrahmankhayal/socialysis/tree/master/Demos) for detailed examples with explanations.\n\n \n\n## Gallery\n\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool for analyzing and extracting insights from Facebook Messenger conversations",
"version": "0.1.0",
"split_keywords": [
"facebook",
"messenger",
"analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "20068814529d560ef825afadc217b396",
"sha256": "8c0ef23b2f9a47696bff43d60aca41d100ed50d9ec5b5feb364484c7decb3935"
},
"downloads": -1,
"filename": "socialysis-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "20068814529d560ef825afadc217b396",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 4259714,
"upload_time": "2022-12-10T17:21:00",
"upload_time_iso_8601": "2022-12-10T17:21:00.548451Z",
"url": "https://files.pythonhosted.org/packages/7c/7c/472b754d748a38206c233c0da2f3c25682c9d9213ef481678f6fb455bf95/socialysis-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "755a50437ceec642d6a007a7195aedc4",
"sha256": "7aeba7660248b7af87b92638a9ee52047e1df0a8fc99d2d0298a6c2a581eb644"
},
"downloads": -1,
"filename": "socialysis-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "755a50437ceec642d6a007a7195aedc4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4137505,
"upload_time": "2022-12-10T17:21:38",
"upload_time_iso_8601": "2022-12-10T17:21:38.350526Z",
"url": "https://files.pythonhosted.org/packages/ed/e1/fa53bf4bae63716df36bfc8d5a08d2da3ce6a826d548cdc7a56ddb0e706e/socialysis-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-10 17:21:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "abdulrahmankhayal",
"github_project": "socialysis",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "arabic_reshaper",
"specs": []
},
{
"name": "emoji",
"specs": []
},
{
"name": "imojify",
"specs": []
},
{
"name": "librosa",
"specs": []
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.5.1"
]
]
},
{
"name": "numpy",
"specs": []
},
{
"name": "opencv_python",
"specs": []
},
{
"name": "pandas",
"specs": [
[
">=",
"1.4.1"
]
]
},
{
"name": "Pillow",
"specs": []
},
{
"name": "python_bidi",
"specs": []
},
{
"name": "regex",
"specs": []
},
{
"name": "tldextract",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "wordcloud",
"specs": []
}
],
"lcname": "socialysis"
}
JSON
