1. Introducción: ¿para qué sirve esta aplicación?

Este teleprompter está pensado para que un mago pueda ensayar un monólogo o el patter (la charla) de un truco sin tener que memorizarlo de golpe ni mirar constantemente un papel. El texto aparece en la pantalla y se va desplazando hacia arriba solo, línea a línea, a la velocidad que tú marques — igual que los teleprompters que usan los presentadores de televisión, pero adaptado a las necesidades de un mago: separa el guion en pasos, resalta las frases de diálogo, permite intercalar "cháchara" de relleno y deja las manos completamente libres si usas los accesorios adecuados (lo explicamos en la sección 4).

Con esta aplicación puedes:

• Ensayar un monólogo completo de principio a fin, viendo el texto avanzar automáticamente al ritmo que elijas, como si estuvieras actuando de verdad.
• Practicar el patter de un truco paso a paso: qué le dices al espectador mientras haces cada fase del efecto, sin perder el hilo.
• Controlar la velocidad mientras ensayas, para acostumbrarte a hablar más rápido o más despacio sin perder de vista el guion.
• Practicar en modo manual, avanzando el texto tú mismo (con el teclado, con la pantalla táctil, o con un pedal — ver más abajo) cuando quieras controlar el ritmo con precisión, por ejemplo mientras manipulas cartas.
• Guardar tus propios monólogos y trucos, editarlos cuando quieras y tenerlos siempre a mano.
• Imprimir el guion en papel si prefieres ensayar sin pantalla, o llevarlo impreso como copia de seguridad.

Sobre el hardware de manos libres: muchos magos ensayan (o incluso actúan) con un pasapáginas de pedal — el mismo tipo de mando que usan los músicos para pasar las partituras sin usar las manos. Conectado por Bluetooth, uno de estos pedales permite avanzar o retroceder el guion pulsando con el pie, dejando las dos manos completamente libres para manipular cartas, monedas o cualquier otro accesorio mientras practicas. En la sección "Accesorios recomendados" explicamos con detalle cómo funciona y cómo configurarlo con esta aplicación.

2. Guía rápida (empezar a practicar en un minuto)

Si es la primera vez que usas la aplicación, sigue estos pasos:

1. 1Elige qué quieres practicar. Arriba, en la barra inferior de la pantalla, verás dos menús desplegables: "📜 Monólogo" y "🎩 Truco". Elige uno de los dos (si eliges un truco, el monólogo se desactiva automáticamente, y viceversa).
2. 2Comprueba el modo. Junto al cronómetro verás dos botones: "▶ Auto" y "⌨ Manual". Para tu primer ensayo, deja el modo Auto, que es el que viene seleccionado por defecto: el texto avanzará solo.
3. 3Ajusta la velocidad. Usa el control deslizante "Vel" para elegir lo rápido que se desplaza el texto. Empieza despacio (por debajo de 1×) y ve subiendo con la práctica.
4. 4Pulsa "▶ Reproducir" (o simplemente la barra espaciadora del teclado) y empieza a ensayar en voz alta, siguiendo el texto que se desplaza.
5. 5Pulsa "⏸ Pausa" en cualquier momento para detener el texto (también con la barra espaciadora), y "⟲ Inicio" para volver al principio del guion.
6. 6Ponte en pantalla completa pulsando el botón "⛶" (o la tecla F11) para que el texto se vea lo más grande posible y sin distracciones, ideal si colocas el móvil o la tableta apoyados delante de ti.

3. Instrucciones detalladas, sección por sección

3.1 La pantalla del teleprompter

Es la zona oscura y grande que ocupa casi toda la pantalla. Ahí aparece el guion. La línea que estás leyendo en cada momento se ve totalmente iluminada; las líneas anteriores y siguientes se ven más apagadas, para que tu vista se centre siempre en el sitio correcto sin distraerse con el resto del texto. Debajo de la pantalla hay una barra de progreso fina y dorada que se va rellenando de izquierda a derecha, indicándote cuánto guion te queda por delante.

Los colores del texto tienen un significado:

Color	Significado
Blanco	Texto normal del guion.
Dorado y en negrita	El título del monólogo/truco, o una frase que quieres destacar especialmente.
Lila / cursiva	Una línea de diálogo (algo que "dice" un personaje o el espectador; se detecta automáticamente cuando la línea empieza por un guion largo — o va entre comillas).
Azul claro	Una acción o indicación entre corchetes, por ejemplo [el espectador firma la carta]: no es texto que se dice en voz alta, sino un recordatorio de qué debes hacer en ese momento.
Verde	Una línea de "cháchara" (ver sección 3.5): comentarios de relleno que se pueden intercalar en un truco.

