Configuración

Cambia el idioma de la interfaz en F9 → Opciones → Idioma. Elige inglés, chino simplificado, portugués (Portugal), español o ruso y pulsa Enter; Esc cancela. La elección se guarda en config.toml como language = "en", "zh-CN", "pt", "es" o "ru". BORG_LANGUAGE tiene prioridad sobre el ajuste guardado. Si no se ha definido ninguno de los dos, Borg sigue LC_ALL, LC_MESSAGES o LANG, y usa el inglés para los idiomas que no admite. Los comandos, las rutas, los nombres de archivo y los atajos de teclado nunca se traducen. El menú de idioma de este sitio web cambia el idioma de la guía por separado.

Los ajustes se guardan en ~/.config/borg-commander/config.toml, o en la carpeta indicada por $XDG_CONFIG_HOME o $BORG_CONFIG_DIR. F9 → Opciones → Configuración los muestra como casillas; Space o un clic activa o desactiva un ajuste y lo guarda al instante. Esc cierra la ventana. Borg lee el archivo ajuste por ajuste. Un ajuste que no tiene, o un valor que no puede usar, solo afecta a ese ajuste: Borg dice en qué línea está al arrancar y usa ahí su valor por defecto. Cuando Borg guarda un ajuste cambia solo ese y conserva el resto del archivo, con tus comentarios, tal como lo escribiste. Un ajuste de una versión anterior se lee como lo que lo sustituyó y sale del archivo en el siguiente guardado. Un archivo que no es TOML en absoluto hace que Borg arranque con sus valores por defecto, y el primer ajuste que guardes después conserva ese archivo junto al nuevo como config-unreadable.toml.

theme = "neon"              # midnight, aurora, neon, classic, paper, ember, or your own
icon-style = "auto"         # auto, nerd, or portable; Ghostty gets rich icons automatically
icon-spacing = 1            # spaces after an icon, 1 to 3
status-line = true
menu-bar = false            # keep the menu bar visible
show-hidden = false
return-to-panels = true    # return after commands launched from the panels
restore-terminal = false    # bring back the shell scrollback on the next start
screensaver = true          # one of five animations, picked at random
screensaver-after = 300     # seconds of idle time
update-check = true         # offer a new release once a day
start-service = true        # start the background service when Borg opens
graphics = "auto"           # auto, kitty, sixel, iterm or off
relay = "wss://relay.example.com"  # the relay for borg cloud

[plugins]
git = true
system = true
docker = true
docker-console = true       # the command line follows container panels into the container
agent-log = true            # keep a log of what agents do in each session
agent-cloud = true          # paired computers reach this borg through borg cloud
agent-ask-reads = false     # reads from another computer wait for approval

[search]
exclude = ["*.min.js", "fixtures/large"]  # paths below the search folder, as in .gitignore
artifacts = true            # leave out node_modules, Cargo's target and cache-tagged folders
ignore-files = true         # follow .gitignore, .ignore, .rgignore and .borgignore
history = true              # remember searches for Ctrl-P and Ctrl-N

[index]
roots = ["~/Projects"]      # folders indexed for instant search
refresh-minutes = 15        # rebuild an index once it is this old

[folders]
hotlist = ["~/Projects", "/srv/www"]  # pinned with Ctrl-\ and Insert
history = true              # remember the folders the panels open

[network]
proxy-ca = "~/dev-ca"       # the CA folder for captures through Borg's proxy
keep-free-mib = 1024        # stop captures before the disk has less than this free

[watch]
on = false                  # watch what starts, in the background service
freeze = true               # stop a process a rule is sure about
learning-days = 7           # learn what is normal here before freezing anything, 365 at most
alerts-per-minute = 20      # processes written about before Borg only counts them
freezes-per-minute = 5
keep-running = ["backup-agent"]  # programs Borg never freezes

[[watch.allow]]
program = "/bin/sh"         # allowed starts: program, parent, user, or any of them together
parent = "nginx"

[watch.notify.telegram]     # send alerts as they happen, see Alerts off the machine
token = "123456:ABC"
chat = "123456789"

En un terminal local con color verdadero, Borg arranca con una breve animación de su logotipo con efecto glitch; cualquier tecla o clic la omite. Por SSH, y en terminales sin color verdadero, se abre directamente en los paneles.

Tras screensaver-after segundos sin actividad, Borg muestra uno de cinco salvapantallas, elegido al azar: un cubo que gira en un campo de estrellas, el logotipo con efecto glitch, un reloj con las letras de bloques del logotipo que se desgarra con cada nuevo minuto, el logotipo que gira en espiral hasta formar una galaxia y vuelve, o el logotipo reconstruido tabla a tabla mientras las tablas viejas forman un segundo logotipo debajo. Cualquier tecla o clic devuelve los paneles, y esa tecla no hace nada más. La aprobación que pide un agente termina el salvapantallas por sí sola, así que nunca espera detrás de él.

