Skip to content

dotKrad/hass-fpl

Repository files navigation

Florida_Power_ _Light_Logo svg

Features

This integration connects your Florida Power & Light (FPL) account to Home Assistant, providing real-time energy monitoring and billing insights.

📊 Energy Dashboard Integration

Seamlessly integrates with Home Assistant's Energy Dashboard with hourly usage statistics, allowing you to visualize your electricity consumption patterns over time.

💰 Billing & Cost Tracking

Sensor Description
Projected Bill Estimated bill for the current billing period
Bill to Date Current charges accumulated so far
Daily Average Average daily cost
Budget Billing Support for budget billing customers (projected budget bill, deferred amount)

⚡ Usage Monitoring

Sensor Description
Daily Usage Daily kWh consumption and cost
Hourly Usage Hour-by-hour breakdown of usage and cost
Projected kWh Estimated total kWh for the billing period
Bill to Date kWh Total kWh consumed so far

☀️ Solar / Net Metering Support

For customers with solar panels:

  • Net Received kWh – Energy received from the grid
  • Net Delivered kWh – Energy sent back to the grid

📅 Billing Cycle Information

  • Current & next bill dates
  • Service days in billing period
  • Days elapsed / remaining

🏠 Appliance-Level Breakdown

See estimated usage and cost by appliance category:

Category
🌡️ Cooling 🚿 Water Heater 👕 Laundry
🧊 Refrigeration 🏊 Pool 💡 Lighting
📺 Entertainment 🍳 Cooking 📦 Miscellaneous

🌎 Supported Regions

  • FPL Main Region (Full feature support)
  • FPL Northwest Region (Core billing features)

Installation

Option 1: HACS (Recommended)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Or manually add via HACS:

  1. Open HACS in your Home Assistant
  2. Click the menu (top right) → Custom repositories
  3. Add https://github.com/dotKrad/hass-fpl with category Integration
  4. Search for "FPL" and click Download
  5. Restart Home Assistant

Option 2: Manual Installation

  1. Download the custom_components/fpl folder from this repository
  2. Copy it to your Home Assistant config/custom_components/ directory
  3. Restart Home Assistant

Configuration

  1. Go to SettingsDevices & Services
  2. Click + Add Integration
  3. Search for "FPL"
  4. Enter your FPL account credentials

Development

This repo uses uv for Python package dependencies.

  1. Install uv following these instructions.
  2. Run uv venv
  3. Run uv sync --dev
  4. Run ./scripts/develop. This will start Home Assistant locally.
  5. Access HAOS http://localhost:8321
  6. If asked, setup Home Assistant for the first time.
  7. Go to Settings > Device & Services > Add Integrations, and create a new FPL integration.
  8. Make changes to the source code and restart HAOS to take effect.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

About

FPL Component for Home Assistant

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors