# Manual de usuario de Audiocinemateca para Windows

## 1. Primer inicio

Al abrir Audiocinemateca escribe tu nombre de usuario y contraseña. Son campos de
edición normales de Windows: puedes mover el cursor con izquierda y derecha,
seleccionar texto, usar Inicio y Fin, y corregir con Retroceso o Suprimir.

Si tu cuenta utiliza doble factor, aparecerá otro campo para el código actual de
seis cifras. El código se ve mientras lo escribes y también puede corregirse antes
de pulsar Aceptar.

La opción **Recordar la sesión** guarda la sesión protegida para el usuario actual
de Windows. La contraseña y la sesión nunca se incluyen en una exportación.

Si todavía no tienes una cuenta, pulsa **¿No tienes cuenta? Regístrate**. Se
abrirá un aviso en un campo de texto de solo lectura que explica por qué es
necesaria la cuenta y muestra la dirección oficial. Al elegir **Sí, abrir la
página de registro**, la web
<https://audiocinemateca.com/usuario/register> se abre en el navegador
predeterminado. **No, volver al inicio de sesión** cierra únicamente el aviso y
devuelve el foco al campo Nombre de usuario.

## 2. La ventana principal

La ventana se divide en cuatro áreas. Puedes recorrerlas con Tab y Mayús+Tab o
saltar directamente con Alt+1 a Alt+4.

Alt+2 lleva directamente a la lista de contenido siempre que tenga resultados,
en Inicio, Películas, Series, Documentales, Cortometrajes, Viendo, Vistas,
No vistas, Favoritos y Descargas. Sólo cuando la lista está vacía coloca el foco
en la búsqueda.

### Área 1: navegación

Es un árbol situado a la izquierda. Contiene:

- **Inicio**, con Favoritos generales y Descargas.
- **Películas**, **Series**, **Documentales** y **Cortometrajes**.
- Dentro de cada sección: Viendo, Vistas, No vistas y Favoritos.

Usa arriba y abajo para cambiar de rama, y derecha e izquierda para expandirla o
contraerla. Dentro del árbol, Control+1 a Control+5 salta a las cinco ramas
principales.

**Viendo** contiene aquello que se detuvo antes del final. **Vistas** contiene los
títulos cuyas partes o capítulos disponibles se terminaron. La posición de cada
parte se guarda automáticamente. Al reproducir un título de Viendo, la aplicación
elige el capítulo con progreso más reciente y pregunta si quieres continuar desde
la posición anunciada o empezar esa parte desde el principio.

El menú contextual es dinámico: **Quitar de Viendo** sólo aparece dentro de
Viendo y **Quitar de Vistas** sólo aparece dentro de Vistas. Tras confirmar, se
borra el progreso de todas las partes del título y éste pasa a No vistas. Si ese
título se está reproduciendo, primero se detiene para que no vuelva a guardarse.

### Área 2: contenido

Contiene la búsqueda, su etiqueta, el botón Buscar o Limpiar, los filtros, una
lista virtual y el botón **Sugerirme algo**.

En Inicio, una búsqueda consulta todas las secciones visibles. Sin búsqueda se
muestran los últimos títulos añadidos de cada sección. La cantidad se cambia en
Preferencias, dentro de Inicio y búsquedas.

Los filtros de campo, género, país, narración, idioma y orden permanecen activos
hasta que los cambies o restaures. Control+Mayús+F los abre desde cualquier lista.
Control+Mayús+S permite elegir qué secciones aparecen en Inicio.

El botón cambia a **Limpiar búsqueda** después de aplicar una consulta. También
puedes borrar o corregir el texto como en cualquier campo normal y pulsar Intro.
Alt+B lleva directamente al cuadro de búsqueda desde cualquier área. En
Descargas, que no tiene búsqueda, conserva el foco en la lista y lo anuncia.

La lista no crea miles de controles: sólo solicita las filas que necesita mostrar,
por lo que puede contener todo el catálogo sin una espera proporcional a su
tamaño.

