GamerPower Giveaways for Home Assistant 🎮

Never miss a free game again! A powerful Home Assistant integration that tracks active giveaways across all major gaming platforms.

---

🚀 Overview

GamerPower Giveaways is a custom integration for Home Assistant that automatically monitors platforms like Epic Games, Steam, GOG, and consoles for free games and loot. Powered by the GamerPower API, it brings real-time alerts and detailed sensors to your smart home dashboard.

✨ Key Features

• 🎮 Universal Tracking: Automatically fetch active giveaways from PC, PlayStation, Xbox, Switch, and Mobile.
• 🔍 Granular Filtering: Filter by specific platforms (Steam, Epic, GOG, etc.) and giveaway types (Full Games, Loot, Beta Access).
• 💰 Value Estimation: Track the total "Worth" of active giveaways in your sensors.
• 🔔 Instant Alerts: Trigger Home Assistant notifications as soon as a new free game is detected.
• ⏱️ Efficient Polling: Fully configurable update intervals (from 5 minutes to 24 hours).
• 📊 Rich UI: Comes with pre-configured attributes for easy display in Lovelace cards.

🛠️ Tech Stack

• Platform: Home Assistant
• Language: Python
• API: GamerPower.com
• Installation: HACS compatible

📦 Installation

Option 1: HACS (Recommended)

1. In Home Assistant, go to HACS → Integrations.
2. Click the three dots in the top right corner and select Custom repositories.
3. Paste https://github.com/Teeflo/ha-gamerpower and select Integration as the category.
4. Click Install, then Restart Home Assistant.

Option 2: Manual

1. Download the latest release.
2. Copy the custom_components/gamerpower folder into your Home Assistant config/custom_components/ directory.
3. Restart Home Assistant.

⚙️ Configuration

1. Navigate to Settings → Devices & Services.
2. Click Add Integration and search for "GamerPower Giveaways".
3. Follow the config flow to select your preferred platforms and sync interval.

📊 Available Sensors

Entity	Description
sensor.gamerpower_total_giveaways	Count of currently active giveaways.
sensor.gamerpower_total_worth	Cumulative value of all free items in USD.
sensor.gamerpower_latest_giveaway	Details of the most recently added giveaway.
sensor.gamerpower_active_giveaways_list	A complete list of giveaways with metadata.

🤖 Automation Example

Mobile Notification for New Free Games

alias: "Notification: New Free Game"
trigger:
  - platform: state
    entity_id: sensor.gamerpower_latest_giveaway
condition:
  - condition: template
    value_template: "{{ trigger.from_state.state != trigger.to_state.state }}"
action:
  - service: notify.mobile_app
    data:
      title: "🎮 New Free Game Alert!"
      message: "Grab '{{ state_attr('sensor.gamerpower_latest_giveaway', 'title') }}' for free!"
      data:
        url: "{{ state_attr('sensor.gamerpower_latest_giveaway', 'open_giveaway_url') }}"

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for the Home Assistant Community.