Invidious – interfaz web libre para ver contenido de YouTube. El proyecto no reemplaza al servicio de alojamiento de vídeos ni almacena su propia biblioteca de vídeos. El servidor Invidious obtiene metadatos y flujos multimedia de la infraestructura de YouTube y los muestra al usuario mediante una interfaz separada. El servicio puede abrirse en una de las instancias públicas o desplegarse en un servidor propio.
El proyecto sigue desarrollándose activamente. Al momento de la verificación, el repositorio cuenta con alrededor de 22,7 mil estrellas y 2,5 mil forks. La versión estable actual v2.20260804.1 se publicó el 5 de agosto de 2026. La mayor parte está escrita en Crystal, la aplicación web usa Kemal y los datos de usuarios e información de servicio se almacenan en PostgreSQL.
La idea principal de Invidious es separar la interfaz de visualización de YouTube en sí. El usuario no está obligado a iniciar sesión con una cuenta de Google para suscribirse a canales, mantener historial o crear listas de reproducción locales. La cuenta de Invidious pertenece a una instancia concreta y no está vinculada a la cuenta de YouTube.
Funciones de Invidious
A través de la interfaz se pueden buscar vídeos y canales, abrir páginas de canales y listas de reproducción, leer descripciones y comentarios, y seleccionar pistas de audio y subtítulos. Se admiten temas claro y oscuro, modo solo audio y reproducción en segundo plano en dispositivos móviles.
- suscripciones a canales sin cuenta de Google;
- historial de reproducciones local;
- notificaciones de nuevas publicaciones;
- importación de suscripciones desde YouTube, NewPipe y FreeTube;
- importación de historial desde YouTube y NewPipe;
- exportación de datos de Invidious;
- modo integrado solo audio;
- diseño claro y oscuro;
- interfaz web adaptada a dispositivos móviles;
- API REST para aplicaciones de terceros.
Los datos pueden transferirse entre instancias manualmente mediante exportación e importación. No existe sincronización automática de la cuenta entre distintos servidores Invidious. Los desarrolladores justifican esta decisión por la falta de infraestructura para sincronización centralizada o federada.
Para desarrolladores existe una API REST. A través de ella se pueden obtener datos sobre vídeos, canales, listas de reproducción, resultados de búsqueda y estadísticas de la instancia. JavaScript no es imprescindible para el funcionamiento básico, aunque algunas funciones del reproductor e interfaz son más cómodas con scripts habilitados.
Cómo funciona Invidious
El usuario abre una instancia pública o propia y envía una solicitud al servidor Invidious. El servidor obtiene información sobre vídeos y canales de YouTube sin usar la API oficial de YouTube, transforma las respuestas y genera sus propias páginas HTML o JSON para la API.
Una instalación moderna incluye tres componentes principales: Invidious, PostgreSQL y Invidious Companion. Companion se separó en un proyecto aparte y se encarga de obtener los flujos de vídeo desde los servidores de YouTube. El componente se basa en youtube.js y reemplazó a las anteriores herramientas inv-sig-helper y youtube-trusted-session-generator. Sin Companion configurado, la reproducción en el esquema actual no funciona.
Hay un matiz importante sobre la privacidad. Por defecto, el flujo de vídeo puede cargarse directamente en el navegador desde googlevideo.com. En ese modo Google ve la dirección IP del usuario y los datos habituales de la solicitud del navegador. La opción Proxy videos obliga a la instancia Invidious a reenviar el flujo multimedia a través de sí misma. La conexión directa del navegador con el servidor de Google para el vídeo desaparece, pero aumentan la carga y el consumo de tráfico en el servidor de Invidious.
El propio proyecto no declara recoger telemetría de usuarios, pero el administrador de una instancia concreta técnicamente puede mantener registros de solicitudes y ver direcciones IP. Por defecto, el servidor registra la dirección de la página solicitada, el código de respuesta y el tiempo de procesamiento. Al crear una cuenta local, la base de la instancia almacena las suscripciones y el historial de reproducciones.
La fiabilidad depende directamente de los cambios por parte de YouTube. Invidious usa interfaces no oficiales y analiza las respuestas del servicio, por lo que cambios en la API interna o en la estructura de datos pueden interrumpir temporalmente la búsqueda, las listas de reproducción, los comentarios o la reproducción. Por ejemplo, en junio de 2026 un cambio en el formato de datos de YouTube afectó la visualización de vídeos en las listas de reproducción, tras lo cual los desarrolladores tuvieron que modificar el analizador.
Para quién es adecuado Invidious
Para el usuario habitual, Invidious funciona como una interfaz web para YouTube sin necesidad de cuenta de Google y sin bloques publicitarios dentro de Invidious. No es necesario instalar una aplicación en el equipo o el teléfono. Los desarrolladores indican expresamente que Invidious sigue siendo una aplicación web y que no planean crear versiones separadas para Android o iOS.
Los administradores del sistema pueden desplegar una instancia propia para uso personal, para un pequeño grupo o para acceso público. Alojarlo por cuenta propia ofrece control sobre los registros, el registro de usuarios, el proxy de vídeo, el dominio, HTTPS y los parámetros de rendimiento.
Para desarrolladores, Invidious es útil como capa de software sobre los datos de YouTube. La API REST puede utilizarse en clientes propios, interfaces de búsqueda y otras integraciones, aunque la dependencia de los mecanismos internos de YouTube se mantiene en ese escenario.
Cómo instalar y ejecutar Invidious
La opción de despliegue principal soportada es Docker Compose. La documentación oficial requiere Docker Engine y Docker Compose V2. Es necesario clonar el repositorio completo, ya que el contenedor de PostgreSQL utiliza archivos SQL y un script de inicialización del árbol del proyecto.
Primero hay que obtener el código fuente:
git clone https://github.com/iv-org/invidious.git
cd invidious
Tras clonar, los desarrolladores recomiendan crear dos claves secretas distintas, una para Invidious y otra para Companion, y luego configurar docker-compose.yml. La documentación no recomienda usar la misma clave para ambos componentes.
Los contenedores se inician con el comando:
docker compose up -dEn el esquema típico se ejecutan Invidious en el puerto 3000, Invidious Companion y PostgreSQL 14. Para un servidor público en funcionamiento, la documentación sugiere un proxy inverso delante de Invidious. A través de este se suele configurar el nombre de dominio y HTTPS.
También existe una instalación manual en Linux. Se requieren Crystal, PostgreSQL, las librerías de compilación y un Companion independiente. Invidious se compila con el comando make, se copia config.example.yml a config.yml, se configura la base de datos, se ejecutan las migraciones y se inicia el servicio con systemd. Companion se puede descargar como binario listo o compilar mediante Deno.
Para enlazar Invidious y Companion la documentación indica un mínimo de 20 GB de disco y 2 GB de memoria RAM libre. Para una instancia pública se recomiendan alrededor de 60 GB de disco, 4 GB de RAM, dos núcleos virtuales de CPU, un canal de 200 Mbps y aproximadamente 20 TB de tráfico. Los requisitos elevados de red están relacionados en parte con el posible proxy de flujos de vídeo a través del servidor.
Ventajas y desventajas de Invidious
| Ventajas | Desventajas |
|---|---|
| Código abierto | El funcionamiento depende de cambios en los mecanismos internos de YouTube |
| No se requiere cuenta de Google | Las instancias públicas pueden funcionar de forma inestable de manera temporal |
| Suscripciones, historial y ajustes locales | No hay sincronización automática de la cuenta entre instancias |
| No hay bloques publicitarios en la interfaz de Invidious | El administrador de una instancia ajena técnicamente ve IP y registros de solicitudes |
| Se puede usar un servidor público o desplegar uno propio | Por defecto el flujo de vídeo puede transmitirse directamente desde los servidores de Google |
| Existe API REST e importación/exportación de datos | El despliegue por cuenta propia requiere PostgreSQL y Companion |
| El funcionamiento básico no requiere JavaScript | El alojamiento público puede consumir un gran volumen de tráfico |
Licencia
El núcleo de Invidious se distribuye bajo la GNU Affero General Public License v3.0 (AGPL-3.0-only). La licencia permite usar, estudiar, modificar y distribuir el programa. Si una versión modificada está disponible para los usuarios a través de la red, la AGPL exige proporcionar el código fuente correspondiente de esa versión.
El requisito tiene importancia práctica para servidores públicos. Las normas de la lista oficial de instancias de Invidious exigen a los operadores de versiones modificadas publicar el código fuente, describir los cambios y colocar enlaces al proyecto modificado y al original. Invidious Companion también se distribuye bajo AGPL-3.0.
Conclusión
Invidious no es un servicio de alojamiento de vídeos independiente ni una herramienta para descargar contenidos, sino una capa web independiente sobre YouTube. El usuario obtiene una interfaz en el navegador con suscripciones locales, historial y ajustes, y el administrador puede desplegar su propia instancia y controlar su configuración.
El principal compromiso está relacionado con la dependencia de YouTube. Los cambios en el servicio interrumpen periódicamente funciones concretas, ya que Invidious no utiliza una API oficial estable para todo su funcionamiento. Una instancia propia tampoco se reduce a un único binario: la arquitectura actual requiere PostgreSQL e Invidious Companion.
Para la visualización cotidiana es más sencillo elegir una instancia pública que funcione. Alojar por cuenta propia tiene sentido cuando se necesita control sobre los registros, los datos de los usuarios, la configuración de proxy y la disponibilidad del servicio. Al usar una instancia de terceros, la privacidad declarada no debe interpretarse como absoluta, ya que el operador del servidor sigue siendo una parte distinta a la que el usuario confía las solicitudes de red.
