Esta página describe Calíope 1.8, la versión que estoy construyendo ahora mismo. La 1.7 está en la App Store para Mac, iPad, iPhone, Apple Watch, Apple TV y Apple Vision Pro. El changelog dice en qué versión llegó cada función.
Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.
Lee archivos .md, .sql, .json, .csv, .rtf y de texto sin abrirlos en un editor.
Dónde está: Espacio de Trabajo › Herramientas › Previsualizador de archivos
El Previsualizador de archivos muestra el contenido de un archivo local interpretado según su extensión: el Markdown (.md) se representa como documento, el SQL (.sql) con resaltado de sintaxis y numeración de línea, el JSON (.json) reindentado y coloreado, el CSV (.csv, .tsv) como tabla, el texto enriquecido (.rtf) como documento, y el texto plano (.txt, .log) tal cual.
Es una herramienta de solo lectura: no edita, no guarda y no ejecuta nada. Para escribir y ejecutar consultas está el Editor SQL; para trabajar con bases SQLite locales, el Editor SQLite.
Funciona sin conexión a ningún servidor y muestra un archivo a la vez, con una lista de recientes.
Escoge un archivo del disco o reábrelo desde la lista de recientes.
Pulsa Abrir… y escoge cualquier archivo compatible: .md, .sql, .json, .csv, .tsv, .rtf, .txt o .log. El archivo se añade a Recientes, que aparece en la pantalla inicial de la herramienta y guarda los últimos ocho.
Calíope guarda un permiso persistente de cada reciente, así que puedes reabrirlo después de cerrar la app sin volver a buscarlo. Si el archivo se mueve o se borra, el reciente deja de abrirlo y basta con escogerlo otra vez con Abrir….
Cerrar suelta el archivo y detiene la vigilancia de cambios.
En el Mac, Vista rápida —el botón del ojo, o la barra espaciadora— enseña el archivo en el visor del sistema, que abre también lo que el previsualizador no interpreta: PDF, imágenes, documentos de ofimática.
También se abre desde fuera de Calíope. En el Mac, desde el Finder con Abrir con › Calíope, o con doble clic si Calíope es la app por omisión de ese tipo de archivo. En el iPad y el iPhone, compartiéndolo desde la app Archivos y eligiendo Calíope. Un .sql abierto así va al Editor SQL, no aquí, y un archivo SQLite, DuckDB o Parquet, al Editor SQLite o al Editor DuckDB. Si la sesión que tienes delante no ofrece esta herramienta, el archivo se abre en Abrir sin conexión.
Encabezados, listas, tablas, citas y bloques de código.
El render cubre encabezados de # a ######; párrafos con negrita, cursiva, código en línea, tachado y enlaces; listas con y sin numerar, con anidamiento; checklists - [ ] y - [x]; citas >; reglas horizontales; tablas de pipes; y bloques de código con cerca. Si el bloque está etiquetado como sql, se resalta igual que un archivo .sql.
Queda fuera a propósito: las imágenes no se descargan —se muestra su texto alternativo—, el HTML embebido no se interpreta y el front matter del inicio se omite.
Los encabezados se anuncian a VoiceOver como encabezados y todo el texto escala con el tamaño de letra dinámico.
Los archivos de texto enriquecido se leen como documento, con su estructura.
Un archivo .rtf —el que guardan TextEdit, Word o Páginas al exportar— se muestra como documento y no como marcado. Se conservan los encabezados, las listas con su anidamiento y su numeración, la negrita, la cursiva, el subrayado, el tachado, los enlaces, la alineación de los párrafos y los tramos en letra monoespaciada.
Lo que no se aplica es la tipografía del documento: ni la familia de letra, ni los tamaños en puntos, ni los colores. Los pone Calíope, igual que hace con el Markdown, para que el texto escale con el tamaño de letra dinámico y se lea igual de bien en tema claro y en oscuro. Se te recuerda al pie mientras el archivo está abierto.
Los niveles de encabezado se deducen del tamaño de letra relativo al propio documento: el mayor es el nivel 1, el siguiente el 2, y así sucesivamente. Un RTF no declara jerarquía en ninguna parte, así que es lo único que se puede saber.
Queda fuera: los paquetes .rtfd no se abren —son una carpeta, no un archivo—, y las imágenes y objetos incrustados no se muestran; si el documento lleva alguno, se te dice cuántos al pie.
Resaltado de sintaxis y numeración de línea, sin ejecución.
Los archivos .sql se muestran monoespaciados, con número de línea y resaltado de sintaxis: consulta, definición de esquema, control, funciones, tipos, ventana y procedural, más literales de texto, números, comentarios --, # y /* … */, e identificadores entre acentos graves.
No hay botón de ejecutar, y es a propósito: el previsualizador nunca abre una conexión. Si quieres ejecutar el contenido, ábrelo en el Editor SQL.
Por encima de 500 KB el resaltado se desactiva y el archivo se muestra en texto plano; se avisa al pie.
JSON reindentado, CSV como tabla, registros tal cual.
El JSON (.json) se reindenta con dos espacios por nivel y se colorea: claves, texto, números y true/false/null. El orden de las claves es el del archivo —no se reordena nada—, y si el contenido no es JSON válido se avisa al pie y se muestra igualmente lo que se pudo leer. Por encima de 2 MB el formato se desactiva y el archivo se muestra tal como está en el disco.
El CSV (.csv, .tsv) se muestra como tabla, con números de fila y cabecera fija. El separador se detecta —coma, punto y coma, tabulador o barra vertical— y se nombra al pie; se respetan los campos entre comillas, las comillas duplicadas y los saltos de línea dentro de un campo. Se dibujan hasta 10 000 filas y 64 columnas, y cualquier recorte se dice. No ordena ni filtra: es un visor, no una rejilla de datos.
El texto plano (.txt, .log y cualquier extensión no reconocida) se muestra tal cual, monoespaciado y con números de línea. Las líneas de más de 2 000 caracteres se parten para poder dibujarlas, y la marca ↳ indica que es continuación de la anterior.
Los objetos y los arrays se pliegan: el triángulo del margen esconde el contenedor y deja un resumen —[…] o {…}— con el número de miembros; los dos botones de la cabecera pliegan y despliegan el archivo entero. Los contenedores vacíos ya vienen en una sola línea.
Aciertos resaltados, recuento y salto entre ellos.
⌘F abre la barra de búsqueda, y también el botón de la lupa de la cabecera. Se busca texto llano, sin expresiones regulares, y solo sobre lo que se leyó: si el archivo venía cortado a 5 MB, el aviso de arriba lo dice y el resto no se ha mirado.
Los aciertos se pintan encima del contenido sin tapar el resaltado de sintaxis, y el seleccionado va en un tono más fuerte. Intro y ⌘G llevan al siguiente, ⇧⌘G al anterior, y el recuento de la barra dice en cuál estás. El botón Aa distingue mayúsculas y minúsculas. Esc cierra la barra.
Funciona en todos los tipos: en el CSV se ilumina la celda y se señala su fila; en el Markdown y el texto enriquecido, el texto dentro del bloque —en los bloques de código el acierto se cuenta y se salta a él, pero no se ilumina, porque conservan su propio resaltado—; y en el JSON, un acierto escondido dentro de un contenedor plegado lo despliega al saltar a él. Se cuentan hasta 5 000 aciertos, y a partir de ahí la barra muestra un +.
La vista se actualiza sola cuando el archivo cambia en el disco.
Mientras el archivo está abierto, Calíope vigila su ruta. Si lo guardas desde otro programa, la vista se actualiza sola —con un indicador de Actualizado durante unos segundos— y conserva la posición de lectura. También puedes forzarlo con Recargar.
La vigilancia sobrevive al guardado atómico, el que hacen TextEdit, Xcode o vim reemplazando el archivo en vez de reescribirlo: sigue refrescando después del segundo y del tercer guardado.
Si el archivo desaparece, la herramienta lo dice sin tratarlo como un error: borrar un archivo no es un fallo.
Límites: de un archivo grande se leen los primeros 5 MB —arriba se indica cuánto se está mostrando—, el resaltado SQL se desactiva por encima de 500 KB, el formato de JSON por encima de 2 MB, y de un CSV se dibujan hasta 10 000 filas y 64 columnas. Todo recorte se dice al pie de la vista.
Cómo detecta la codificación de un archivo de texto, dónde la enseña y qué dice cuando no puede leerlo.
Dónde está: Espacio de Trabajo › Herramientas › Previsualizador de archivos
Para leer un archivo de texto, el Previsualizador busca primero una marca de orden de bytes (UTF-8, o UTF-16 en los dos órdenes). Sin ella, toma el archivo por binario si encuentra un byte NUL cerca del principio; si no, prueba UTF-8, después la detección del sistema, después Windows-1252 e ISO-8859-1, en ese orden. La codificación que encuentra sale en la cabecera junto al tipo de archivo.
Un archivo binario, o uno que no puede descifrar, enseña «Archivo binario o codificación de texto no soportada.». Cuando un archivo grande se recorta, el corte cae en un límite de carácter limpio.
Mira las tablas y las primeras filas de un archivo SQLite, DuckDB o Parquet sin abrir Calíope.
Con Calíope instalado, la Vista rápida del sistema enseña una base SQLite, una base DuckDB o un archivo Parquet como tablas, sin abrir la app. En el Mac, selecciona el archivo en el Finder y pulsa la barra espaciadora. En el iPad y el iPhone, tócalo en la app Archivos, o abre su vista previa desde cualquier app que enseñe archivos.
Arriba van el nombre del archivo, su tipo, su tamaño y el motor que lo leyó, y después la lista de tablas, cada una con su número de filas y sus columnas con su tipo. Debajo, las primeras 20 filas de cada tabla, una detrás de otra; en una base con más de diez tablas sólo las diez primeras enseñan filas y el resto se queda en la lista. Un archivo Parquet es una sola tabla, con los tipos que infiere DuckDB. En una base DuckDB, las vistas, las secuencias y las macros van en Otros objetos, sin filas.
La vista previa nunca escribe: no crea ningún archivo junto al original ni cambia su fecha de modificación. Por eso una base SQLite en modo WAL enseña lo que está guardado en el archivo principal, y lo dice: los cambios que siguen en su archivo -wal no aparecen.
En el Mac, un archivo TSV también se abre como tabla. Un CSV lo enseña el propio macOS, como tabla sin tipos; en el iPad y el iPhone el sistema enseña el CSV como tabla y el TSV como texto. Para verlos como tabla con tipos, ábrelos en Calíope.
Aquí no se edita ni se consulta nada: para ejecutar SQL, abre el archivo en Calíope con el botón que el sistema pone encima de la vista previa. Apple Vision Pro no carga las vistas previas de otras apps, así que allí el sistema enseña su propia tarjeta con el nombre y el tamaño del archivo.
Palabras clave: vista rápida, quick look, barra espaciadora, finder, archivos, vista previa, sqlite, duckdb, parquet, tsv, csv
Vista rápida: límites y archivos que no puede leer
Unos tres segundos por vista previa, archivos grandes, bases cifradas y escrituras pendientes.
Una vista previa tiene unos tres segundos para leer el archivo. Lee primero lo que más enseña —la lista de tablas, después las filas de las primeras y por último los recuentos de filas— y si se acaba el tiempo se para ahí y lo dice: abre el archivo en Calíope para ver el resto. Una base con cientos de tablas enseña su lista entera en menos de un segundo; con miles, la vista previa se detiene a esos tres segundos con la lista completa y las filas de las diez primeras.
El tamaño por sí solo no es un problema, porque sólo se leen las primeras filas: un archivo SQLite de 2 GB se abre en un par de segundos. Lo que no se cuenta es un archivo TSV de más de 50 MB en el Mac: enseña Filas sin contar y sus 20 primeras filas.
Cuando un archivo no se puede leer, la vista previa dice por qué en vez de quedarse en blanco:
- una base SQLite cifrada, o un archivo que no es una base de datos;
- en el Mac, una base DuckDB con escrituras pendientes en su archivo .wal: ábrela en Calíope para terminar de escribirla;
- un archivo dañado: la vista previa enseña el motivo que da el motor;
- una base sin tablas lo dice.
Calíope abre con normalidad una base DuckDB con escrituras pendientes: en el Mac sólo la vista previa no puede aplicarlas, porque el sistema sólo le deja leer el archivo que le da. En el iPad y el iPhone, desde la app Archivos, la vista previa sí lee el archivo .wal y enseña la base con esas escrituras.
Palabras clave: vista rápida, límite, tiempo, grande, cifrada, wal, dañado, filas sin contar