3.2 El cronómetro y el modo Automático / Manual

En la esquina de los controles hay un cronómetro (⏱) que cuenta el tiempo transcurrido desde que le das a reproducir, para que sepas cuánto está durando tu número.

Justo al lado tienes el selector de modo:

• ▶ Auto: el texto se desplaza solo, a la velocidad marcada por el control "Vel". Es el modo pensado para ensayar el número completo tal y como lo harías en directo.
• ⌨ Manual: el texto no se mueve por sí solo. Tú decides cuándo avanza, línea a línea, pulsando la barra espaciadora, la flecha ↓ del teclado, tocando/deslizando la pantalla, o con un pedal (ver sección 4). Es el modo ideal para ensayar despacio, repetir una frase, o sincronizar el texto con un movimiento de manos concreto.

3.3 Dirección y velocidad

El botón con la flecha (junto al selector de modo) cambia la dirección del desplazamiento: hacia adelante (avanzando el guion, lo normal) o hacia atrás (retrocediendo), por si necesitas repasar algo que ya ha pasado sin pulsar "Inicio" y perder el sitio.

El control deslizante "Vel" ajusta la velocidad de desplazamiento en modo Automático. Cuanto más a la derecha, más rápido se mueve el texto. El número junto al deslizador (por ejemplo "0.8×") es un multiplicador: 1× es la velocidad de referencia, por debajo va más lento y por encima más rápido. Es buena idea empezar siempre despacio y aumentar la velocidad progresivamente a medida que te sientes más cómodo con el texto.

3.4 Elegir qué vas a practicar: Monólogo o Truco

Hay dos desplegables independientes en la barra de controles:

• 📜 Monólogo: incluye los monólogos ya preparados en la aplicación (Preludio, Compras, Mudanza, Congreso, Tráfico en Lugo) más los que tú mismo añadas.
• 🎩 Truco: incluye los trucos que hayas creado en la sección de gestión de datos, cada uno con su patter dividido en pasos.

Solo se puede practicar una cosa a la vez: si eliges un truco, el desplegable de monólogo se pone en blanco automáticamente ("— Ninguno —"), y al revés. El nombre de lo que tienes cargado en cada momento se muestra en la esquina, junto a los botones ("📜 Nombre del monólogo" o "🎩 Nombre del truco").

3.4.1 Vista: guion, instrucciones, o ambos

Junto a los desplegables de contenido hay un tercer selector, "👁️ Vista", que controla qué partes del texto se muestran en el teleprompter. En los trucos, cada paso suele tener dos elementos: una instrucción entre corchetes — por ejemplo [El espectador firma la carta], el movimiento o la acción física que debes hacer — y el guion propiamente dicho, lo que dices en voz alta mientras lo haces. Este selector te deja elegir cuál de las dos partes quieres ver:

• Guion + instrucciones (opción por defecto): se ve todo, tal y como está escrito — ideal para el primer ensayo, cuando todavía estás aprendiendo tanto los movimientos como lo que dices.
• Solo guion: oculta las instrucciones entre corchetes y muestra únicamente lo que hay que decir. Útil cuando ya dominas los movimientos del truco y solo quieres pulir el patter, sin distracciones.
• Solo instrucciones: oculta el texto hablado y muestra únicamente los movimientos entre corchetes, en orden. Ideal para aprender o repasar la mecánica del efecto en sí, sin tener que leer todo el patter de por medio.

3.5 La Cháchara (Banter)

La "cháchara" son frases cortas de relleno, de humor observacional, que un mago puede intercalar durante un truco mientras hace tiempo (por ejemplo, mientras un espectador baraja o piensa una carta). Esta función solo se aplica cuando tienes cargado un truco, nunca en un monólogo, porque un monólogo ya es un texto completo y cerrado que no necesita relleno.

Hay dos formas de usar la cháchara: automática (se decide de antemano dónde va) y al vuelo (la insertas tú, en directo, en el momento exacto que la necesitas).

Cháchara automática — controles disponibles (se atenúan y quedan inactivos si no hay un truco cargado):

• 🎭 Tema Cháchara: elige de qué tema serán los comentarios (familia, viajes, comida, etc.).
• 📌 Modo: decide en qué parte del truco se insertan los comentarios — "Al inicio", "Al final" o "Entremezclado" a lo largo de todo el guion.
• Interruptor "Cháchara / 💬 Mostrar": activa o desactiva la cháchara. Por defecto viene desactivada, así que si quieres usarla tendrás que activarla la primera vez.

