🎠Emoji Counter 📊¶
Extract and visualize emoji usage from chat messages.
Overview¶
Emoji Counter is a Python tool that helps you:
- Extract emojis from chat message files (Signal, WhatsApp)
- Store them in a SQLite database
- Explore patterns with an interactive dashboard
- Compare emoji usage across different platforms and chats
Key Features¶
- Multi-platform support: Signal (via sigtop) and WhatsApp
- Interactive dashboard: Bar charts, pie charts, and time series visualizations
- Smart filtering: Dynamic user and chat filters that update based on each other
- Multi-database: Combine and compare data from different sources
- Cumulative analysis: Track emoji usage growth over time
Quick Start¶
-
Install dependencies:
uv sync -
Prepare your chat exports (see Getting Started)
-
Extract emojis:
emoji-extract -i messages/ -o data/emojis.sql -
Explore the data:
emoji-explore data/emojis.sql
Open your browser to http://127.0.0.1:8050
Documentation¶
- Getting Started - Installation and setup
- Message Conversion - Converting chat exports to the supported format
- Emoji Extraction - Extracting emojis to SQLite
- Dashboard Usage - Using the interactive visualization dashboard
- Database Schema - Understanding the data structure