Manual de usuario de Berth

SFTP · Terminal · Consola serie en una sola ventana — desde añadir un servidor hasta los atajos de teclado

🚀Primeros pasos

Diseño de la pantalla

Una sola ventana con cuatro zonas.

• Barra lateral de sitios — a la izquierda. Servidores, consolas serie y carpetas, en forma de árbol.
• Columna de sesiones — las sesiones conectadas. Una franja de color indica a qué servidor pertenece cada una.
• Área de trabajo — arriba el panel de archivos (local y remoto), abajo la Terminal. Arrastra la línea divisoria para cambiar la proporción.
• Barra de estado — abajo del todo. Indica qué está ocurriendo en cada momento.

Añadir el primer servidor

1. Haz clic derecho en una zona vacía de la barra lateral, o pulsa ⌘N.
2. Escribe el nombre y la dirección del servidor. Si dejas en blanco el usuario o el puerto, se usan los valores por defecto.
3. Al hacer doble clic en la lista, te conectas. Un solo clic selecciona.

Cambiar el idioma

En el menú Berth › Ajustes (⌘,) elige uno de los 20 idiomas. Por defecto sigue el idioma del sistema, y el idioma elegido se aplica solo a esta aplicación. El cambio se aplica al reiniciar la aplicación.

🗂Servidores y carpetas

Agrupar en carpetas y heredar ajustes

Al agrupar servidores en una carpeta (⌘⇧N), los ajustes bajan en cascada. Si defines el nombre de usuario o el nivel de precaución una sola vez en la carpeta, todos los servidores de debajo lo heredan. Es el mecanismo que evita escribir el mismo valor veinte veces para veinte servidores.

Cada campo de la ventana de ajustes indica debajo de dónde viene ese valor (si lo definiste tú o lo heredaste de una carpeta), y un botón para restablecerlo lo devuelve a la herencia.

Nivel de precaución — Desarrollo · Staging · Producción

El nivel manda sobre el color. Con Producción, las acciones peligrosas piden confirmación adicional. En la lista de sesiones se rellena con el color que elijas y se marca con un borde rojo, así varios servidores de producción se distinguen por el color. Donde solo se ve uno a la vez (diálogos de confirmación y similares), permanece rojo como aviso fuerte.

Reglas de clic

• Un clic — seleccionar (para ver o mover los ajustes)
• Doble clic — conecta si es un servidor, expande/contrae si es una carpeta
• El triángulo delante de la carpeta la expande con un solo clic.

🔑Conexión y autenticación

Al conectar por primera vez — permiso de carpeta

Berth sigue las reglas de la App Store (zona protegida), así que no lee la carpeta de inicio libremente. Al abrir un servidor por primera vez, pide elegir una vez la carpeta donde están la configuración SSH, las claves y known_hosts (normalmente ~/.ssh). Una vez elegida se recuerda y no se vuelve a preguntar. Si tienes las claves en otro sitio, también puedes elegir la carpeta de inicio.

Por la misma razón, el panel de archivos local también usa la carpeta que elegiste como raíz — puedes cambiarla con Abrir carpeta local… en la cabecera del panel, y esto también se recuerda.

Lectura de ~/.ssh/config

Al conectar con un alias se leen y usan el host, el puerto, el usuario, el archivo de clave, ProxyJump y StrictHostKeyChecking de esa entrada. Aunque el puerto guardado esté desactualizado, gana el archivo de configuración.

Método de autenticación

• Automático — se deja en manos de ssh. Prueba todas las claves predeterminadas y, si ninguna funciona, pide la contraseña en la Terminal.
• Archivo de clave — usa solo una clave, la que indiques.
• Contraseña — se salta las claves.

Cuando el servidor pregunta

Si guardas la contraseña, se responde una vez automáticamente al conectar. Para el resto de preguntas — el código de verificación en dos pasos, volver a escribir una contraseña incorrecta, la contraseña de una clave protegida — aparece la pregunta tal como la envía el servidor en la ventana "El servidor ha enviado una solicitud" y la respondes tú mismo. Para que la cuenta no se bloquee, la contraseña guardada solo se introduce automáticamente una vez, y se pregunta como máximo tres veces.

Dejar de escribir la contraseña

Haz clic derecho en el servidor y elige Registrar clave pública en este servidor… para subir la clave pública de ~/.ssh al servidor. A partir de ese momento te conectarás con la clave.

La contraseña guardada solo está en el Llavero de macOS. En el archivo de configuración solo queda la marca de que "está guardada", el valor no se almacena ahí.

Servidor nunca visto, clave de host cambiada

La primera vez que te conectas a un servidor, se muestran el tipo y la huella de la clave y se pregunta si quieres recordarla. Si la recuerdas, se escribe en ~/.ssh/known_hosts con el mismo formato que usa ssh, y no se vuelve a preguntar.

También aparece cuando la identidad del servidor es distinta de la vez anterior. Puede ser un ataque de intermediario o simplemente que reinstalaste el servidor. Berth no decide por ti, te da los datos — el tipo y la huella de la clave antigua y la nueva, y hasta el comando para comprobarlo directamente en la consola del equipo. Después de comprobarlo, si pulsas "Eliminar la clave antigua y recordar la nueva" se elimina la entrada anterior (con copia de seguridad en known_hosts.old) y se escribe la nueva clave.

