# Home Assistant Custom Integrations

A collection of custom Home Assistant integrations for various services and devices.

[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)

## Available Integrations

### 🪙 Strike Bitcoin Sensor

Real-time Bitcoin price tracking using the Strike API.

**Features:**
- Real-time BTC price monitoring
- Configurable currency pairs
- Customizable update intervals
- Secure API key storage
- Home Assistant UI configuration

**[Documentation](integrations/strike/)** | **[Installation Guide](integrations/strike/README.md#installation)**

## Installation

### HACS (Recommended)

Each integration in this repository is available through HACS as a custom repository.

1. Open HACS in your Home Assistant instance
2. Click on "Integrations"
3. Click the three dots in the top right corner
4. Select "Custom repositories"
5. Add the repository URL for the specific integration:
   - Strike: `https://git.martien.io/Martien/hass-to-be-good` (then navigate to integrations/strike)
6. Select category: "Integration"
7. Click "Add"
8. Search for the integration name in HACS
9. Click "Download"
10. Restart Home Assistant

### Manual Installation

1. Navigate to the specific integration folder (e.g., `integrations/strike/`)
2. Copy the `custom_components/<integration_name>` folder to your Home Assistant `custom_components` directory
3. Restart Home Assistant
4. Follow the integration-specific setup instructions

## Repository Structure

```
hass-to-be-good/
├── README.md                    # This file
├── .gitignore
└── integrations/
    └── strike/                  # Strike Bitcoin integration
        ├── README.md            # Integration documentation
        ├── hacs.json            # HACS configuration
        └── custom_components/
            └── strike/          # Integration code
                ├── __init__.py
                ├── config_flow.py
                ├── const.py
                ├── manifest.json
                └── sensor.py
```

## Contributing

Contributions are welcome! To add a new integration or improve existing ones:

1. Fork the repository
2. Create a feature branch
3. Add your integration in the `integrations/` directory following the existing structure
4. Include proper documentation (README.md, hacs.json, etc.)
5. Submit a pull request

### Integration Guidelines

Each integration should:
- Be in its own folder under `integrations/`
- Include a `README.md` with installation and usage instructions
- Include a `hacs.json` configuration file
- Follow Home Assistant development best practices
- Include proper error handling and logging
- Use async/await patterns
- Include type hints and docstrings

## Support

For issues, questions, or feature requests:

- Open an issue on [Gitea](https://git.martien.io/Martien/hass-to-be-good/issues)
- Check existing issues for solutions
- Include integration name in issue title
- Provide Home Assistant logs when reporting bugs

## License

This project is provided as-is for educational and personal use.

## Acknowledgments

- Built for [Home Assistant](https://www.home-assistant.io/)
- Follows [Home Assistant integration development guidelines](https://developers.home-assistant.io/)