/chat-miner

Lean parsers and visualizations for chat data

Primary LanguagePythonMIT LicenseMIT

Getting your data

As of now, only WhatsApp and Signal chats are supported.

Steps to export a WhatsApp chat:

  • Go to the app
  • Go to Settings/Chats/Chat History
  • Tap Export chat
  • Select the chat you want to export

Steps to export a Signal chat (from Signal-Desktop):

  • Open a Terminal
  • Run pip install signal-export (This will install signal-export on your computer)
  • Run sigexport ~/signal-chats (This saves the Signal chats in ~/signal-chats)

Parsing the chatfile

The following code uses the WhatsAppParser module to:

  • Read a chatfile
  • Infer its datetime format
  • Parse its content into a DataFrame
  • Add additonal metadata columns
from chatminer.chatparsers import WhatsAppParser

parser = WhatsAppParser(FILEPATH)
parser.parse_file_into_df()
print(parser.df.describe())

Creating Visualizations

Sunburst Chart

import chatminer.visualizations as vis
vis.sunburst(parser.df)

Sunburst

Wordcloud

import chatminer.visualizations as vis
stopwords = ['media', 'omitted', 'missed', 'voice', 'call']
vis.wordcloud(parser.df, stopwords)

Wordcloud