🏪 Fina Plugins Market

¡Bienvenido al mercado oficial de plugins para Fina Ergen! Aquí puedes encontrar extensiones comunitarias para controlar tus dispositivos y añadir nuevas capacidades a la IA.

---

📂 Catálogo de Plugins (Disponibles ahora)

📺 Televisores (TVs)

• TCL - tcl32s60a: Control total para el modelo TCL 32S60A y compatibles con Android TV via ADB.

📼 Decodificadores (Decos)

• Telecentro - sei800tc1: Gestión de canales y volumen para decodificadores SEI800TC1 de Telecentro y similares.

🔔 Timbres (Doorbells)

• Tuya - M8: Integración con Timbre Tuya M8. Visualización de cámara y notificaciones en tiempo real.

❄️ Aire Acondicionado (AC)

• Midea / Surrey: Control de temperatura, modos y potencia para equipos Surrey/Midea.

---

🛠️ Cómo instalar un Plugin manualmente

1. Descarga la carpeta del plugin que te interese desde este catálogo.
2. Cópiala dentro de la carpeta plugins/ en la configuración de la PC destino (~/.config/Fina/plugins/).
3. Reinicia Fina. ¡Listo! El asistente reconocerá automáticamente los nuevos comandos por voz o botones.

---

🌌 Guía de Creación de Plugins (SDK y Estándares de Desarrollo Universal)

Si deseas programar un nuevo módulo para controlar un hardware no listado arriba, aquí tienes la guía. Para que un plugin sea compatible con la interfaz "Zero-Config" de Fina Ergen, debe seguir esta estructura estrictamente. Esto permite que Fina localice automáticamente los scripts necesarios para los botones de la App sin importar el hardware del usuario.

📂 Estructura de Directorios

El repositorio del Market se organiza por Categoría, Marca y Modelo. Fina descargará el plugin y lo ubicará en ~/.config/Fina/plugins/.

[Categoría] / [Marca] / [Modelo] /
├── plugin.yaml          # Metadatos e Intents de voz (OBLIGATORIO)
├── README.md            # Documentación del plugin
├── icon.png             # OIcono que se verá en el Market
└── (Scripts de automatización .py)

---

📋 Convención de Nombres de Scripts

Los botones de la interfaz de Fina ejecutan scripts con nombres específicos. Si tu plugin no incluye estos archivos, el botón correspondiente mostrará un error de "Script no encontrado".

📺 Categoría: TVs y Decos

Los scripts de TV deben aceptar el argumento --ip (obligatorio) y --mac (en scripts de encendido).

Script	Acción del Botón	Argumentos adicionales
tv_power.py	Botón "Power" (On/Off toggle)	--mac [MAC]
tv_input.py	Botón "TV/AIRE" (Cambio a antena)	--mac [MAC]
set_input_deco.py	Botón "HDMI" (Cambio al deco)
tv_mute.py	Botón "Mute"
tv_volume_up.py	Botón "Vol +"
tv_volume_down.py	Botón "Vol -"
set_channel.py	Al pulsar un canal de la lista	--channel [N]
list_tv_apps.py	Botón "Escanear Apps"
launch_app.py	Al abrir una App (YouTube, etc)	--package [NAME]
scan_ultra_fast.py	Botón "Escaneo Rápido de Canales"

❄️ Categoría: AirConditioning

El control del aire se centraliza en un único script maestro llamado clima.py.

• Script: clima.py
• Modo Status: --status (Fina espera leer temperatura actual, modo y estado de energía).
• Modo Control: --temp [N], --mode [cool/heat/dry/fan], --power [on/off], --turbo [on/off], --swing [on/off].

🔔 Categoría: Doorbells

Control de seguridad y video-porteros.

Script	Propósito	Salida esperada
doorbell_status.py	Estado de batería	Un número (Ej: 85)
monitor.py	Iniciar visualización rápida	Argumento --trigger
hangup_doorbell.py	Cerrar comunicación

💡 Categoría: Lights y SmartHome

Automatización de iluminación inteligente.

Script	Acción	Argumento Extra
light_on.py	Encender luces
light_off.py	Apagar luces
set_brightness.py	Cambiar intensidad	--level [0-100]

🚪 Categoría: Doors y Locks

Cerraduras y puertas automatizadas.

Script	Acción
lock_on.py	Bloquear puerta (Cerrar llave)
lock_off.py	Desbloquear puerta (Abrir llave)
lock_status.py	Obtener estado de cerradura

🪟 Categoría: Blinds

Motores de cortinas y persianas inteligentes.

Script	Acción
blinds_open.py	Abrir persianas
blinds_close.py	Cerrar persianas
blinds_stop.py	Detener a medio camino

🌱 Categoría: Irrigation

Control de riego de jardines.

Script	Acción
watering_start.py	Iniciar ciclo de riego
watering_stop.py	Detener ciclo de riego

🤖 Categoría: Robots

Robots aspiradores o de limpieza.

Script	Acción
robot_clean.py	Iniciar ciclo de limpieza
robot_dock.py	Volver a la base de carga
robot_status.py	Obtener batería o estado

🧊 Categoría: Refrigerators y Appliances

Heladeras y electrodomésticos pesados.

Script	Acción
fridge_status.py	Leer temperatura/estado general
fridge_inventory.py	Leer inventario (si lo soporta)

⚡ Categoría: Energy

Monitoreo de paneles solares e inversores.

Script	Acción
solar_status.py	Leer producción (W) y voltaje
battery_status.py	Leer estado de baterías del hogar

---

📝 El archivo plugin.yaml

Es el archivo más importante. Define cómo interactúa la IA de Fina con tu dispositivo.

name: "Nombre comercial del Plugin"
version: "1.0.0"
author: "Tu Nombre"
category: "TVs" # TVs, Decos, AirConditioning, Doorbells, Lights, Doors
model: "modelo_sin_espacios" # Debe coincidir con el nombre de la carpeta final

# SISTEMA DE INTENTS (Voz de Fina)
intents:
  - name: "nombre_del_intent"
    patterns: 
      - "frase de activación 1"
      - "frase de activación 2"
    action: "script_a_ejecutar.py"
    response: "Lo que Fina dirá al ejecutarlo"

🛠️ Reglas de Oro para Desarrolladores

1. Sin Hardcoding de IPs: Siempre usa el argumento --ip que Fina envía al script.
2. Rutas Relativas: Todos los scripts deben poder ejecutarse desde su propia carpeta.
3. Python Estándar: Usa librerías estándar o incluye un requirements.txt si el plugin es complejo.
4. Velocidad: Fina es un sistema de control rápido. Optimiza tus scripts (ADB, HTTP, etc.) para que respondan en menos de 2 segundos.

---

Fina Ergen - Documentación de Estándares para el Market (2026)