### Área 3: reproductor

Siempre están disponibles el volumen, la velocidad, el ecualizador y la salida de
audio. El volumen cambia de uno en uno.

El dispositivo de salida se elige únicamente desde esta barra, además del menú
Reproducción y sus atajos. Al cambiar el volumen o la velocidad desde sus
controles, se conserva el anuncio nativo del lector de pantalla sin repetirlo
mediante un segundo mensaje de la aplicación.

Los botones Retroceder, Reproducir/Pausar, Avanzar y Detener sólo aparecen cuando
hay contenido cargado. Alt+3 coloca el foco en Reproducir/Pausar; si no hay
contenido, lo coloca en Volumen y lo anuncia.

Alt+P reproduce o pausa siempre: la combinación no cambia al cambiar el texto
del botón. Alt+R queda reservado para Retroceder y Alt+A para Avanzar. Los menús
superiores usan letras diferentes, de modo que estas teclas no compiten con
Archivo, Acciones ni Reproducción.

Los segundos para retroceder y avanzar se configuran por separado.

Al continuar un MP3, la aplicación aprovecha los rangos HTTP del servidor para
abrir directamente la zona aproximada del archivo que corresponde a la posición
guardada. La barra y la base de datos mantienen el tiempo absoluto. Si el formato
o el servidor no admite rangos, se usa como respaldo un salto verificado después
de iniciar el flujo y se reintenta mientras llegan los primeros datos.

### Área 4: acciones

Los botones cambian según el área enfocada y el elemento seleccionado. Las mismas
acciones aparecen en el menú **Acciones** y en el menú contextual.

Cuando el foco está en el reproductor, esta zona no repite sus botones físicos:
los transportes, el ecualizador y la salida permanecen sólo en la barra. El área
de acciones ofrece Información, que no tiene un botón propio en esa barra.
Alt+4 entra en el primer botón contextual y Tab o Mayús+Tab recorre los demás.
Las teclas de acceso de esas acciones sólo actúan dentro del menú Acciones o del
menú contextual, para no duplicar las de los controles siempre visibles.

## 3. Manejo de las listas

- Arriba y abajo cambian de elemento.
- Izquierda y derecha recorren las columnas y anuncian la información elegida en
  **Preferencias > Accesibilidad**.
- Control+1 a Control+0 consulta directamente una de las diez primeras columnas
  con esa misma configuración.
- Intro abre el menú contextual con las acciones disponibles.
- Espacio abre la ficha del título.
- Control+P anuncia la posición, por ejemplo «2 de 480», cuando la lista tiene
  el foco.
- Control+G abre un campo validado para ir a una posición existente.
- En Inicio, Control+Alt+1 a Control+Alt+4 salta al primer resultado de cada
  sección.
- Alt+2 vuelve directamente a la lista desde filtros o búsqueda si contiene
  resultados.
- Alt+B vuelve al cuadro de búsqueda.

Preferencias se abre desde **Archivo > Preferencias** y no tiene un atajo
directo. Control+P queda reservado a la lista enfocada, por lo que no interfiere
con campos de edición ni con otros diálogos.

Toda lista no vacía mantiene siempre un elemento seleccionado. La aplicación
recuerda de forma independiente la posición de cada rama del catálogo, de
Descargas y de las listas de partes de cada ficha. Si el elemento ya no existe,
selecciona la posición válida más cercana. Estas posiciones se conservan al
cambiar de sección, actualizar y volver a abrir la aplicación.

## 4. Fichas, partes, temporadas y versiones

La ficha presenta los datos del catálogo y una lista virtual de partes o
capítulos. Sus columnas indican estado, posición vista, duración y tiempo
restante.

En una serie con varias temporadas, **Control+RePág** salta al primer capítulo
de la temporada anterior y **Control+AvPág** al primero de la siguiente. El
elemento de destino queda seleccionado y enfocado, por lo que también se
actualiza la acción de reproducción según su progreso.

