# YoutubePlus para NVDA

YoutubePlus es un complemento para personas que aman usar YouTube pero encuentran que muchas funciones del sitio web son difíciles de acceder, como leer los comentarios de los videos. Te traemos estas funciones a través de la interfaz de usuario de NVDA en un formato que es fácil de navegar, admite atajos de teclado y es totalmente personalizable, sin necesidad de lidiar con claves API ni de conectar ninguna cuenta personal al complemento. Puedes seguir tus canales favoritos y tener la seguridad de que verás cada video de esos canales, sin que el algoritmo de YouTube los filtre. También proporcionamos un sistema de Favoritos para videos, canales, listas de reproducción y una lista de seguimiento para guardar el contenido que te interesa pero que aún no has tenido tiempo de ver. Incluye una búsqueda de videos integrada que muestra los resultados dentro de la misma interfaz de usuario utilizada en todo el complemento, no solo un cuadro de búsqueda que abre YouTube en un navegador. Se incluye una función de descarga para guardar videos o archivos de audio, aunque se proporciona como una comodidad más que como el enfoque principal. Si la descarga es tu necesidad principal, existen otros complementos dedicados a esta función que quizás quieras explorar. Lo único que este complemento no hace es incrustar un reproductor de video. Creemos que el reproductor web de YouTube ya es lo suficientemente accesible por sí solo. Si consideras que aún le falta accesibilidad, puedes usar otros complementos como browserNav para mejorar la experiencia.

Atajos de Teclado y Comandos

Este complemento utiliza un sistema de atajos por capas para evitar conflictos con otros complementos o comandos de NVDA. Presiona NVDA+Y para ingresar al modo de comando de YoutubePlus, luego presiona una de las siguientes teclas para acceder a cada función o ventana.

Nota: Si el atajo principal (NVDA+Y) tiene conflicto con otro complemento, puedes cambiarlo a través de NVDA -> Preferencias -> Gestos de entrada... bajo la categoría "YoutubePlus".

Teclas disponibles en la capa de YoutubePlus

Nota: Para los comandos que actúan directamente sobre un video, el complemento verifica primero la ventana del navegador que tienes abierta. Si una página de video de YouTube está activa, utiliza la URL de ese video. Si no hay ninguna página de video abierta, verifica el portapapeles en busca de una URL de YouTube.

Detalles de las Funciones y Comandos

a: (añadir a...)

Este comando en la capa de YoutubePlus envía la información del video o canal al destino seleccionado:

El complemento verifica primero la página del navegador abierta actualmente. Si es una página de video de YouTube, extrae la URL y la procesa según tu selección. Si la página no es un video de YouTube o no hay ningún navegador abierto, verifica el portapapeles en busca de una URL de YouTube.

La mayoría de los comandos funcionan con cualquier tipo de URL de YouTube, ya que el complemento puede derivar la información necesaria. Por ejemplo, si estás en la página de un video y eliges "Añadir a Canales Favoritos", el complemento puede extraer la URL del canal automáticamente. Lo mismo se aplica para suscribirse a un canal.

La única excepción son las listas de reproducción: debes tener abierta una página de lista de reproducción de YouTube o tener una URL válida de lista de reproducción de YouTube copiada en el portapapeles.

d: (descargar video/audio)

Este comando abre un pequeño cuadro de diálogo que pregunta si deseas descargar el video como un archivo MP4 o solo el audio como M4A. Puedes establecer el destino de la descarga en la sección de Opciones.

Ten en cuenta que la función de descarga se proporciona por comodidad y puede tener limitaciones si se usa en exceso. Si necesitas descargar grandes cantidades de contenido de YouTube, se recomiendan otras herramientas dedicadas.

e: (buscar)

Este comando abre una ventana de búsqueda de YouTube. Escribe tu consulta en el campo de búsqueda y presiona Enter para buscar inmediatamente. También puedes pulsar Tab para ajustar la cantidad de resultados a mostrar; el complemento recordará este valor para futuras búsquedas.

