Skip to content

README.md

Latest commit

 

History

History
77 lines (60 loc) · 1.6 KB

README.md

File metadata and controls

77 lines (60 loc) · 1.6 KB

heatmouse

Mouse Analytics Heatmap Tool

Example of a created dashboard

dashboard_20250617_182154

Setup

Step 1: Create Project Directory

mkdir mouse-analytics
cd mouse-analytics

Step 2: Create Virtual Environment

Windows:

python -m venv mouse_env
mouse_env\Scripts\activate

macOS/Linux:

python3 -m venv mouse_env
source mouse_env/bin/activate

Step 3: Install Dependencies

pip install pynput matplotlib numpy scipy seaborn

Step 4: Save the Script

  • Copy the Python script to a file named mouse_analytics.py
  • Place it in your mouse-analytics folder

Step 5: Run the Tool

python main.py

System-Specific Requirements

Windows

  • No additional setup required
  • Windows Defender might ask for permissions

macOS

  • Important: You'll need to grant accessibility permissions
  • Go to: System Preferences → Security & Privacy → Privacy → Accessibility
  • Add Terminal (or your Python IDE) to the list of allowed applications
  • You might also need to add Python itself

Linux

  • Install tkinter if not already available: 
    sudo apt install python3-tk
  • For some distributions, you might need: 
    sudo apt install python3-dev

Troubleshooting

Permission Issues (macOS)

If you get permission errors:

  1. Open System Preferences
  2. Go to Security & Privacy → Privacy
  3. Click on "Accessibility" or "Input Monitoring"
  4. Click the lock to make changes
  5. Add your terminal application or Python