Los temas personalizados van en ~/.config/borg-commander/themes/. Un tema puede extender uno de los integrados:

name = "Deep Space"
extends = "neon"

[styles]
cursor = { fg = "#0b0b16", bg = "#00e5ff", bold = true }
dir = { fg = "#b388ff", bold = true }

Archivos de Borg

Las carpetas de los paneles, las posiciones del cursor, la división, los modos de listado y la ordenación se guardan en la carpeta de estado, ~/.local/state/borg-commander, o en la carpeta indicada por $XDG_STATE_HOME o $BORG_STATE_DIR.

Mientras se ejecuta, Borg guarda sus scripts de integración con el shell y los archivos copiados desde contenedores en su carpeta de ejecución, $XDG_RUNTIME_DIR/borg-commander, o en borg-commander-<uid> dentro de la carpeta temporal. Solo tú puedes abrir esta carpeta; si ya existe una creada por otra persona, o en la que pueden entrar otros usuarios, Borg la ignora y usa otro nombre. Su archivo TTL empieza con la hora hasta la que la carpeta está en uso: cada borg en ejecución adelanta esa hora un día cada hora, así que, una vez pasada, la carpeta se puede eliminar.

F9 → Opciones → Archivos de Borg… muestra cada lugar donde Borg guarda archivos, cuánto ocupa cada uno y dónde está:

• Archivos temporales: scripts de integración con el shell, peticiones de cambio de carpeta desde el shell, copias desde contenedores, vistas previas remotas, archivos descomprimidos de archivos comprimidos para el visor y el editor, y los certificados del proxy de una captura, en la carpeta de ejecución.
• Sockets: por donde los agentes y los espejos llegan a las sesiones en curso, en /tmp/borg-<uid>-default, o en una carpeta /tmp/borg-<uid>- con el nombre de la carpeta de ejecución cuando $XDG_RUNTIME_DIR está definida.
• Cachés: tamaños de carpeta e índices de nombres, en la carpeta de caché (consulta Análisis de tamaño guardados).
• Sesiones e historial: sesiones, salida del shell, registro remoto, historial de búsquedas y carpetas, colecciones, equipos emparejados con sus claves y lo que Borg aprendió sobre tus discos (drives.json), en la carpeta de estado.
• Configuración: config.toml y tus temas.
• Capturas: las capturas de tráfico que guardó Borg, estén donde estén.

Up y Down eligen una fila, y una nota breve bajo la lista dice qué guarda el lugar elegido y cuánto tiempo se conserva. Enter abre la carpeta de ese lugar en el panel activo. Esc cierra la ventana.

Borg limpia por su cuenta 30 segundos después de arrancar y luego cada hora. Solo elimina nombres que crea él mismo, y nunca nada que haya cambiado en los últimos 10 minutos, así que un Borg que está arrancando conserva lo que acaba de crear. Esto es lo que se elimina:

• Carpetas de otras versiones de Borg en la carpeta de ejecución, cuando ya ningún Borg se ejecuta desde ellas y, además, ningún Borg estaba en marcha cuando arrancó este o nada en ellas ha cambiado en 3 días.
• Peticiones de cambio de carpeta, archivos a medio escribir, carpetas de consolas remotas y certificados del proxy de capturas de procesos de Borg que terminaron.
• Copias desde contenedores, vistas previas remotas y archivos descomprimidos para el visor y el editor de más de un día.
• Sockets en los que nadie responde, y carpetas de sockets en las que ya no responde nada.
• Análisis de tamaño en el formato de Borg 0.4 y 0.5, análisis que la caché ya no lista e índices de nombres de carpetas que ya no se indexan.
• Carpetas de ejecución que versiones antiguas de Borg dejaron abiertas a otros usuarios, cuando nada en ellas ha cambiado en 3 días.

Las sesiones, el historial, la configuración y las capturas se conservan hasta que los elimines. La línea bajo la nota dice cuánto sobra ahora mismo y qué eliminó la última limpieza. F8 elimina los restos tras preguntar. La pregunta indica las carpetas de las que vienen y empieza en No, así que pulsa Y para eliminarlos.

Cada captura que guarda Borg entra en una lista de las 1000 más recientes. La ventana muestra las que siguen en el disco bajo Capturas guardadas por Borg, con su tamaño y fecha, y con claves cuando junto a una hay un archivo .keylog con el mismo nombre. Enter sobre una captura abre su carpeta con el cursor en el archivo, y ahí F8 la elimina. Las capturas guardadas antes de que Borg empezara a llevar esta lista no aparecen en ella.

borg storage muestra los mismos lugares en el terminal y dice lo que sobra, y borg storage clean lo elimina.

Para compilar, probar o contribuir, consulta Desarrollo.