El campo de búsqueda es un cuadro combinado que recuerda tus búsquedas anteriores: presiona la flecha hacia abajo (o Alt+Abajo) para desplegar una lista de palabras clave previas y seleccionar una en lugar de volver a escribirla.

Los resultados se muestran en el mismo formato de lista de videos utilizado en todo el complemento, no como una página web de YouTube. Puedes acceder a todos los detalles del video de la misma manera que en cualquier otra lista de videos del complemento.

q: (búsqueda rápida)

Una alternativa más rápida al diálogo de búsqueda. Selecciona texto en cualquier aplicación (o tenlo copiado en el portapapeles si no hay nada seleccionado), luego presiona Q en la capa de YoutubePlus. El complemento busca en YouTube inmediatamente usando ese texto y el número de resultados guardado de tu última búsqueda — sin diálogo, sin pulsaciones adicionales.

Historial de búsqueda

Cada búsqueda que realizas — desde el diálogo de búsqueda o la búsqueda rápida — se guarda automáticamente. Presiona Control+H en la capa de YoutubePlus para ir directamente a la pestaña Historial de búsqueda en la ventana de Favoritos, donde puedes:

i: (información del video)

Muestra los siguientes detalles del video actual:

t: (marca de tiempo / capítulo)

Muestra la marca de tiempo o la lista de capítulos del video (si el creador incluyó esta información). Si el complemento informa "No se encontraron capítulos en este video", el video simplemente no tiene datos de capítulos.

Esta ventana ofrece más comodidad que leer los capítulos desde el navegador:

Favoritos

Una ventana que muestra tus favoritos guardados, dividida en 5 pestañas por tipo:

Comandos de la ventana de Favoritos

Categorías (Pestañas Video y Lista de seguimiento)

Tanto la pestaña Video como la de Lista de seguimiento permiten organizar elementos en categorías propias mediante un árbol a la izquierda, separado de la lista de elementos a la derecha. Cada pestaña mantiene sus propias categorías de forma independiente. Siempre hay un nodo predeterminado para los elementos sin categoría ("Videos" en la pestaña Video, "Lista de seguimiento" en la Lista de seguimiento).

Con el foco en el árbol de categorías:

Con el foco en la lista de elementos (derecha), haz clic derecho o presiona la tecla Aplicación/Menú para el mismo menú Acción usado en todo el complemento — separado del menú contextual del árbol.

Cortar, Copiar y Pegar en la lista de elementos siempre coloca los elementos en la categoría actualmente seleccionada en el árbol.

Ordenación

El botón Ordenar... (Alt+O) abre un diálogo con:

Lista de videos

En las pestañas de video y lista de seguimiento, así como en cualquier otra vista que muestre una lista de videos, encontrarás los botones Acción... y Copiar.... Estos son controles estándar en todas las vistas de listas de videos, y el feed de suscripciones añade una opción adicional de "Anular suscripción a este canal".

Presiona Enter en cualquier elemento para abrir el video en tu navegador, o presiona la barra espaciadora para realizar la acción rápida que puedes configurar en Opciones.

Botón Acción

Presiona Alt+A para abrir el menú Acción, que incluye:

Botón Copiar

Presiona Alt+C para abrir el menú Copiar, que incluye:

Feed de suscripciones

Una ventana que muestra los videos de los canales que sigues dentro del complemento. Esto es independiente de las suscripciones de tu cuenta de YouTube; no se requiere vinculación de cuentas ni datos personales.

A diferencia de la ventana de Favoritos, esta vista utiliza pestañas estándar divididas por tipo de contenido:

Más allá de estas categorías predeterminadas, puedes crear categorías personalizadas y configurar qué canales aparecen en cada una.

Comandos del feed de suscripciones

Botones adicionales en esta ventana:

Administrar suscripciones

Esta ventana muestra todos los canales a los que estás suscrito. El primer bloque es la lista de canales, seguido de las opciones de administración para cada canal:

Administrador de Perfiles de Usuario

