Home - xante8088/kasa-monitor GitHub Wiki

Kasa Monitor Wiki

Welcome to the Kasa Monitor wiki! This comprehensive guide will help you install, configure, and use Kasa Monitor to track your smart home devices' energy consumption.

Kasa Monitor Logo

Docker Pulls GitHub Release License

📚 Documentation Overview

Getting Started

User Guides

Advanced Topics

Administration

Development

Troubleshooting

🚀 Quick Links

Essential Pages

External Resources

🆕 Latest Release (v1.2.1)

New Features

  • Time Period Selectors - Customizable time ranges for each chart (24h, 7d, 30d, 3m, 6m, 1y, custom)
  • Enhanced Charts - Time-aware formatting and intelligent data aggregation
  • Performance Optimizations - 40% faster load times, 60% more responsive charts
  • Improved API - Time period support with automatic aggregation

Recent Enhancements (v1.2.0)

  • Enhanced Authentication System - Token refresh, structured 401 responses, session management
  • Secure Data Export System - Permission-based exports with audit logging and rate limiting
  • SSL Certificate Persistence - Docker volume support for persistent SSL certificates
  • Device Persistence Fix - Reliable device discovery across Docker updates
  • Comprehensive Audit Logging - GDPR/SOX compliant activity tracking

💡 Features

Core Functionality

  • ✅ Real-time device monitoring
  • ✅ Power consumption tracking
  • ✅ Cost calculation with complex rate structures
  • ✅ Historical data analysis
  • ✅ Multi-user support with roles
  • ✅ Docker support with multiple network modes
  • ✅ Raspberry Pi optimized
  • ✅ Secure data export with retention policies
  • ✅ Session management with token refresh
  • ✅ SSL/TLS with persistent certificate storage

Supported Devices

  • Kasa Smart Plugs (HS103, HS105, HS110, KP115, KP125)
  • Kasa Smart Switches (HS200, HS210, HS220)
  • Kasa Smart Power Strips (HS300, KP303, KP400)
  • Kasa Smart Bulbs (KL110, KL120, KL130, LB100, LB130)

🤝 Community

Getting Help

Contributing

We welcome contributions! See our Contributing Guide to get started.

📄 License

Kasa Monitor is licensed under the GNU General Public License v3.0.


Document Version: 1.2.1
Last Updated: 2025-08-27
Review Status: Current
Change Summary: Updated for v1.2.1 release with time period selectors, performance improvements, and device persistence fixes

⚠️ **GitHub.com Fallback** ⚠️