Las líneas de cháchara se distinguen fácilmente porque aparecen en verde y precedidas por la etiqueta {Cháchara}.

Cháchara al vuelo: además de decidir de antemano dónde va la cháchara, puedes añadirla en el momento exacto en que la necesites, mientras estás actuando — por ejemplo, mientras un espectador baraja las cartas o mientras piensa una carta y tienes que hacer tiempo. Se inserta siempre justo después de la línea en la que te encuentras en ese momento, sin mover el guion ni perder tu posición, y funciona tanto en modo Automático como en Manual. También funciona aunque el interruptor "Cháchara / 💬 Mostrar" esté desactivado, porque es una decisión tuya, tomada en el momento, no la inserción automática. Hay dos formas de hacerlo, con dos atajos distintos:

• Tecla B o botón "🎭 Insertar todo": inserta de golpe todas las frases del tema de cháchara seleccionado, una detrás de otra, justo donde estás. Útil cuando sabes que vas a necesitar hacer tiempo un buen rato y quieres tener varias frases encadenadas ya preparadas en el guion.
• Tecla L o botón "🎭 Insertar línea": inserta una sola frase cada vez que la pulsas, para ir añadiendo cháchara de una en una a medida que la necesitas, con más control sobre el ritmo.

Ambos atajos comparten el mismo orden de frases: si insertas una línea suelta con L y luego pulsas B, el bloque completo continúa a partir de la siguiente frase sin repetir la que ya habías insertado (y da la vuelta al llegar al final de la lista).

3.6 Reproducir, Pausa, Reiniciar

• ▶ Reproducir / ⏸ Pausa: el mismo botón cambia de función según el estado. En modo Automático, arranca o detiene el desplazamiento. En modo Manual, cada pulsación avanza una línea.
• ⟲ Inicio: vuelve al principio del guion actual y pone el cronómetro a cero.

3.7 Cargar un guion desde un archivo

El botón "📂 Cargar" te permite abrir un guion guardado como archivo de texto (.txt) desde tu ordenador, móvil o tableta, sin tener que copiarlo dentro de la aplicación. Basta con escribir el texto normal: la primera línea se toma como título, las líneas que empiezan por un guion o van entre comillas se detectan automáticamente como diálogo, y las líneas en blanco se convierten en una pequeña pausa visual. También admite archivos .json exportados previamente desde esta misma aplicación.

3.8 El asistente de IA para generar guiones

El botón "🤖 IA" abre un asistente que te ayuda a construir, con la ayuda de una inteligencia artificial externa (como ChatGPT, Claude o similar), un monólogo o un patter para un truco nuevo. No genera el texto por sí solo dentro de la aplicación: te prepara un prompt (una instrucción ya redactada) que tú copias y pegas en tu asistente de IA preferido.

1. Elige si quieres generar un Monólogo o el Patter de un truco (en este último caso, escribe el nombre del truco y describe brevemente sus fases).
2. Rellena el tema, el estilo del guionista, el idioma, la duración aproximada y cualquier matiz adicional.
3. Pulsa "📋 Copiar prompt" y pégalo en tu aplicación de inteligencia artificial preferida (fuera de este teleprompter).
4. Copia el texto que te devuelva la IA y pégalo en el recuadro "Cargar desde portapapeles".
5. Pulsa "📥 Cargar contenido" para que aparezca directamente en el teleprompter, listo para ensayar.

3.9 Imprimir el guion

El botón "🖨️ Imprimir" (el de la barra principal, no el de esta ventana de ayuda) imprime el guion que tengas cargado en ese momento, en blanco y negro y con buen tamaño de letra, conservando los colores como estilos de texto (negrita, cursiva) para que sigas distinguiendo el diálogo y las indicaciones. Es útil como copia de seguridad en papel o para ensayar sin depender de una pantalla.

3.10 Gestión de datos: añadir, editar, exportar e importar

El botón "🗂️ Datos" abre la ventana donde puedes crear y administrar tus propios monólogos, trucos y temas de cháchara. Tiene tres pestañas:

• 🎩 Trucos: escribe el nombre del truco y, para cada paso, un campo con la acción física (por ejemplo "El espectador firma la carta") y otro con el texto o guion que dices en ese momento. Pulsa "+ Añadir paso" para añadir tantos pasos como necesites. No hace falta escribir ningún código: solo texto normal en los campos.
• 📜 Monólogos: escribe el nombre y, debajo, el texto tal y como lo vas a decir, línea por línea. La primera línea será el título. Las líneas que empiecen por un guion largo o vayan entre comillas se convierten automáticamente en diálogo. Escribe una palabra o frase entre doble asterisco (por ejemplo **así**) para resaltarla. Deja una línea en blanco donde quieras una pequeña pausa.
• 🎭 Cháchara: escribe el nombre del tema y, debajo, una frase de relleno por línea.