Esta ventana gestiona tus perfiles de usuario. El complemento viene con un perfil "predeterminado" (default). Puedes añadir, eliminar o renombrar perfiles aquí. Para cambiar entre perfiles, ve al panel de Opciones del complemento.

En esta ventana:

Nota: Eliminar un perfil borra permanentemente todos los datos asociados a él. Cualquier video, canal o suscripción guardada en ese perfil se perderá.

l: (mostrar comentarios)

Hay tres tipos de comentarios en los videos de YouTube:

YoutubePlus admite el acceso a los tres tipos a través de este comando.

Chat en vivo de...

Para videos actualmente en vivo, presiona L y el complemento abrirá una nueva ventana que muestra los mensajes de chat entrantes. Solo se muestran los mensajes recibidos después de activar el comando; los mensajes anteriores no se capturan.

Puedes cerrar esta ventana y volver a abrirla más tarde con el comando V en la capa de YoutubePlus, siempre que la transmisión siga activa y no se haya reiniciado NVDA.

Usa el comando R para alternar si NVDA lee los nuevos mensajes en voz alta a medida que llegan. Esto funciona bien para transmisiones con mensajes poco frecuentes. Para transmisiones de alto volumen, puede ser más fácil desactivar la lectura automática y desplazarse por la ventana manualmente.

Presiona Shift+L para detener el monitoreo del chat para el video actual.

Tres opciones afectan directamente a esta función:

Cuando una transmisión termina — o el complemento detecta que ha terminado — aparecerá automáticamente un cuadro de diálogo preguntando si deseas exportar todos los mensajes recopilados. Presiona Sí para guardar el historial del chat como un archivo.

Comentarios / Repetición del chat en vivo

Para videos subidos regulares o transmisiones archivadas, puedes acceder a los comentarios de la misma manera. Si tanto la repetición del chat en vivo como los comentarios estándar están disponibles, un cuadro de diálogo preguntará cuáles deseas cargar.

No hay límite en la cantidad de comentarios mostrados, aunque la carga puede tomar tiempo para videos con muchos comentarios.

Los comentarios se muestran con los comentarios fijados primero, seguidos de todos los demás en el orden de clasificación configurado en Opciones (los más nuevos primero o los más antiguos primero).

Secciones de la ventana de comentarios

Opciones

Accede a las opciones a través de NVDA -> Preferencias -> Opciones... y selecciona la categoría "YoutubePlus".

Información Adicional

Este complemento se basa en dos bibliotecas principales: pytchat para el monitoreo del chat en vivo, y yt-dlp para todo el acceso restante a los datos de YouTube. Extendemos nuestro sincero agradecimiento a los desarrolladores de ambas bibliotecas.

Acerca de yt-dlp

yt-dlp es una de las herramientas de código abierto más potentes para descargar video y audio de sitios web de todo el mundo, admitiendo más de 1.000 sitios, no solo YouTube. Es gratuito, de código abierto y mantenido activamente por una comunidad global, sin anuncios ni malware a diferencia de muchas herramientas de descarga basadas en navegador.

Dicho esto, por favor ten en cuenta las siguientes pautas de uso:

  1. Uso justo: Evita obtener grandes cantidades de datos o enviar solicitudes repetidas en poco tiempo. YouTube puede detectar actividad inusual y restringir temporalmente el acceso desde tu dirección IP.
  2. Derechos de autor y privacidad: Cualquier dato o contenido recuperado debe ser solo para visualización o análisis personal. Por favor, respeta los Términos de servicio de cada plataforma y no utilices los datos de formas que infrinjan los derechos de autor.
  3. Responsabilidad: Tú eres responsable de cómo utilizas este software. El desarrollador del complemento proporciona únicamente la interfaz para acceder a los datos de YouTube a través de la biblioteca yt-dlp.

Consejo: Si necesitas procesar grandes cantidades de datos, espacia tus solicitudes para mantener la estabilidad de la conexión y evitar restricciones de acceso.