Solución de problemas

Q: ¿Por qué Paneflow falla con un error de GPU o renderizado?

Linux: Paneflow necesita una sesión gráfica y un controlador GPU compatible con Vulkan. Ejecuta esto en un terminal de esa sesión: Si no se encuentra vulkaninfo, instala el paquete vulkan-tools con el gestor de paquetes de tu distribución. La ausencia de esta herramienta no significa que Vulkan no esté disponible. Si el comando falla o no muestra ninguna GPU, comprueba el cargador Vulkan y el controlador. El paquete del cargador es libvulkan1 en Debian/Ubuntu, vulkan-loader en Fedora o vulkan-icd-loader en Arch. Instala el controlador Vulkan para tu GPU: Mesa para las GPU Intel/AMD compatibles o el controlador NVIDIA adecuado. Reinicia Paneflow y conserva el error si continúa. macOS: Comprueba que usas macOS 13 Ventura o posterior en un Mac Apple Silicon. Actualiza macOS y vuelve a intentarlo. Consulta los requisitos de instalación en macOS. Windows: Ante NoSupportedDeviceFound, actualiza el controlador GPU desde el fabricante del PC o de la GPU y reinicia Paneflow. Debe admitir DirectX 11, nivel de característica 10 o superior. Recopila los datos de la GPU y del controlador:

Q: ¿Por qué no funcionan mis atajos?

Cada entrada de shortcuts asigna una combinación de teclas a una acción. Este ejemplo crea una pestaña con ctrl+shift+t y desactiva ctrl+shift+w. Añade estas entradas a la configuración existente: Usa nombres de la referencia de atajos de teclado, como new_tab, split_horizontally o toggle_search. Las acciones desconocidas se omiten con una advertencia. Si un atajo falla solo en una zona, comprueba qué vista tiene el foco. Las acciones de Terminal, Search, Markdown y Diff tienen sus propios contextos.

Q: ¿Por qué mi tema no se recarga en caliente?

Usa "One Dark" o "PaneFlow Light" en la clave theme del primer nivel. Consulta los ajustes y ejemplos de temas. Comprueba la ruta de configuración, incluida la variable PANEFLOW_HOME. Comprueba la sintaxis JSON y el nombre del tema, y guarda el archivo. Espera un momento. Si el cambio no se aplica, reinicia Paneflow. Si reiniciar aplica el cambio pero guardar no, informa del problema e indica si el archivo está en una unidad de red o un sistema de archivos montado.

Q: ¿Por qué paneflow no está en mi PATH?

La solución depende de cómo instalaste la aplicación: Linux: .deb y .rpm instalan el comando en una carpeta del sistema. AppImage y .tar.gz pueden necesitar ~/.local/bin en PATH. Sigue las instrucciones de Linux para el comando y PATH. macOS: Instalar PaneFlow.app con Homebrew o un DMG no añade automáticamente el ejecutable al PATH del shell. Sigue las instrucciones de acceso desde el terminal en macOS. Windows: Después del MSI, cierra los terminales y abre PowerShell desde el menú Inicio. Si sigue faltando el comando, sigue los pasos para encontrar el comando en Windows.

Q: ¿Qué debo incluir en un informe de error?

Si la aplicación se abre, selecciona Help > System Info y después Copy. Añade ese bloque, el shell, el error exacto, los pasos para reproducirlo y el resultado esperado. Indica qué comprobaciones de esta página has probado. Si la aplicación no se abre, indica manualmente la versión de Paneflow, la del sistema operativo, la arquitectura, el formato de instalación y los datos de la GPU y del controlador. En Windows, winver muestra la versión y la compilación. Usa el informe para tu plataforma: Informar de un error en Linux o macOS: Versión, servidor de pantalla, GPU, pasos para reproducirlo y salida de la aplicación. Informar de un error en Windows: Compilación de Windows, controlador GPU, shell, pasos para reproducirlo y salida de la aplicación. Para recopilar la salida de la aplicación, cierra primero Paneflow y ejecútalo en un terminal con el registro activado. En Linux o macOS: En Windows, con la carpeta predeterminada del MSI: Si falta el comando o el ejecutable, sigue la sección PATH o usa la ruta completa. Para una instalación DMG en macOS, sustituye paneflow por /Applications/PaneFlow.app/Contents/MacOS/paneflow. Reproduce el problema y copia la salida relevante del terminal en el informe. Elimina tokens, rutas privadas o contenido del proyecto antes de publicarlo. El puente MCP de solo lectura lee la salida de los paneles. Usa los comandos anteriores para recopilar los registros de la aplicación ante problemas de inicio, configuración o renderizado.