Cuando la parte enfocada tiene una posición guardada, el botón **Reproducir**
cambia a **Continuar o empezar…**. Al pulsarlo, la ficha se cierra antes de
mostrar el diálogo que permite continuar desde la posición anunciada, empezar
desde el principio o cancelar.

**Descargar** guarda la parte enfocada. **Descargar todo** sólo aparece cuando
la ficha contiene más de una parte; en una ficha de una sola parte se oculta
porque ambas acciones serían idénticas.

Si existen otras fichas del mismo contenido, aparece el selector etiquetado
**Cambiar ficha, idioma o narración**. Las opciones muestran el título de la
ficha, el español de España o latinoamericano y la narración. El cambio se aplica
en cuanto eliges una opción y el foco permanece en el selector.

**Obtener ficha externa** lee la información pública visible de FilmAffinity:
título, año, duración, país, dirección, guion, reparto, música, fotografía,
compañías, género, valoración y sinopsis. La operación se hace sólo cuando tú la
pides, se limita en frecuencia, usa caché y respeta `robots.txt`. Al terminar, el
foco se coloca al comienzo de la información añadida. Si no está permitida,
Audiocinemateca lo explica y conserva la ficha local. **Abrir en el navegador**
siempre sigue disponible.

## 5. Favoritos y sugerencias

Puedes añadir o quitar un título desde la ficha, el menú contextual, el menú
Acciones o la botonera inferior. Favoritos dentro de Inicio reúne todas las
secciones; cada categoría tiene además su propia rama de favoritos.

**Sugerirme algo** elige dentro de la lista y los filtros actuales. En Favoritos
sólo elige entre favoritos.

## 6. Descargas

Las descargas se guardan en la carpeta configurada. Al elegir **Descargar** en
el menú contextual de una serie o de un título dividido, aparece una lista de
casillas accesible: arriba y abajo recorren las partes, Espacio cambia su marca,
Control+A marca todas y Control+Mayús+A las desmarca. Los botones **Seleccionar
todo** y **Deseleccionar todo** permiten realizar las mismas acciones sin usar
atajos.

En las opciones de descarga puedes activar **Guardar dentro de una carpeta
propia** y editar su nombre como en cualquier campo de texto. La subcarpeta se
crea dentro del directorio general de descargas; los nombres no válidos para
Windows se explican antes de aceptar.

Descargas presenta cada selección múltiple en una sola fila. La columna
**Partes** informa «1 de 10», por ejemplo, y las columnas restantes muestran el
estado conjunto, porcentaje, tamaño, carpeta de destino y posibles errores.
El avance se persiste con una frecuencia limitada y sólo cambian las celdas cuyo
valor varía. La aplicación no reconstruye las columnas, no mueve el foco y no
envía anuncios continuos al lector mientras llegan bloques de audio.

Pausar, reanudar y cancelar actúan sobre todas las partes pertinentes del lote;
**Ver errores** muestra el detalle de las partes fallidas y **Abrir carpeta**
abre su destino común. Desde el menú contextual, Acciones y el área 4 también
puedes reintentar todos los errores, quitar un lote terminado, limpiar los lotes
completados o limpiar los lotes con error. Limpiar el historial nunca borra los
archivos descargados.

Si la aplicación se cierra con descargas activas, se pide confirmación y se
conservan como pausadas. Los archivos parciales permiten continuar mediante
peticiones por rangos cuando el servidor lo admite. Nunca se reemplaza
silenciosamente un archivo terminado: se crea un nombre alternativo.

## 7. Bandeja del sistema y segunda apertura

Si está activado **Minimizar a la bandeja**, al minimizar desaparece la ventana y
queda el icono de Audiocinemateca. Su menú permite mostrar la ventana, controlar
la reproducción, consultar información o salir. **Reproducir** o **Pausar** sólo
aparece cuando hay contenido cargado y cambia según el estado actual. Las
acciones se ejecutan después de cerrarse el menú para que su anuncio no quede
tapado por el cambio de foco del lector de pantalla.

