python analytical toolkit to analyse WhatsApp group chat logs using unsupervised learning.
Branch: master
Clone or download
Latest commit b4c51a9 Oct 10, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
chats update Jan 29, 2018
notebooks Delete Wordclouds.ipynb Jan 22, 2018
whatstk update Mar 22, 2018
.gitignore .gitignore Jul 23, 2017
CODE_OF_CONDUCT.md create code of conduct Jul 24, 2017
COPYING update Apr 25, 2017
README.md
install_dependencies.sh Revert "Prepare repository to be installed as a package via pip" Jun 1, 2018
requirements.txt Revert "Prepare repository to be installed as a package via pip" Jun 1, 2018
supported_headers.md

README.md

🚧 👷 I am currently busy and hardly find time to mantain this repository. However I am willing to push a major code refactoring along with official documentation by end 2018. If anyone feels like helping please contact me.


whatstk

whatstk is a Python module for WhatsApp chat group analysis and distributed under the GPL-3.0 license.

The project was started in December 2016 by lucasrodes and albertaparicio.

⭐️ Please star our project if you found it interesting to keep us motivated 😃!

Installation

First download the repo.

$ git clone https://github.com/lucasrodes/whatstk.git
$ cd whatstk

It is assumed that you are using Python 3. Next, you can install all its dependencies by running

$ bash install_dependencies.sh

This creates a virtual environment named .whatstk and installs all the python libraries required in the project. You can now start the virtual environment by running

$ source .whatstk/bin/activate

Find more details in install_dependencies.sh. This is due to your directory being located within a path with spaces (more info here). Please use a path without spaces!

Known issues

Header Support

The header of the chat log texts varies depending on your phone settings. We are making our best to provide support for all of them, but some might not be yet covered. Please check the list of supported headers in this thread and comment if your header format is not supported!

Installation: bad interpreter

While running the installation, you might encounter an error like

bad interpreter: No such file or directory

This is due to your directory being located within a path with spaces (more info here). Please use a path without spaces!

Contribute

If you have any suggestion or you found any bug in the code please report it as an Issue or text me. Furthermore, we are open to pull requests from the community!

License

whatstk

Copyright (C) 2016-2018 Lucas Rodés-Guirao, Albert Aparicio Isarn

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.