Resuelve problemas de inicio, gráficos, configuración, atajos, temas, PATH y firma de Paneflow. Comprueba el síntoma y reúne datos para un informe de error.

Última actualización el 2 de octubre de 2026

Busca el síntoma y sigue las comprobaciones correspondientes. Cambia una cosa cada vez para saber qué ha ayudado. Si el problema persiste, recopila los diagnósticos al final de esta página.

Síntoma	Plataforma	Primera comprobación
Error de GPU o renderizado al iniciar	Linux	Comprueba Vulkan y el controlador gráfico.
Ventana en blanco bajo Wayland	Linux	Compara el inicio en Wayland con XWayland.
`NoSupportedDeviceFound` al iniciar	Windows	Actualiza el controlador GPU y anota su versión.
Cambio de configuración ignorado	Todas	Comprueba la ruta, la sintaxis JSON y el tipo del ajuste.
Atajo sin efecto	Todas	Comprueba la acción y la vista activa de la aplicación.
Cambio de tema ignorado	Todas	Comprueba el nombre del tema y guarda la configuración.
Comando `paneflow` no encontrado	Todas	Sigue los pasos de PATH para tu instalación.
Gatekeeper bloquea la aplicación	macOS	Comprueba el origen de la descarga y la alerta exacta.
SmartScreen bloquea el MSI	Windows	Verifica la firma y el editor del instalador.

Arranque y renderizado

¿Por qué Paneflow falla con un error de GPU o renderizado?

Linux: Paneflow necesita una sesión gráfica y un controlador GPU compatible con Vulkan. Ejecuta esto en un terminal de esa sesión:

bash

vulkaninfo --summary

Si no se encuentra vulkaninfo, instala el paquete vulkan-tools con el gestor de paquetes de tu distribución. La ausencia de esta herramienta no significa que Vulkan no esté disponible.

Si el comando falla o no muestra ninguna GPU, comprueba el cargador Vulkan y el controlador. El paquete del cargador es libvulkan1 en Debian/Ubuntu, vulkan-loader en Fedora o vulkan-icd-loader en Arch. Instala el controlador Vulkan para tu GPU: Mesa para las GPU Intel/AMD compatibles o el controlador NVIDIA adecuado. Reinicia Paneflow y conserva el error si continúa.

macOS: Comprueba que usas macOS 13 Ventura o posterior en un Mac Apple Silicon. Actualiza macOS y vuelve a intentarlo. Consulta los requisitos de instalación en macOS.

Windows: Ante NoSupportedDeviceFound, actualiza el controlador GPU desde el fabricante del PC o de la GPU y reinicia Paneflow. Debe admitir DirectX 11, nivel de característica 10 o superior. Recopila los datos de la GPU y del controlador:

powershell

Get-CimInstance Win32_VideoController |
  Select-Object Name, DriverVersion, DriverDate

¿Por qué mi sesión Wayland queda en blanco?

Una ventana en blanco puede estar relacionada con el controlador gráfico o el servidor de pantalla. Por sí sola no identifica la causa. Comprueba Vulkan como se indica arriba, cierra Paneflow y prueba XWayland desde la misma sesión gráfica:

bash

env -u WAYLAND_DISPLAY paneflow

Necesitas XWayland y una variable DISPLAY funcional. El comando selecciona X11 solo para este inicio. Si Paneflow se abre así, úsalo como solución temporal, busca actualizaciones del controlador gráfico e incluye los resultados de ambos inicios en el informe.

Configuración y atajos

¿Por qué no carga mi paneflow.json?

Comprueba que has editado la configuración que usa la aplicación en ejecución. Las versiones publicadas usan estas rutas de forma predeterminada:

Plataforma	Ruta
Linux y macOS	`~/.paneflow/paneflow.json`
Windows	`%USERPROFILE%\.paneflow\paneflow.json`

Una ruta absoluta en PANEFLOW_HOME cambia esta carpeta. Si usas esa variable, adapta las rutas de los siguientes comandos.

En Linux o macOS, con Python 3 instalado:

bash

python3 -m json.tool ~/.paneflow/paneflow.json

En Windows:

powershell

Get-Content $env:USERPROFILE\.paneflow\paneflow.json -Raw |
  ConvertFrom-Json | Out-Null

Corrige los errores de sintaxis, guarda y vuelve a intentarlo. Si falta el archivo, se usan los valores predeterminados. Una configuración inválida al iniciar también usa esos valores; un cambio inválido durante la ejecución conserva la última configuración válida.

Estos comandos comprueban la sintaxis JSON. Usa la referencia del esquema de configuración para comprobar nombres, tipos y valores permitidos. La aplicación ignora las claves desconocidas del primer nivel, por lo que una errata puede parecer un ajuste sin efecto.