Al ocultarse, la aplicación espera a que termine el cambio nativo de foco y
después anuncia **Audiocinemateca minimizada a la bandeja del sistema**. Al
volver mediante el icono, el atajo o una segunda ejecución, el foco también se
estabiliza primero y después se anuncia **Audiocinemateca restaurada desde la
bandeja del sistema**.

Si intentas abrir Audiocinemateca otra vez, no se crea otra copia ni aparece un
mensaje que quede detrás: la instancia activa recibe la orden, sale de la bandeja
y se trae inmediatamente al frente, devolviendo el foco al control en el que
estabas. La restauración no simula la tecla Alt y, por tanto, no abre el menú
Archivo.

## 8. Atajos globales

Los atajos globales controlan el reproductor aunque la ventana esté minimizada o
no tenga el foco. Se activan, cambian o dejan vacíos en Preferencias.

Al guardar, Audiocinemateca detecta combinaciones repetidas o inseguras. Al
registrarlas, Windows puede rechazar una combinación que ya usa otra aplicación;
en ese caso se muestra el nombre de la acción y el motivo, tanto en el aviso
como en **Preferencias > Atajos globales**, y el resto continúa activo.
Control+Alt+1 a Control+Alt+4 se reservan para saltar entre los grupos de Inicio
y no pueden asignarse como atajos globales.

La lista completa y los valores iniciales están en [TECLAS.md](TECLAS.md).

## 9. Web de Audiocinemateca

Las opciones del menú Web se abren en un visor interno de lectura que reutiliza
la sesión de la aplicación. Así las páginas compatibles pueden reconocer tu
sesión sin volver a pedir usuario y contraseña. Los enlaces externos se abren en
el navegador predeterminado.

El visor usa una superficie WebView accesible para NVDA y JAWS. Escape se
transmite desde el documento web hasta el diálogo y lo cierra aunque el foco esté
dentro de la página. Los scripts de las páginas se omiten en este modo de lectura
para evitar controles silenciosos o comportamientos imprevisibles; los enlaces
internos continúan abriéndose dentro del visor.

**Web > Audiocinemateca para desarrolladores** abre la página oficial que
documenta y ofrece el catálogo JSON y su archivo de versión.

Por seguridad no se copia la contraseña ni se inyectan cookies privadas en otro
navegador. Si una operación web interactiva no es compatible con el visor, abre
el enlace en el navegador y autentícate allí.

## 10. Preferencias

Las preferencias se agrupan en:

- General.
- Inicio y búsquedas.
- Accesibilidad.
- Reproductor.
- Descargas.
- Atajos globales.
- Actualizaciones y registro.

Elige una categoría en el árbol y pulsa Tab para recorrer sus opciones. Al
cambiar de categoría el foco permanece en el árbol; sólo se mueve a las opciones
cuando tú pulsas Tab. Las etiquetas aparecen encima de sus campos y están
asociadas mediante un nombre MSAA explícito para que el lector anuncie su
finalidad antes del valor seleccionado. Por ejemplo, se oye «Sección inicial,
Inicio» y no únicamente «Inicio». El mismo etiquetado se aplica a Ámbito, Buscar
en, Orden, Género, País, Narración e Idioma en Filtros.

La asociación también respeta el orden nativo de Windows: cada etiqueta se crea
antes que su campo. Así, en Reproductor, los valores se anuncian respectivamente
como Segundos para retroceder, Segundos para avanzar, Volumen inicial, Velocidad
inicial y Temporizador de descanso, sin desplazarse al campo siguiente.

En **Accesibilidad** puedes activar los mensajes de estado y decidir, por
separado, qué información adicional añade la aplicación al navegar arriba o
abajo y qué partes anuncia al recorrer columnas: posición, nombre de columna y
valor. Sin opciones verticales marcadas, se deja trabajar únicamente al anuncio
nativo de NVDA u otro lector.

