LeoneraKeyboard
Teclado personalizado para iOS escrito en SwiftUI, sin dependencias externas.
Cada tecla tiene una acción principal (el carácter grande) y, opcionalmente, una
acción secundaria que se muestra como un símbolo pequeño en la parte superior:
- Tocar la tecla escribe el carácter principal.
- Deslizar hacia abajo escribe el símbolo secundario o ejecuta su acción
(emojis, pegar, borrar palabra…).
Mantener pulsadas las teclas de borrar o de mover el cursor repite la acción.
Pulsar dos veces mayúsculas activa el bloqueo de mayúsculas.
Distribución por defecto
1☺ 2" 3# 4$ 5% 6& 7/ 8( 9) 0📋
Q_ W\ Eé R| T< Y> Uú Ií Oó P•
Aá S/ D: F; G[ H] J¡ K! L@ Ñ🎤(dictar)
⇧ Z+ X- C* V¿ B? N, M. ⌫(borrar palabra)
⌨︎(ocultar) espacio ⏎
Personalización
La app incluye un editor donde se puede:
- Editar cada tecla: acción principal, acción secundaria, etiqueta y ancho.
- Añadir, eliminar, reordenar y mover teclas entre filas; añadir, mover y eliminar filas.
- Ajustar mayúscula automática, minúsculas, sonido, alto de fila, la distancia
de deslizamiento y el cursor (aceleración y velocidad máximas, y curva).
- Mover el cursor como con un trackpad: al mantener pulsada la barra espaciadora
las teclas se quedan vacías y arrastrar el dedo a izquierda o derecha mueve el
cursor. Los ajustes del cursor muestran una gráfica con la curva: la velocidad del
cursor (en caracteres por segundo) depende de la aceleración del dedo (en puntos
por segundo). Por debajo de la aceleración mínima el cursor no se mueve; a partir
de ella sube según la curva, que va de lineal (1,0) a progresiva (2,5), hasta la
aceleración máxima; por encima de ella el cursor va a la velocidad máxima. Cada carácter que avanza el cursor vibra según los ajustes de vibración.
- Definir el área de toque de cada tecla: forma cuadrada o circular, centrada en la
tecla, con anchura y altura en porcentaje. Tocar fuera de esa área no hace nada.
La barra espaciadora siempre ocupa toda la anchura; solo le afecta la altura.
La vista previa de los ajustes muestra una tecla a tamaño real dentro de la forma.
- Configurar la vibración: tipo (Ligero, Medio, Fuerte, Suave o Rígido), intensidad y duración.
La tecla vibra en cuanto se toca, tanto para el carácter principal como para el
secundario (no espera a que se suelte). La vibración nunca hace esperar al teclado:
se reproduce en segundo plano y cada pulsación corta la vibración anterior.
- Exportar e importar la configuración completa como JSON.
- Restablecer la distribución por defecto.
Acciones disponibles: texto, espacio, borrar, borrar palabra, mayúsculas, bloqueo
de mayúsculas, intro, tabulador, ocultar teclado, siguiente teclado, emojis, dictar,
pegar, copiar, cortar y mover el cursor.
Dictado
La acción Dictar (en la distribución por defecto, deslizando hacia abajo la
tecla Ñ) cambia el teclado por una pantalla con un botón de grabar en el centro y
un interruptor Mejorar texto con IA:
- Toca el botón para grabar y vuelve a tocarlo para terminar.
- El audio se envía a Groq (
/audio/transcriptions) para convertirlo en texto
con el modelo de voz a texto elegido.
- Con el interruptor activado, la transcripción se envía después al LLM elegido
(
/chat/completions) con un prompt que corrige la puntuación, los signos, la
ortografía y que el texto tenga sentido.
- El texto se escribe donde está el cursor.
En la app, Dictado permite configurar la API key, una URL de API personalizada
(cualquier servicio compatible con la API de OpenAI), los modelos de voz a texto y
LLM (se pueden escribir o elegir de la lista que devuelve la API), el idioma del
audio y el prompt. Por defecto se usan whisper-large-v3-turbo y
openai/gpt-oss-120b. Estos ajustes se guardan aparte y no se incluyen al exportar
la configuración, para no compartir la API key.
iOS normalmente no deja que un teclado use el micrófono, así que la app graba por
él: la primera vez que dictas, el teclado abre Leonera Keyboard, que activa el
micrófono y empieza a grabar; vuelve a la app anterior (botón «◀︎» de la barra de
estado) y termina la grabación desde el teclado. Por defecto, el micrófono se
cierra al salir de la pantalla de dictado, cambiar de app o cerrar el teclado. Si
activas Cierre automático del micrófono en Dictado, queda activo en segundo
plano (con el indicador naranja) para los siguientes dictados y se desactiva tras
5 minutos sin usarlo o desde la app. Si el sistema sí permite
grabar desde el teclado, se graba directamente sin abrir la app.
El teclado recuerda la pantalla que tenía abierta (teclado, emojis o dictado) y la
vuelve a mostrar al reaparecer, así que tras grabar en la app de Leonera vuelves al
dictado. Para volver a la app donde escribías usa el botón «◀︎» de la barra de estado:
iOS no deja a una app abrir la anterior.
Dictar requiere Permitir acceso completo y permiso de micrófono. Si ya tenías
una distribución guardada, la tecla Ñ no cambia: añade la acción «Dictar» a la
tecla que quieras desde el editor o restablece la distribución por defecto.
La app guarda la configuración en un App Group compartido
(group.com.leonardoramirezr.leonerakeyboard) y la extensión la vuelve a leer cada vez que
aparece el teclado, cuando la app que lo usa vuelve a primer plano y en cuanto la
app avisa de un cambio, así que los ajustes se aplican sin reiniciar el teclado.
Activar el teclado
- Instala la app.
- Ajustes › General › Teclado › Teclados › Añadir teclado › Leonera.
- Activa Permitir acceso completo para pegar, vibración/sonido, dictar y para
que el teclado lea la distribución personalizada desde la app.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