Los cambios de window_decorations y window_backdrop requieren reiniciar.

¿Por qué no funcionan mis atajos?

Cada entrada de shortcuts asigna una combinación de teclas a una acción. Este ejemplo crea una pestaña con ctrl+shift+t y desactiva ctrl+shift+w. Añade estas entradas a la configuración existente:

json

{
  "shortcuts": {
    "ctrl+shift+t": "new_tab",
    "ctrl+shift+w": "none"
  }
}

Usa nombres de la referencia de atajos de teclado, como new_tab, split_horizontally o toggle_search. Las acciones desconocidas se omiten con una advertencia.

Si un atajo falla solo en una zona, comprueba qué vista tiene el foco. Las acciones de Terminal, Search, Markdown y Diff tienen sus propios contextos.

¿Por qué mi tema no se recarga en caliente?

Usa "One Dark" o "PaneFlow Light" en la clave theme del primer nivel. Consulta los ajustes y ejemplos de temas.

Comprueba la ruta de configuración, incluida la variable PANEFLOW_HOME.
Comprueba la sintaxis JSON y el nombre del tema, y guarda el archivo.
Espera un momento. Si el cambio no se aplica, reinicia Paneflow.
Si reiniciar aplica el cambio pero guardar no, informa del problema e indica si el archivo está en una unidad de red o un sistema de archivos montado.

Instalación y firma

¿Por qué paneflow no está en mi PATH?

La solución depende de cómo instalaste la aplicación:

Linux: .deb y .rpm instalan el comando en una carpeta del sistema. AppImage y .tar.gz pueden necesitar ~/.local/bin en PATH. Sigue las instrucciones de Linux para el comando y PATH.
macOS: Instalar PaneFlow.app con Homebrew o un DMG no añade automáticamente el ejecutable al PATH del shell. Sigue las instrucciones de acceso desde el terminal en macOS.
Windows: Después del MSI, cierra los terminales y abre PowerShell desde el menú Inicio. Si sigue faltando el comando, sigue los pasos para encontrar el comando en Windows.

¿Por qué macOS dice que Apple no puede verificar esta aplicación?

El DMG oficial está firmado y notarizado. Descarga una copia nueva de la última versión de Paneflow y comprueba el texto de la alerta. Sigue los pasos de Gatekeeper en macOS, que distinguen la confirmación del primer inicio de una aplicación bloqueada. Si la alerta indica que la aplicación está dañada o dañará el ordenador, mantenla bloqueada e informa del mensaje exacto.

¿Por qué Windows SmartScreen bloquea el MSI?

Un instalador firmado puede mostrar una advertencia de reputación SmartScreen. Sigue los pasos de verificación de firma en Windows antes de continuar. Comprueba que la firma es Valid y el editor es Strivex. Si alguna comprobación falla, descarga otra vez el MSI de la versión oficial. Si una política de tu organización bloquea la instalación, contacta con su administrador.

Recopilar diagnósticos

¿Qué debo incluir en un informe de error?

Si la aplicación se abre, selecciona Help > System Info y después Copy. Añade ese bloque, el shell, el error exacto, los pasos para reproducirlo y el resultado esperado. Indica qué comprobaciones de esta página has probado.

Si la aplicación no se abre, indica manualmente la versión de Paneflow, la del sistema operativo, la arquitectura, el formato de instalación y los datos de la GPU y del controlador. En Windows, winver muestra la versión y la compilación.

Usa el informe para tu plataforma:

Informar de un error en Linux o macOSVersión, servidor de pantalla, GPU, pasos para reproducirlo y salida de la aplicación.Informar de un error en WindowsCompilación de Windows, controlador GPU, shell, pasos para reproducirlo y salida de la aplicación.

Para recopilar la salida de la aplicación, cierra primero Paneflow y ejecútalo en un terminal con el registro activado. En Linux o macOS:

bash

RUST_LOG=info paneflow

En Windows, con la carpeta predeterminada del MSI:

powershell

$env:RUST_LOG = "info"
$env:RUST_BACKTRACE = "1"
& "$env:ProgramFiles\PaneFlow\paneflow.exe"

Si falta el comando o el ejecutable, sigue la sección PATH o usa la ruta completa. Para una instalación DMG en macOS, sustituye paneflow por /Applications/PaneFlow.app/Contents/MacOS/paneflow.

Reproduce el problema y copia la salida relevante del terminal en el informe. Elimina tokens, rutas privadas o contenido del proyecto antes de publicarlo.

El puente MCP de solo lectura lee la salida de los paneles. Usa los comandos anteriores para recopilar los registros de la aplicación ante problemas de inicio, configuración o renderizado.