Movement Mapper (formerly Matter Activity Logger) is a local-first activity logging and visualization tool designed for smart home motion sensors (specifically Tapo P100/T100 series). It allows you to track, visualize, and analyze movement patterns within your home without relying on cloud dashboards.
- Real-time Activity Logging: Connects directly to your Tapo Hub to capture motion events in real-time.
- Interactive Heatmap: Visualize activity intensity by hour and day of the week with dynamic color gradients.
- Aggregate View: Combine data from multiple weeks to identify consistent routines and long-term trends.
- Sum Mode: In Aggregate View, toggle "Sum Mode" to see the total activity count for each hour, providing a clear heat-map of high-traffic times.
- Data Adjustments: Manually adjust data points to correct false positives or anomalies directly from the dashboard, with visual indicators for adjusted cells.
- Sensor Visibility Management: Show or hide individual sensors from the main display while retaining their data.
- Demo Data Generation: Generate realistic demo data with weekday/weekend patterns for testing and demonstration purposes.
- Sensor Management: Manually refresh sensor list to detect newly added devices immediately.
- Diagnostics: View backend logs directly from the settings panel for troubleshooting.
- Privacy Focused: All data is stored locally in a SQLite database. No external cloud dependency for data storage.
- Clean Codebase: Refactored with helper functions to reduce duplication and improve maintainability.
For detailed installation, hardware requirements, and configuration instructions, please refer to the Setup Guide.
-
Ensure you have the prerequisites installed (Python 3, Node.js).
-
Run the startup script:
./start.sh
-
Open your browser to
http://localhost:5173. -
Click Settings to configure your Tapo Hub credentials.
- Backend: Python, FastAPI, SQLAlchemy, SQLite
- Frontend: React, Vite, TailwindCSS
- Integration:
tapo-pylibrary for direct hub communication
This project is built on top of several excellent open-source libraries:
- tapo-py - Python library for Tapo device integration by Mihai Dinculescu
- FastAPI - Modern, fast web framework for building APIs
- React - JavaScript library for building user interfaces
- Vite - Next generation frontend tooling
- TailwindCSS - Utility-first CSS framework
- SQLAlchemy - Python SQL toolkit and ORM
Special thanks to the Tapo community for reverse-engineering the protocol and making local control possible.
MIT