En **Descargas**, el campo **Carpeta de descargas** permite escribir y corregir
la ruta. El botón **Seleccionar carpeta** abre el selector de Windows para
elegirla sin escribirla.

Guardar cambia los valores; Cancelar descarta lo editado.

## 11. Copias y traslado a otro ordenador

**Archivo > Exportar datos y configuración** crea una copia con preferencias,
favoritos, búsquedas, posiciones, estados y registro de descargas.

En el otro equipo usa **Archivo > Importar datos y configuración**. Los datos se
combinan con los existentes. La cuenta, contraseña, cookies y sesión no viajan:
debes iniciar sesión en el nuevo equipo.

## 12. Reiniciar datos

Desde una categoría del árbol, **Reiniciar sección** permite elegir con casillas
accesibles si se borran visualizaciones, favoritos o descargas de esa categoría.
Cada elemento expone al lector su nombre, el rol de casilla y su estado marcado
o desmarcado. Este comportamiento también se usa en Preferencias y en los
selectores de partes para descargar.

**Archivo > Reiniciar toda la base de datos** borra todos esos datos, búsquedas y
posiciones después de una confirmación. No borra el catálogo descargado ni la
sesión.

## 13. Registro y solución de problemas

**Ayuda > Manual de usuario** y **Ayuda > Todas las teclas** convierten el
Markdown incluido a una página HTML5 bien estructurada y la abren en el
navegador predeterminado. La página tiene idioma español, índice navegable,
encabezados jerárquicos, tablas y un enlace para saltar al contenido.

**Ayuda > Visor de registros** muestra los registros de las últimas sesiones sin
obligarte a buscar archivos. Permite elegir sesión y nivel mínimo, buscar con
Control+F, recorrer coincidencias con F3 o Mayús+F3, seguir en vivo el registro
actual, copiar los mensajes visibles, abrir la carpeta y eliminar sesiones
antiguas. La sesión actual nunca se elimina desde esa limpieza.

Hay una versión legible y otra estructurada de cada registro. Los archivos rotan
para no crecer sin límite y ocultan contraseñas, tokens, cookies y parámetros
sensibles. **Buscar actualización de la aplicación** también está en Ayuda,
inmediatamente encima de **Acerca de**.

**Acerca de** abre información ampliada sobre la aplicación, su versión, autor,
copyright, accesibilidad, funciones, datos locales, ayuda y una invitación a
apoyar el mantenimiento de Audiocinemateca mediante **Web > Donaciones**. No
muestra direcciones técnicas del actualizador. El contenido aparece en un campo
de texto multilínea de solo lectura: se recorre con las flechas, Inicio, Fin,
RePág y AvPág, y se puede seleccionar y copiar con Control+C. El foco comienza
en ese campo.

Los sondeos opcionales de lectores de pantalla ausentes no se presentan como
errores. Si una operación falla, reproduce el problema una vez y conserva el
registro de esa sesión.

Control+H explica el control enfocado. Si un lector no anuncia un cambio, vuelve
al control con Tab; los nombres y mensajes también se publican mediante los
eventos de accesibilidad de Windows.

## 14. Actualizaciones de la aplicación

La aplicación comprueba en segundo plano si hay una versión nueva. También
puedes hacerlo manualmente desde **Ayuda > Buscar actualización de la
aplicación**. Cuando encuentra una, el diálogo indica la versión instalada y la
encontrada, sin mostrar un changelog, y permite elegir **Actualizar ahora** o
**Ahora no**.

La descarga y la extracción se realizan en segundo plano para que la interfaz y
el lector de pantalla sigan respondiendo. Antes de instalar se comprueban el
tamaño y la huella SHA-256 del ZIP. Audiocinemateca se cierra, conserva toda la
carpeta `data` y se reinicia sola. Si la versión nueva no confirma un arranque
correcto, se restaura automáticamente la versión anterior.
