🎥 CoopTuber - Streaming en Pareja / Co-streaming Solution

🇲🇽 / 🇺🇸

📄 Descripción / Description

🇲🇽	CoopTuber es una solución de código abierto diseñada para parejas, amigos y equipos que desean transmitir juntos usando una sola cámara web. Esta herramienta permite la creación de avatares PNG personalizados que se integran perfectamente con OBS y otras plataformas de streaming.
🇺🇸	CoopTuber is an open-source solution designed for couples, friends, and teams who want to stream together using a single webcam. This tool allows the creation of custom PNG avatars that integrate perfectly with OBS and other streaming platforms.

📹 Demostración / Demonstration

🎯 Características Principales / Main Features

🥸 Detección facial en tiempo real / Real-time Face Detection

	🇲🇽	🇺🇸
👀	Rastreo preciso de múltiples rostros	Accurate tracking of multiple faces
⚡	Optimizado para rendimiento con GPU	GPU-optimized performance
⏱️	Actualización en tiempo real	Real-time updates

🎨 Personalización de Avatares / Avatar Customization

	🇲🇽	🇺🇸
🖼️	Soporte para imágenes PNG y WebP	Support for PNG and WebP images
🎥	Integración con OBS mediante captura de ventana	OBS integration via window capture

🛠️ Herramientas de Edición / Editing Tools

	🇲🇽	🇺🇸
🖼️	Ajuste de fondo	Background adjustment
🎨	Personalización de colores	Color customization
⚙️	Configuración de parámetros	Parameter configuration
🛡️	Opción para ocultar visualización de cámara/video	Option to hide camera/video visualization
🔁	Soporte para video en bucle	Loop video support

📱 Compatibilidad / Compatibility

	🇲🇽	🇺🇸
🖥️	Funciona en Windows, macOS y Linux	Works on Windows, macOS, and Linux
📱	Optimizado para diferentes resoluciones	Optimized for different resolutions
📸	Soporte para una cámara a la vez	Support for one camera at a time

🛠️ Configuración / Setup

	🇲🇽	🇺🇸
1. 📸	Configura tu cámara web o video en bucle	Configure your webcam or loop video
2. 🎨	Personaliza los avatares	Customize avatars
3. ⚙️	Ajusta los parámetros según tus necesidades	Adjust parameters according to your needs
4. 🎥	Integra con OBS usando la fuente de imagen PNG	Integrate with OBS using PNG image source
5. 🛡️	Activa la opción de ocultar visualización para mayor privacidad	Enable the option to hide visualization for enhanced privacy

🤝 Contribuciones / Contributions

🇲🇽	¡Las contribuciones son bienvenidas! Por favor, lee nuestro 📄 Guía de Contribución para más detalles.
🇺🇸	Contributions are welcome! Please read our 📄 Contribution Guide for more details.

📦 Instalación / Installation

	🇲🇽	🇺🇸
1. 📦	Clona el repositorio:	Clone the repository:

git clone <https://github.com/JulioBuscer/CoopTuber-prototype.git>

	🇲🇽	🇺🇸
2. 📦	Instala las dependencias:	Install dependencies:

cd CoopTuber-prototype
npm install

	🇲🇽	🇺🇸
3. 📦	Inicia la aplicación:	Start the application:

npm run dev

🖥️ Requisitos del Sistema / System Requirements

🖥️ Sistema Operativo/ Operating System

🐧	Linux
🍏	macOS
🪟	Windows

🖥️ Requisitos de Hardware/Software / Hardware & Software Requirements

	🇲🇽	🇺🇸
🌐	Navegadores compatibles: Chrome ≥89, Firefox ≥88, Safari ≥14, Edge ≥89	Supported browsers: Chrome ≥89, Firefox ≥88, Safari ≥14, Edge ≥89
⚙️	APIs necesarias: WebAssembly, WebGL 2.0, getUserMedia, Canvas API	Required APIs: WebAssembly, WebGL 2.0, getUserMedia, Canvas API
🔐	Configuración obligatoria: Conexión HTTPS y permisos de cámara	Mandatory setup: HTTPS connection and camera permissions
🖥️	Hardware PC: CPU 4 núcleos, 4GB RAM, WebGL 2.0, cámara 720p	Desktop hardware: 4-core CPU, 4GB RAM, WebGL 2.0, 720p camera
📱	Móvil: Procesador 64 bits (Snapdragon 670/A11+), 3GB RAM	Mobile: 64-bit processor (Snapdragon 670/A11+), 3GB RAM
📝	Nota: Dispositivos antiguos (<2017) pueden tener baja performance	Note: Older devices (<2017) may experience low performance

📜 Licencia / License

🇲🇽	Este proyecto está bajo la Licencia Apache 2.0. Consulta el archivo 📄 LICENSE para más detalles. Puedes encontrar más información sobre la licencia en 🌐 Licencia.
🇺🇸	This project is under the Apache 2.0 License. Check the 📄 LICENSE file for more details. You can find more information about the license at 🌐 License.

🚫 Código de Conducta / Code of Conduct

🇲🇽	Este proyecto se rige por el 📄 Código de Conducta. Por favor, lee y entiende estos términos antes de contribuir.
🇺🇸	This project is governed by the 📄 Code of Conduct. Please read and understand these terms before contributing.

🙏 Agradecimientos / Acknowledgements

🇲🇽	A mi 💖 Esposa 💖 ya que amo el tiempo que pasamos juntos y fue la inspiración para crear CoopTuber UwU
🇺🇸	To my 💖 Wife 💖, who I love spending time with and was the inspiration for creating CoopTuber UwU

📝 Nota Especial / Special Note

🇲🇽	Este proyecto es una herramienta gratuita y de código abierto, creada con amor para facilitar la transmisión en pareja. ¡Esperamos que lo disfrutes tanto como nosotros al crearlo!
🇺🇸	This project is a free and open-source tool, created with love to facilitate couple streaming. We hope you enjoy it as much as we did creating it!

🚀 Características Futuras Planificadas / Planned Future Features

	🇲🇽	🇺🇸
📊	Control de calidad de imagen (compresión a WebP)	Image quality control (WebP compression)
📸	Soporte para múltiples cámaras	Multiple camera support
🎨	Personalización avanzada de avatares	Advanced avatar customization
⚡	Optimización mejorada del rendimiento	Improved performance optimization
💾	Cache de modelos con IndexedDB para cargas futuras	Model caching with IndexedDB for future loads
📉	Reducir resolución a 480p en dispositivos lentos	Reduce resolution to 480p on low-end devices
🎮	Limitar procesamiento a 24-30 FPS	Throttle processing to 24-30 FPS
🧵	Usar Web Workers para tareas paralelas	Use Web Workers for parallel tasks

⚠️ Limitaciones Conocidas / Known Limitations

	🇲🇽	🇺🇸
🔌	No funciona sin HTTPS o con firewalls restrictivos	Won't work without HTTPS or restrictive firewalls
🐌	Rendimiento reducido en CPUs de 32 bits o GPUs antiguas	Reduced performance on 32-bit CPUs or legacy GPUs
👥	Máximo 2 rostros detectados simultáneamente	Max 2 faces detected simultaneously