En cualquiera de las tres pestañas, la lista de la izquierda muestra lo que ya tienes guardado: haz clic sobre un elemento para editarlo, o en el icono ✕ para eliminarlo. Pulsa "💾 Guardar" para confirmar los cambios o "Cancelar" para descartarlos.

Al final de la ventana encontrarás tres acciones globales:

• 📤 Exportar todo: descarga un archivo con todos tus monólogos, trucos y temas de cháchara, para guardarlo como copia de seguridad o pasarlo a otro dispositivo.
• 📥 Importar: carga un archivo exportado previamente, añadiendo su contenido a lo que ya tienes.
• 🗑️ Limpiar almacenamiento: borra todos los datos guardados en este dispositivo. Úsalo con cuidado — exporta antes una copia si no quieres perder tu trabajo.

3.11 Atajos de teclado

Muy útiles para practicar sin tener que tocar la pantalla con las manos (ver también la sección 4 sobre pedales):

Tecla	Qué hace
Espacio / Enter	En Automático: reproducir o pausar. En Manual: avanza una línea.
↓	En Manual: avanza una línea. En Automático: retrocede la referencia una línea.
↑	En Manual: retrocede una línea. En Automático: avanza la referencia una línea.
← / →	Baja / sube la velocidad en pasos pequeños.
Re Pág / Av Pág	En Manual: retrocede / avanza una pantalla completa de texto. En Automático: baja / sube la velocidad en pasos grandes.
Inicio / Fin	En Manual: salta al principio o al final del guion.
F	Fija la dirección hacia adelante.
R	Invierte la dirección (retroceder).
M	Alterna entre modo Automático y Manual.
B	Inserta TODAS las líneas de cháchara del tema, de golpe, justo aquí en directo (solo con un truco cargado). Igual que el botón "🎭 Insertar todo".
L	Inserta la siguiente línea de cháchara, una a una, justo aquí en directo (solo con un truco cargado). Igual que el botón "🎭 Insertar línea".
F11	Activa o desactiva la pantalla completa.
Esc	Cierra cualquier ventana emergente abierta.

4. Accesorios recomendados: practica con las manos libres

Para sacarle todo el partido a esta aplicación durante el ensayo de manipulación (cartas, monedas, etc.), lo ideal es no tener que tocar la pantalla ni el teclado mientras practicas. Aquí es donde entra un accesorio muy habitual entre músicos y también usado por magos: el pasapáginas de pedal (en inglés, "page turner" o "foot pedal"), como los modelos AirTurn, iRig BlueTurn, PageFlip o similares.

¿Qué es y cómo funciona?

Es un pequeño mando con uno o dos pedales que se coloca en el suelo. Se conecta al móvil, tableta u ordenador por Bluetooth, igual que un teclado o un ratón inalámbrico. Cuando lo pisas, el pedal simula que has pulsado una tecla del teclado (normalmente la flecha ↓, la barra espaciadora, o Av Pág/Re Pág, según cómo lo configures). Como esta aplicación ya responde a esas mismas teclas para avanzar el guion, el pasapáginas funciona sin necesidad de instalar nada adicional ni de configurar nada dentro de esta app.

Cómo configurarlo con este teleprompter

1. 1Empareja el pedal con tu dispositivo por Bluetooth, siguiendo las instrucciones del propio fabricante (suele ser mantener pulsado un botón del pedal hasta que parpadee, y luego buscarlo en el menú de Bluetooth del móvil o el ordenador).
2. 2La mayoría de estos pedales traen una aplicación propia (o interruptores físicos) donde eliges qué tecla simula cada pulsación del pedal. Configúralo para que envíe flecha ↓ (o Espacio) al pisarlo.
3. 3En este teleprompter, pon el modo en "⌨ Manual" (sección 3.2), así cada pisada del pedal avanzará el guion una línea, exactamente igual que si pulsaras la tecla en el teclado.
4. 4Coloca el pedal en el suelo, apoya el móvil o la tableta en un atril o soporte a la altura de los ojos, y practica con las dos manos completamente libres, avanzando el texto con el pie a tu propio ritmo.

Otros accesorios útiles

