{"id":24480871,"url":"https://github.com/ronylpatil/whatsapplib","last_synced_at":"2026-01-02T21:04:38.050Z","repository":{"id":62588862,"uuid":"422158242","full_name":"ronylpatil/whatsapplib","owner":"ronylpatil","description":"WhatsApp Group Chat Analysis Python Package.","archived":false,"fork":false,"pushed_at":"2021-12-08T05:42:25.000Z","size":1781,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-29T17:50:01.097Z","etag":null,"topics":["data-analysis","open-source","pypi-package","python-library","python-package"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/WhatsappLib/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ronylpatil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-28T10:21:04.000Z","updated_at":"2023-01-10T22:45:34.000Z","dependencies_parsed_at":"2022-11-03T17:52:24.651Z","dependency_job_id":null,"html_url":"https://github.com/ronylpatil/whatsapplib","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronylpatil%2Fwhatsapplib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronylpatil%2Fwhatsapplib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronylpatil%2Fwhatsapplib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronylpatil%2Fwhatsapplib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ronylpatil","download_url":"https://codeload.github.com/ronylpatil/whatsapplib/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243624103,"owners_count":20321029,"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":["data-analysis","open-source","pypi-package","python-library","python-package"],"created_at":"2025-01-21T11:17:36.089Z","updated_at":"2026-01-02T21:04:38.002Z","avatar_url":"https://github.com/ronylpatil.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsApp-Analysis Package\n\n##### Profile Visits :\n![Visitors](https://visitor-badge.glitch.me/badge?page_id=ronylpatil.whatsapplib\u0026left_color=lightgrey\u0026right_color=brightgreen\u0026left_text=visitors) \n\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"https://upload.wikimedia.org/wikipedia/commons/6/6b/WhatsApp.svg\" alt=\"Drawing\" style=\"width: 300px;\"\u003e\n\u003c/p\u003e\n\nAs the name suggest \u003cb\u003eWhastsApp-Analyzer\u003c/b\u003e, it is Whatsapp Group Chat analysis package. It will basically \nhelp the programmers to generate \u003cb\u003evisual insights\u003c/b\u003e from the whatsapp group chat. You need to do nothing, just \nexport the group chat and use this package to generate or create beautiful different-different charts.\nHere you do not have to worry about anything, internally it will do everything for you. It will perform \u003cb\u003eETL(Extract-Transform-Load)\u003c/b\u003e and finally generate insights\nin the form of visuals. There are approx. more than 15 methods are available which will help you to generate insights, even you can download each and every insight. \n\nLink : https://pypi.org/project/WhatsappLib/0.0.5/\n\n\u003cb\u003eThe methods are listed below :\u003c/b\u003e\n* \u003cb\u003ebasicStats : \u003c/b\u003e It will return some basic stats of group. Such as total users, total messages, total media messages and total link shared.\n* \u003cb\u003ewordCloud : \u003c/b\u003e It will create a word cloud, through which we can easily understand the most frequent words used in chat.\n* \u003cb\u003emostActiveUsers : \u003c/b\u003e It will create a bar chart for the top-10 most active members in the group.\n* \u003cb\u003emostActiveDay : \u003c/b\u003e It will create a bar chart to show traffic on whatsapp group at each weekdays.\n* \u003cb\u003etopMediaContributor : \u003c/b\u003e It will create bar chart to show top-10 media contributers in the group.\n* \u003cb\u003emaxWordContributers : \u003c/b\u003e It will create bar chart which will show top-10 authors who used max no. of words in their messages.\n* \u003cb\u003emaxURLContributers : \u003c/b\u003e It will create bar chart to show top-10 url contributers in the group.\n* \u003cb\u003emostActiveTime : \u003c/b\u003e It will create bar chart to show the time at which group was highly active.\n* \u003cb\u003emostSuitableHours : \u003c/b\u003e It will create a bar chart to show the best time span at which there may be high chances getting responce from other group members.\n* \u003cb\u003ewordCloud_in : \u003c/b\u003e It will create word cloud of particular individual. You need to just pass user name.\n* \u003cb\u003ehighlyActiveDates : \u003c/b\u003e It will create a bar chart to show highly active top-15 dates.\n* \u003cb\u003etimeseriesAnalysis : \u003c/b\u003e It will plot user interactive time-series plot on traffic at each day.\n* \u003cb\u003eactiveMonthsB : \u003c/b\u003e It will create a bar chart to show most active months on which group was highly active.\n* \u003cb\u003emaxEmojiUsers : \u003c/b\u003e This will plot a bar chart to show top-15 users who used max no. of emojis in group.\n* \u003cb\u003etrafficPerYear : \u003c/b\u003e It will plot a bar chart to show traffic on group per year.\n* \u003cb\u003eactiveMonthsT : \u003c/b\u003e This will create a timeseries plot to show traffic on group per month.\n* \u003cb\u003eweekdaysTraffic : \u003c/b\u003e It will create heat map to show the weekdays traffic along with time span.\n* \u003cb\u003etopEmojis_G : \u003c/b\u003e It will return pandas dataframe of top-20 emojis used by users.\n* \u003cb\u003etopEmojis_I : \u003c/b\u003e It will return top-10 emjois used by individual user.\n* \u003cb\u003esaveDatframe : \u003c/b\u003e It will save the preprocessed data as csv file.\n\n## Installation\nUse the package manager pip to install all the requirements. Just follow the commands below :\n```bash\npip install WhatsappLib==0.0.5\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"whatsapplib.png\" alt=\"Drawing\" style=\"width: 1000px;\"\u003e\n\u003c/p\u003e\n\n## Note\n\u003cb\u003eRemember :\u003c/b\u003e Your data must be in the format as mention below, if not, then try to transform your data in given format. And ya, If your time period is specified as \u003cb\u003eAM'\u0026'PM'\u003c/b\u003e format then you need to change them in lower case \u003cb\u003e'am'\u0026'pm'\u003c/b\u003e format. I will fix this issue and update this package ASAP.\n\u003cdiv style=\"border: 1px solid black;\"\u003e\u003ccenter\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Image.png\" title=\"hover text\"\u003e\n\u003c/p\u003e\u003c/div\u003e\n \n\n## Examples\n```python\n# importing the required libraries\nfrom WhatsappLib.whatsapplib.preprocess import analysis\n\n# you need to do just one simple step, create object of Analyzer class and pass location-\n# of directory as parameter which is mendatory.\nobj = analysis(r'*\\Sample.txt')\n\n# Now use this reference variable (obj) to access this methods.\ntotal_users, total_messages, media_messages, links = obj.basicStats()      # it is returning 4 parameters\nprint('Total No. of users : ', total_users)\nprint('Total No. messages sent : ', total_messages)\nprint('Total No. of media messages sent : ', media_messages)\nprint('Total No. of link shared : ', links)\n\nobj.wordCloud_in(user='+91 83900 8', save_fig='y')\nobj.mostActiveUsers(save_fig='y')\nobj.mostActiveDay(save_fig='y')\nobj.topMediaContributor(save_fig='N')\nobj.maxWordContributers(save_fig='y')\nobj.maxURLContributers(save_fig='N')\nobj.mostActiveTime()\nobj.mostSuitableHours(save_fig='y')\nobj.highlyActiveDates(save_fig='N')\nobj.timeseriesAnalysis(save_fig='y')\nobj.activeMonthsB(save_fig='N')\nobj.maxEmojiUsers(save_fig='y')\nobj.activeMonthsT()\nobj.trafficPerYear(save_fig='N')\nobj.weekdaysTraffic(save_fig='y')\ntop_emojis = obj.topEmojis_G()    # returning pandas dataframe\nobj.saveDatframe()    # saving the dataframe\ntop_emojis_i = obj.topEmojis_I('+91 81*** 00***')    # returning pandas dataframe\n\n# Again Note :) : In some methods you need to pass \"User\" as a parameter which is mandatory, some methods-\n# are taking \"save_fig\" parameter to save the figure in current directory, which is optional, if you want to-\n# download the figure or plot you can tweak the parameter.\n```\n  \n\u003cb\u003eSample Output : \u003c/b\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"/Sample/wp1.png\" alt=\"Drawing\" style=\"width : 900px; height : 500px\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"/Sample/wp4.png\" alt=\"Drawing\" style=\"width : 900px; height : 500px\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"/Sample/wp2.png\" alt=\"Drawing\" style=\"width : 900px; height : 500px\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg class=\"center\" src =\"/Sample/wp3.png\" alt=\"Drawing\" style=\"width : 900px; height : 500px\"\u003e\n\u003c/p\u003e\n\n\u003cb\u003eThis is my small open source contribution to Python's community. Feel free to connect me on \u003ca href=\"https://www.linkedin.com/in/ronylpatil/\"\u003elinkedin\u003c/a\u003e. To check out my amazing blogs click \u003ca href=\"https://www.analyticsvidhya.com/blog/author/ronyl0080/\"\u003ehere\u003c/a\u003e.\u003c/b\u003e\n  \n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.linkedin.com/in/ronylpatil/\"\u003eMade with ❤ by ronil\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronylpatil%2Fwhatsapplib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fronylpatil%2Fwhatsapplib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronylpatil%2Fwhatsapplib/lists"}