galatolofederico / chat-miner

Lean parsers and visualizations for chat data

chat-miner: parsing of chat histories

chat-miner parses chat logs into a pandas dataframe. As of now, WhatsApp, Signal, Telegram, and Facebook Messenger export files are supported.

Export chat data

WhatsApp (via mobile app)

Signal (via desktop app)

Telegram (via desktop app)

Facebook Messenger (via mobile app)

Usage

Following code showcases the WhatsAppParser module. The usage of SignalParser, TelegramJsonParser, and FacebookMessengerParser follows the same pattern.

from chatminer.chatparsers import WhatsAppParser

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

Example visualizations

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

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