An open API service indexing awesome lists of open source software.

https://github.com/arevindh/ha-tinxy-cloud

Tinxy Home Assistant Integration ( Cloud Based )
https://github.com/arevindh/ha-tinxy-cloud

hacs-integration home-assistant homeassistant-integration tinxy

Last synced: 5 months ago
JSON representation

Tinxy Home Assistant Integration ( Cloud Based )

Awesome Lists containing this project

README

          

# Tinxy Home Assistant Integration

Integrate [Tinxy.in](https://tinxy.in/) smart switches and devices with Home Assistant using this custom component.

Join [Discord server](https://discord.gg/VH4jgz2f) for support.

## Overview

This repository provides a Home Assistant integration for Tinxy smart devices, allowing you to control switches, fans, lights, and locks directly from Home Assistant.

## Installation

### 1. Install HACS
HACS is a community app store for Home Assistant. Follow the [HACS setup guide](https://hacs.xyz/docs/setup/prerequisites) to install.

### 2. Add Repository to HACS
Once HACS is installed:
1. Navigate to **HACS → Integrations**.

2. Click the three dots at the top right and select **Custom repositories**.

3. Paste `https://github.com/arevindh/ha-tinxy-cloud`, select **Integration**, and click **Add**.

4. Close the Custom repositories section.
5. Click **Explore & Download** at the bottom right.
![image](https://user-images.githubusercontent.com/693151/220522243-48b85c0f-59ff-45f6-b664-37157eb1ec15.png)
6. Search for `Tinxy`, then add and install it.
7. Restart Home Assistant.

## Usage

1. **Get API Key:**
- Obtain your API key from the Tinxy mobile application.
2. **Configure Integration:**
- Go to **Settings → Integrations** in Home Assistant.
- Search for "Tinxy" and click on it.
- ![screen-1](https://user-images.githubusercontent.com/693151/220121949-4f48a2ad-bae5-42e9-9167-b6bc8f524251.png)
- Enter your API key and click **Submit**.
- ![screen-2](https://user-images.githubusercontent.com/693151/220121597-624f3abf-2d28-4ca9-8764-0fb9e819e138.png)
- Click **Finish** on the next screen.
- You can find all devices in the integration screen.

## Configuration

- You can adjust the `scan_interval` parameter to change how often device status is updated. It is recommended to keep this above `7` seconds to avoid slowing down your Home Assistant server.

## Known Issues

- Due to response delays from the Tinxy API, toggling devices may have a delay of approximately 3 seconds.

## License

See [LICENSE](LICENSE) for details.