MiniKick v1.1.2
El centro de control definitivo para streamers en Kick.com
MiniKick es una aplicación de escritorio nativa diseñada para optimizar la interacción en Kick.com. Actualmente, el proyecto se centra en ofrecer un sistema de lectura de chat avanzado y personalizable, operando completamente fuera del navegador para reducir drásticamente el consumo de recursos de tu PC mientras transmites.
| Módulo | Función | Implementación |
|---|---|---|
| Lectura de Chat | TTS Híbrido | Narración capaz de alternar de forma transparente entre voces naturales con IA (edge-tts) y motores locales de Windows (pyttsx3). |
| Interacción OBS | Alertas Dinámicas | Posicionamiento aleatorio de video en el lienzo de OBS para evitar la obstrucción de elementos visuales clave durante el directo. |
| Conectividad | Tiempo Real | Integración directa e instantánea con los eventos de Kick mediante WebSockets. |
| Sistema OTA | Actualizaciones | Búsqueda, descarga e instalación de nuevas versiones en segundo plano. |
Note
A partir de la versión 1.1.2, todas las configuraciones, tokens de sesión y la base de datos de alertas persisten de forma local y segura en tu directorio de Windows AppData\Local\.Minikick.
| Categoría | Tecnologías | Propósito |
|---|---|---|
| Interfaz Gráfica |  |
Desarrollo de la UI moderna (Dark/Mint) y gestión del ciclo de vida de los hilos de la aplicación. |
| Voz y Audio |   |
Motores de síntesis de voz orquestados mediante un patrón de diseño unificado. |
| Conexión |   |
Gestión de sockets en tiempo real y peticiones HTTP con bypass de seguridad (Cloudscraper) y tolerancia a fallos. |
| Persistencia |  |
Almacenamiento local estructurado y ligero sin dependencias externas. |
| Distribución |  |
Compilación, gestión de rutas estáticas y empaquetado para despliegue nativo en sistemas Windows. |
El núcleo de MiniKick está diseñado para ser altamente escalable y resistente a cuelgues (Segfaults). El desarrollo se rige estrictamente por estas 5 reglas de arquitectura para garantizar la mantenibilidad:
- Dependency Inversion: Uso intensivo de interfaces abstractas para desacoplar la lógica de negocio de las implementaciones concretas.
- Separation of Responsibilities (SoR): Capas claramente delimitadas. Las Vistas son pasivas, los Workers manejan la carga pesada de red/archivos, y los Controladores orquestan de forma segura.
- High Cohesion: Cada clase y módulo tiene un propósito único y bien definido en el sistema.
- DRY (Don't Repeat Yourself): Centralización de lógica repetitiva priorizando siempre la legibilidad y limpieza del código.
- YAGNI (You Aren't Gonna Need It): Abstracciones justificadas. Resolvemos problemas reales de forma simple sin caer en la sobre-ingeniería.
Important
Toda nueva contribución o Pull Request debe respetar obligatoriamente estos 5 principios de arquitectura en su código para ser aprobada.
La forma más sencilla de usar MiniKick:
- Navega a la sección de Releases.
- Descarga el archivo ejecutable (
MiniKick_Installer.exe). - Sigue las instrucciones del asistente de instalación en tu máquina Windows.
Si deseas explorar el código fuente o contribuir al proyecto en local:
# Clonar el repositorio
git clone https://github.com/Andro2k/MiniKick.git
cd MiniKick
# Crear y activar entorno virtual
python -m venv venv
venv\Scripts\activate # En Windows
# Instalar dependencias
pip install -r requirements.txt
# Ejecutar la aplicación
python main.pyTip
Si descubres algún comportamiento inesperado o un crash del sistema, por favor revisa primero los Issues abiertos en el repositorio y la consola de desarrollador interna de la app antes de abrir un reporte nuevo.
Este proyecto se distribuye bajo la Licencia MIT. Consulte el archivo LICENSE para mas detalles.
Desarrollado por TheAndro2K