• Soporte o atril para el móvil/tableta: para tener la pantalla siempre a la altura de los ojos y estable, sin tener que sujetarla.
• Un segundo dispositivo o un mando a distancia genérico tipo "presentador Bluetooth": también sirve como alternativa al pedal, aunque requiere usar la mano en vez del pie.
• Ajustes de "no apagar pantalla": revisa la configuración de tu móvil o tableta para que la pantalla no se apague sola durante un ensayo largo (ver también la sección de solución de problemas).

5. Solución de problemas

Problema	Qué hacer
El texto no se mueve al pulsar Reproducir	Comprueba que estás en modo "▶ Auto" y no en "⌨ Manual" (en Manual el texto solo avanza cuando tú lo indicas). Comprueba también que la velocidad ("Vel") no esté al mínimo.
No aparece la cháchara aunque la he activado	La cháchara solo se muestra cuando tienes cargado un truco, nunca con un monólogo. Elige un truco en el desplegable "🎩 Truco" para que se aplique.
El pedal Bluetooth no avanza el texto	Asegúrate de que el pedal está emparejado y conectado (no solo emparejado: algunos dispositivos hay que "conectar" cada vez). Pon el teleprompter en modo Manual. Comprueba que el foco del navegador está en la página del teleprompter y no en otra ventana o en un campo de texto (si el cursor está escribiendo en una casilla, el teclado no controla el guion).
He perdido mis monólogos o trucos guardados	Los datos se guardan solo en este navegador y este dispositivo. Si borraste el historial/caché del navegador, cambiaste de dispositivo, o usaste "🗑️ Limpiar almacenamiento", los datos personalizados se pierden. La mejor prevención es exportar copias de seguridad periódicas con "📤 Exportar todo" (sección 3.10).
Al pulsar "Imprimir esta ayuda" no sale nada o sale en blanco	Espera un instante a que se abra el cuadro de impresión del navegador; en algunos navegadores tarda un segundo en generar la vista previa. Si sigue sin funcionar, prueba a ampliar la ventana antes de imprimir, o usa la opción "Guardar como PDF" del propio cuadro de impresión en vez de enviarlo directamente a una impresora física.
La pantalla se apaga sola durante el ensayo	Es el ahorro de energía del móvil o tableta, no un fallo de la aplicación. Aumenta el tiempo de "apagado automático de pantalla" en los ajustes del dispositivo mientras ensayas, o mantén el dispositivo enchufado.
Al pulsar pantalla completa (⛶) no pasa nada	Algunos navegadores en móvil no permiten pantalla completa real desde una página web; en ese caso, oculta la barra de direcciones deslizando hacia abajo, o añade la página a la pantalla de inicio del móvil para que se abra como una app a pantalla completa.
Un archivo cargado (.txt) no se ve como esperaba	Revisa que la primera línea del archivo sea el título, que las líneas de diálogo empiecen por un guion largo (—) o vayan entre comillas, y que no haya líneas en blanco de más. Puedes editarlo directamente dentro de la aplicación desde "🗂️ Datos" tras cargarlo.
El texto va demasiado rápido o demasiado lento y no me da tiempo a leer	Ajusta el deslizador "Vel" (sección 3.3) o usa las flechas ← → del teclado para afinar la velocidad mientras practicas, sin tener que parar. También puedes cambiar a modo Manual para llevar tú mismo el ritmo por completo.
Al pulsar "🎭 Insertar todo", "🎭 Insertar línea" o las teclas B/L no pasa nada	Comprueba que tienes un truco cargado (no funciona con monólogos) y que el tema de cháchara elegido tiene frases guardadas. Los botones aparecen atenuados cuando no hay ningún truco cargado.
Elijo "Solo guion" o "Solo instrucciones" y no cambia nada, o veo un aviso	Si el contenido cargado no tiene ninguna línea de ese tipo (por ejemplo, un monólogo sin corchetes al elegir "Solo instrucciones"), la aplicación avisa con un mensaje y muestra igualmente el contenido completo, para que la pantalla nunca quede en blanco.
Quiero volver a ver esta ayuda más adelante	Pulsa en cualquier momento el botón "❓ Ayuda" de la barra de controles principal. También puedes imprimirla o guardarla como PDF con el botón "🖨️ Imprimir esta ayuda" de esta misma ventana.
No quiero que aparezca la pantalla de bienvenida cada vez que abro la app	Marca la casilla "No volver a mostrar esta pantalla al iniciar" antes de pulsar "Ver la ayuda" o "Ir directo a la aplicación". Si cambias de navegador o borras los datos de navegación, volverá a aparecer.