Panel de archivos (SFTP)

Subir y descargar archivos

A la izquierda está tu Mac, a la derecha el servidor. Arrastra y suelta, o usa ⌥⌘→ (subir) · ⌥⌘← (descargar) para enviar archivos. El progreso se acumula en la fila de transferencias.

El panel de archivos que sigue a la Terminal

Al hacer cd en la Terminal, el panel remoto sigue a la misma carpeta. Cuando este seguimiento estorba, se desactiva con ⌘⇧L.

Lugares frecuentes · vistas

• ⌘D — fija o quita la ruta actual del pin. Los pines son la raíz del árbol.
• ⌘↓ — entra en la carpeta seleccionada. ⌘↑ retrocede un nivel.
• ⌥⌘T — vista de árbol ↔ lista. Para carpetas con miles de archivos, la lista es mejor.
• ⌘R — volver a leer.
• ⌘⇧F — buscar en el servidor. No es la aplicación la que recorre la lista, es el servidor quien ejecuta find.

Ver diferencias

Al activarlo con ⌘⇧Y se comparan lo local y lo remoto lado a lado, mostrando lo que es distinto y lo que solo está en un lado. Úsalo cuando quieras enviar solo lo necesario.

Eliminar

⌘⌫ mueve por defecto a la papelera del lado del servidor, y siempre pide confirmación. En un servidor con la papelera desactivada se avisa de antemano de que no se podrá deshacer.

⌨️Terminal

Es una shell real donde vim, tmux y less funcionan tal cual. Selecciona arrastrando con el ratón y copia con ⌘C: el comando se pega limpio, sin los espacios de relleno del final de línea.

Confirmar antes de pegar

Al pegar varias líneas, se muestra antes qué va a ejecutarse. Un pegado con saltos de línea se convierte ahí mismo en comandos. Lo que parece peligroso se marca con el motivo.

Vista amplia

⌘↩ amplía la zona actual y, al pulsarlo de nuevo, vuelve atrás. ⌥⌘↩ amplía solo un panel. El tamaño del texto se ajusta con ⌘+ · ⌘- · ⌘0. Limpia el terminal con ⌘L: se borran la pantalla y el historial de desplazamiento, y solo queda la línea de comando actual.

🔌Consola serie (UART)

Elegir el dispositivo

Con ⌃⌘N añades una consola serie y eliges en los ajustes el dispositivo conectado. Berth recuerda el dispositivo, no la ruta — por su número de serie si lo tiene, o por su tipo si no lo tiene. Aunque lo conectes en otro puerto USB, encuentra el mismo dispositivo.

Velocidad y ajustes de línea

La velocidad se elige de la lista o se escribe directamente (también sirven valores fuera del estándar como 1.500.000 — siempre que el adaptador los acepte). Por defecto es 8N1 · sin control de flujo, el valor de la mayoría de las consolas.

• Control de flujo — actívalo solo con un cable de 4 hilos (RTS/CTS). Con un cable de 3 hilos, activarlo lo bloquea.
• Avanzado (paridad · bits) — se expande al hacer clic en la línea. Úsalo solo cuando sea distinto, como el bootloader de STM32 (8E1).

Bloc de notas

En una sesión serie, los comandos que escribes y sus respuestas se acumulan a la derecha con la hora. La entrada en los puntos donde se pide una contraseña se oculta.

⚡Atajos de teclado

Los atajos de la aplicación siempre incluyen ⌘. Las combinaciones con ⌃ · ⌥ son de la shell y de las TUI (vim·tmux), así que la aplicación no las reserva para sí.

❓Preguntas frecuentes

¿Dónde se guarda la contraseña?

Solo se guarda en el Llavero de macOS. En el archivo de configuración solo queda la marca de que "está guardada". El Llavero se abre una única vez, en el momento de conectar.

¿Se recopilan datos de uso?

No. La aplicación no lleva ninguna instrumentación. No cuenta qué abres ni a qué te conectas.

La consola serie se detiene a mitad de camino.

Es una característica de la línea que aparece con comunicaciones de gran volumen en un UART sin control de flujo. Si tienes un cable de 4 hilos, activa el control de flujo (RTS/CTS) en los ajustes; si es de 3 hilos, baja la velocidad en la placa o divide la salida en partes más pequeñas.

¿Hay que reescribir la configuración SSH que ya usaba?

No. Al importar desde ~/.ssh/config se conecta con el mismo alias, leyendo y usando el host, el puerto, el usuario, la clave y ProxyJump de esa entrada.

Tengo una configuración que usa ProxyCommand.

ProxyCommand lanza un programa externo, así que no se puede usar en la zona protegida de la App Store. Si tu configuración pasa por un host de salto, basta con cambiarlo a ProxyJump para que funcione igual. ssh-agent tampoco funciona por la misma razón; las claves se leen directamente y, si la clave tiene contraseña, se pide al conectar.

¿Qué versión de macOS es compatible?

macOS 14 (Sonoma) o posterior, compatible con Apple Silicon e Intel.

Si te ha resultado útil

Berth es gratis. Puedes ayudar a su desarrollo con una donación.