{"id":16017216,"url":"https://github.com/lucasrodes/whatstk","last_synced_at":"2025-04-06T12:10:21.638Z","repository":{"id":47144578,"uuid":"75574670","full_name":"lucasrodes/whatstk","owner":"lucasrodes","description":"WhatsApp chats as dataframes. Python toolkit to analyse and parse WhatsApp chats.","archived":false,"fork":false,"pushed_at":"2024-06-30T00:05:20.000Z","size":42535,"stargazers_count":122,"open_issues_count":7,"forks_count":23,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-15T16:16:32.579Z","etag":null,"topics":["machinelearning","pandas","pandas-dataframe","parser","whatsapp","whatsapp-analysis","whatsapp-group","whatsapp-parser","whatsapp-statistics"],"latest_commit_sha":null,"homepage":"https://whatstk.lcsrg.me/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lucasrodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["lucasrodes"]}},"created_at":"2016-12-05T00:44:03.000Z","updated_at":"2024-09-19T10:19:08.000Z","dependencies_parsed_at":"2024-10-25T17:06:47.571Z","dependency_job_id":"8a173900-f3c0-4036-a76a-fe11a0575b33","html_url":"https://github.com/lucasrodes/whatstk","commit_stats":{"total_commits":766,"total_committers":14,"mean_commits":"54.714285714285715","dds":0.237597911227154,"last_synced_commit":"85344f3a316c3ebed36a51a6ffc2ae651dda3a1a"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucasrodes%2Fwhatstk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucasrodes%2Fwhatstk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucasrodes%2Fwhatstk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucasrodes%2Fwhatstk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucasrodes","download_url":"https://codeload.github.com/lucasrodes/whatstk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247478324,"owners_count":20945266,"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":["machinelearning","pandas","pandas-dataframe","parser","whatsapp","whatsapp-analysis","whatsapp-group","whatsapp-parser","whatsapp-statistics"],"created_at":"2024-10-08T16:04:31.828Z","updated_at":"2025-04-06T12:10:21.609Z","avatar_url":"https://github.com/lucasrodes.png","language":"Python","funding_links":["https://github.com/sponsors/lucasrodes"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"left\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/lucasrodes/whatstk/develop/assets/logo.svg\" width=\"70%\"\u003e\n\u003c/div\u003e\n\u003ch1 align=\"left\" style=\"border-bottom: none;\"\u003e whatstk: analyze WhatsApp chats with python\n\u003c/h1\u003e\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"#\"\u003e\n    \u003cimg alt=\"Package version\" src=\"https://img.shields.io/badge/pypi-0.7.1-blue.svg?\u0026color=25D366\u0026logo=whatsapp\u0026\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003c!-- style=for-the-badge --\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://app.travis-ci.com/lucasrodes/whatstk\"\u003e\n    \u003cimg alt=\"Build Status\" src=\"https://app.travis-ci.com/lucasrodes/whatstk.svg?\u0026branch=main\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/lucasrodes/whatstk\"\u003e\n    \u003cimg alt=\"codecov\" src=\"https://codecov.io/gh/lucasrodes/whatstk/branch/master/graph/badge.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href='https://whatstk.readthedocs.io/en/stable/?badge=stable'\u003e\n    \u003cimg src='https://readthedocs.org/projects/whatstk/badge/?version=stable' alt='Documentation Status' /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://towardsdatascience.com/analyzing-whatsapp-chats-with-python-20d62ce7fe2d\"\u003e\n    \u003cimg alt=\"Tutorial\" src=\"https://img.shields.io/badge/tutorial-on_medium-1a8917.svg?\u0026logo=medium\u0026logoColor=white\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.python.org/downloads/release/python-3/\"\u003e\n    \u003cimg alt=\"Python 3\" src=\"https://img.shields.io/badge/python-3.9|3.10|3.11|3.12-blue.svg?\u0026logo=python\u0026logoColor=yellow\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pepy.tech/badge/whatstk\"\u003e\n    \u003cimg alt=\"Number of downloads\" src=\"https://pepy.tech/badge/whatstk\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/lucasrodes/whatstk/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/lucasrodes/whatstk.svg?\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n**Try the [live demo parser](https://whatstk.streamlit.app/) to convert your chats to CSV**\n\n---\n\n\u003c!-- [![Downloads](https://pepy.tech/badge/whatstk)](https://pepy.tech/project/whatstk) --\u003e\n\u003c!-- \u003e [Get the Desktop App](https://lcsrg.me/whatstk-gui) --\u003e\n\n**whatstk** is a python package providing tools to parse, analyze and visualise WhatsApp chats developed under the\n**[sociepy](https://sociepy.org)** project. Easily convert your chats to csv or simply visualise some stats using\nthe provided command-line tools or python. The package uses [pandas](https://github.com/pandas-dev/pandas) to process\nthe data and [plotly](https://github.com/plotly/plotly.py) to visualise it.\n\nIt is distributed under the GPL-3.0 license.\n\n⭐ Please **star** our project if you found it interesting to **give us some dopamine** 😄!\n\n### Content\n\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Documentation](https://whatstk.readthedocs.io/en/stable/)\n- [Contribute](#contribute)\n- [Covered in](#covered-in)\n- [Citation](#citation)\n\n## Installation\n\n```\npip install whatstk\n```\n\nInstall develop version (not stable):\n\n```\npip install git+https://github.com/lucasrodes/whatstk.git@develop\n```\n\n_More details [here](https://whatstk.readthedocs.io/en/stable/source/about.html#installation-compatibility)_\n\n## Getting Started\n\nFor a rapid introduction, check this [tutorial on Medium](https://towardsdatascience.com/analyzing-whatsapp-chats-with-python-20d62ce7fe2d).\n\n#### Export your chat using your phone:\n\n_See [instructions](https://whatstk.readthedocs.io/en/stable/source/getting_started/export_chat.html)._\n\n#### Load chat as a DataFrame\n\n```python\nfrom whatstk import df_from_whatsapp\ndf = df_from_whatsapp(\"path/to/chat.txt\")\n```\n\n**NOTE:** You can now also load directly from a zip chat (iOS export).\n\n#### Convert chat to csv\n\n```bash\n$ whatstk-to-csv [input_filename] [output_filename]\n```\n\n#### More examples\n\n_See more in sections [getting started](https://whatstk.readthedocs.io/en/stable/source/getting_started/index.html) and\n[examples](https://whatstk.readthedocs.io/en/stable/source/code_examples/index.html)._\n\n## Documentation\n\n_See [official documentation](https://whatstk.readthedocs.io/en/stable/)._\n\n## Contribute\n\n_See [contribute section](https://whatstk.readthedocs.io/en/stable/source/contribute.html)._\n\n## License\n\n[GPL-3.0](LICENSE)\n\n## Citation\n\nLucas Rodés-Guirao. \"whatstk, WhatsApp analysis and parsing toolkit\", https://github.com/lucasrodes/whatstk\n\n## Covered in\n\n- [Your Whatsapp Chat History in Cool Graphs](https://deepnote.com/@batmanscode/Your-Whatsapp-Chat-History-in-Cool-Graphs-mQoSsYjUSw29D4nZDs_KwA), by [@batmanscode](https://github.com/batmanscode).\n- [WhatsAppening to the news](https://whatsappening.joltetn.eu/), by [@enric1994](https://github.com/enric1994)\n- [whatsappening source code](https://github.com/enric1994/whatsappening), by [@enric1994](https://github.com/enric1994)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucasrodes%2Fwhatstk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucasrodes%2Fwhatstk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucasrodes%2Fwhatstk/lists"}