Skip to content

KikAnalyzer Version 3.31

Choose a tag to compare

View all tags
@koebbe14 koebbe14 released this 02 Dec 14:56
· 14 commits to main since this release
3.31
b24aee7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Kik Conversation Analyzer

A desktop application for analyzing, tagging, and exporting Kik messenger conversation data with advanced filtering, media handling, and reporting capabilities.

Version

📋 Table of Contents

📖 Description

Kik Conversation Analyzer is a comprehensive desktop application designed for forensic analysis, legal review, and investigation of Kik messenger data exports. The tool provides a powerful graphical interface for loading, searching, tagging, and exporting conversation data with support for media files, keyword highlighting, progress tracking, and customizable reporting.

Key Features

  • 📁 Data Import: Load unzipped Kik data folders with automatic CSV parsing
  • 🔍 Advanced Search: Filter messages by content, sender, receiver, timestamp, or keywords
  • 🏷️ Tagging System: Organize messages with customizable tags (CSAM, Evidence, Of Interest, and custom tags)
  • 📊 Statistics: View detailed conversation statistics including message counts and media tallies
  • 🖼️ Media Handling: View images and videos with thumbnail previews and optional blurring for sensitive content
  • 📤 Export Options: Generate professional HTML or CSV reports with customizable fields and sanitization options
  • ⌨️ Hotkey Support: Customizable keyboard shortcuts for efficient workflow
  • 📝 Notes System: Add and search notes for conversations
  • ✅ Progress Tracking: Mark conversations as reviewed to track analysis progress
  • 🔄 Undo/Redo: Full undo/redo support for tagging operations

🎯 Features

Core Functionality

  • Message Loading & Parsing: Automatically loads and parses Kik CSV data files
  • Conversation Management: Organize conversations by participants or groups
  • Real-time Search: Debounced search with support for exact word matching
  • Date Range Filtering: Filter messages by date range
  • Keyword Highlighting: Highlight messages matching custom keyword lists
  • Media Preview: Thumbnail generation for images and videos
  • Media Blurring: Optional blurring of sensitive media content (CSAM-tagged or all media)

Tagging & Organization

  • Pre-built Tags: CSAM, Evidence, Of Interest (with priority-based color coding)
  • Custom Tags: Create and manage custom tag labels
  • Tag Priorities: Automatic color coding based on tag priority
  • Tag Management: Full CRUD operations for tag labels
  • Tagged Message Views: Filter and view all tagged messages

Export & Reporting

  • HTML Export: Professional HTML reports with embedded media and styling
  • CSV Export: Structured CSV files for data analysis
  • Field Selection: Choose which fields to include in exports
  • Sort Options: Sort by conversation or timestamp
  • Sanitization: Blur CSAM-tagged media or all media in HTML exports
  • File Hashes: Automatic MD5 hash generation for exported media files

Advanced Features

  • Hotkey Management: Assign custom keyboard shortcuts to tags
  • Notes System: Add and search notes for conversations
  • Progress Tracking: Save and load review progress
  • Undo/Redo System: 50-action history for tagging operations
  • Statistics Panel: View conversation-specific or global statistics
  • Keyword Lists: Create and manage multiple keyword lists with whole-word matching
  • Logging: Optional file-based logging for debugging

📸 Screenshots

[NOTE]: Screenshots would be added here by the maintainer. Consider including:

  • Main application window with conversation list
  • Message table with tagged messages
  • Export options dialog
  • Statistics panel
  • Media viewer with blur options

💻 Installation

Windows Executable (Recommended)

  1. Download the latest release from the Releases page
  2. Extract the ZIP file
  3. Run KikAnalyzerV3.31.exe (or the latest version)
  4. No additional installation required

From Source

  1. Clone the repository:

    git clone https://github.com/Koebbe14/Kik-Parser.git
cd Kik-Parser

  2. Install dependencies (see Prerequisites)

  3. Run the application:

    python KikAnalyzerV3.31.py

📦 Prerequisites

For Windows Executable

  • Windows 10 or later
  • No additional software required

For Source Installation

  • Python 3.7 or higher
  • pip (Python package manager)

Python Dependencies

Install required packages using pip:

pip install pandas PyQt5 opencv-python

Or use a requirements file (if provided):

pip install -r requirements.txt

Required Packages:

  • pandas - Data manipulation and CSV handling
  • PyQt5 - GUI framework
  • opencv-python - Image/video processing and blur functionality

Standard Library Modules Used:

  • datetime, os, html, csv, urllib, ssl, webbrowser, logging, collections, json, sys, shutil, hashlib, functools, re

🚀 Usage

Basic Workflow

  1. Launch the Application

    • Double-click the executable or run python KikAnalyzerV3.31.py

  2. Load Kik Data

    • Click "Load New Data" button
    • Select the unzipped Kik data folder (must contain content and logs subfolders)
    • When prompted, select CSV files from the text-msg-data folder

  3. Select a Conversation

    • Use the conversation dropdown to select a conversation or group
    • Messages will appear in the main table

  4. Search and Filter

    • Enter search terms in the search bar
    • Use "Exact Word" checkbox for whole-word matching
    • Use "Search All" to search across all conversations
    • Set date range filters using the date pickers

  5. Tag Messages

    • Select a message in the table
    • Right-click for context menu or use hotkeys (default: Ctrl+1 for CSAM, Ctrl+2 for Evidence, Ctrl+3 for Of Interest)
    • Tags are color-coded in the message table

  6. View Tagged Messages

    • Click "View Tagged" to see all tagged messages
    • Filter by tag type and sort by conversation or timestamp

  7. Export Data

    • Click "Export" button
    • Select export scope (Tagged Messages, Selected Conversation, or All Conversations)
    • Choose format (HTML or CSV)
    • Select fields to include
    • Configure sanitization options if needed
    • Choose output location

Advanced Usage

Managing Keywords

  1. Click "Create Keywords" or "Edit Keywords" button
  2. Create or edit keyword lists
  3. Enable "Whole Word" for exact word matching
  4. Select a keyword list from the dropdown to highlight matching messages
  5. Click "View Keyword Hits" to see all messages matching the selected keyword list

Managing Tags

  1. Click "Manage Tags" button
  2. Add, edit, or remove custom tag labels
  3. Pre-built tags (CSAM, Evidence, Of Interest) cannot be removed but can be customized

Managing Hotkeys

  1. Click "Manage Hotkeys" button
  2. Assign keyboard shortcuts to tags
  3. Default hotkeys:
    • Ctrl+1 - CSAM
    • Ctrl+2 - Evidence
    • Ctrl+3 - Of Interest

Adding Notes

  1. Select a conversation
  2. Click "Manage Notes" button (if available)
  3. Add notes for the conversation
  4. Use search functionality to find conversations with specific notes

Viewing Statistics

  1. Select a conversation
  2. Toggle "Show Stats" button
  3. View statistics for the selected conversation or all conversations
  4. Statistics include message counts, media sent/received, and more

Media Handling

  • View Media: Double-click the "Media" column to open media files
  • Blur Media: Toggle "Blur Media" button to blur all thumbnails in the GUI
  • Export Blurring: Use sanitization options in export dialog to blur media in HTML reports

Progress Tracking

  • Mark as Reviewed: Select a conversation and click "Mark as Reviewed" to track progress
  • Save Progress: Click "Save Progress" to save reviewed conversations and tagged messages
  • Load Progress: Progress is automatically loaded on startup if available

⚙️ Configuration

Configuration File Location

Configuration files are stored in the user's home directory:

  • Windows: C:\Users\<Username>\

Configuration Options

The application automatically saves:

  • Tag definitions (custom tags)
  • Hotkey assignments
  • Keyword lists
  • Logging preferences
  • Window state and preferences

Logging

Logging is disabled by default. To enable:

  1. Open the Help dialog
  2. Check "Enable Logging"
  3. Log file location: %USERPROFILE%\kik_analyzer.log (Windows)

Export Configuration

Export settings are configured per-export via the Export Options dialog:

  • Export Scope: Tagged Messages, Selected Conversation, or All Conversations
  • Format: HTML or CSV
  • Sort By: User/Conversation or Timestamp
  • Fields: Select which fields to include
  • Sanitization: Blur CSAM-tagged media or all media

Reporting Issues

When reporting issues, please include:

  • Application version
  • Operating system and version
  • Steps to reproduce
  • Expected vs. actual behavior
  • Log file (if logging is enabled)
  • Screenshots (if applicable)

📄 License

This software is provided FREE OF CHARGE exclusively to duly authorized law enforcement agencies,
government forensic laboratories, and prosecutors’ offices worldwide for use in official criminal
investigations and prosecutions.

  1. GRANT OF LICENSE
    Subject to the terms and conditions of this License, the copyright holder hereby grants you
    (the "Licensee") a limited, non-exclusive, non-transferable, royalty-free license to:

    • Install and use the software solely for official law-enforcement and forensic purposes.
    • Make a reasonable number of backup copies for archival purposes only.

  2. RESTRICTIONS
    THIS SOFTWARE MAY NOT BE USED BY ANY PERSON OR ENTITY OTHER THAN AUTHORIZED LAW ENFORCEMENT.
    Specifically, you may NOT:

    • Use this software for any private, commercial, academic, journalistic, or personal purpose.
    • Redistribute, sell, lease, sublicense, or otherwise transfer the software to any third party.
    • Modify, reverse-engineer, decompile, or create derivative works of the software.
    • Remove or alter any copyright, trademark, or other proprietary notices.

  3. NO WARRANTY
    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
    INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
    PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
    FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE
    SOFTWARE OR THE USE THEREOF.

  4. LAW ENFORCEMENT VERIFICATION
    By installing or using this software, the Licensee represents and warrants that they are an
    authorized representative of a bona fide law enforcement or government forensic agency acting
    within the scope of their official duties.

  5. TERMINATION
    This license automatically terminates if you violate any of its terms. Upon termination,
    you must immediately cease all use and destroy all copies of the software.

  6. GOVERNING LAW
    This license shall be governed by the laws of [Your State/Country, e.g., the State of Illinois, United States].

Contact: Patrick.Koebbe@gmail.com for verification, support, or to report misuse.

— End of License —

👤 Credits

Author

Patrick Koebbe

Repository

Acknowledgments

  • Built with PyQt5
  • Uses pandas for data manipulation
  • Uses OpenCV for image/video processing

Version History

  • v3.31 - Current version (filename indicates 3.31, code shows 3.29)
  • Previous versions available on GitHub Releases

📞 Support

For support, bug reports, or feature requests:

Last Updated: 2025
Version: 3.31

Assets 5
Loading