BanchoXtermC++17 / Qt6
ESENPT
GitHubDescargar
← Volver al inicio
GUÍA DE INSTALACIÓN

Instalar BanchoXterm

Instalación en Windows y compilación desde el código fuente en Linux, paso a paso.

Windows: instalador o portable

Abre la página de versiones y descarga el archivo de Windows correspondiente a tu arquitectura. Puedes elegir entre el instalador y la edición portable.

Ver descargas en GitHub ↗

Con instalador

  1. Descarga el instalador .exe desde GitHub Releases.
  2. Ejecuta el instalador y sigue los pasos del asistente.
  3. Abre BanchoXterm desde el menú Inicio.

Edición portable

  1. Descarga el archivo ZIP portable de Windows.
  2. Extrae todo el contenido en una carpeta donde tengas permisos de escritura.
  3. Ejecuta banchoxterm.exe desde esa carpeta. Conserva los archivos y subcarpetas incluidos.

Compilar en Windows con MSVC

  1. Abre x64 Native Tools Command Prompt for VS 2022.
  2. Descarga el código y los submódulos.
    git clone --recurse-submodules https://github.com/Gargadon/banchoxterm.git
cd banchoxterm
  3. Ajusta la ruta de Qt a tu instalación, compila y ejecuta.
    cmake -B build-msvc -G "Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH=C:/Qt/6.8.3/msvc2022_64
cmake --build build-msvc --config Release
build-msvc\Release\banchoxterm.exe

Linux: compilar desde el código fuente

El proyecto todavía no publica paquetes Linux. Necesitas Git, CMake 3.16 o posterior, un compilador C++17, Qt 6.6 o posterior y las dependencias de FreeRDP 3 y WinPR 3.

1. Instala las dependencias

Ubuntu / Debian

sudo apt update
sudo apt install git build-essential cmake ninja-build \
  qt6-base-dev qt6-serialport-dev qt6-tools-dev qt6-tools-dev-tools \
  libssl-dev zlib1g-dev libsecret-tools lrzsz pkg-config \
  freerdp3-dev libwinpr3-dev

Fedora

sudo dnf install git gcc-c++ cmake ninja-build \
  qt6-qtbase-devel qt6-qtserialport-devel qt6-qttools-devel \
  openssl-devel zlib-devel libsecret lrzsz pkgconf-pkg-config \
  freerdp-devel winpr-devel

2. Descarga el código y los submódulos

El submódulo QTermWidget es necesario. El enlace HTTPS permite clonar sin configurar una llave SSH de GitHub.

git clone --recurse-submodules https://github.com/Gargadon/banchoxterm.git
cd banchoxterm

3. Compila y ejecuta

CMake descarga las bibliotecas incluidas mediante FetchContent, por lo que la primera compilación necesita conexión a Internet. Ejecuta estos comandos dentro de la carpeta banchoxterm.

cmake -B build -G Ninja
cmake --build build
./build/banchoxterm

Guardar contraseñas en Linux

Necesitas secret-tool y un proveedor Secret Service activo en tu sesión de escritorio. Usa el gestor de tu escritorio; si no tienes uno, puedes instalar GNOME Keyring o un KWallet compatible. No es necesario instalar ambos.

macOS: funciones sin probar

Ninguna de las características de BanchoXterm ha sido probada en macOS. Si decides compilarlo o usarlo en este sistema, revisa su funcionamiento bajo tu propia responsabilidad.

Primera conexión

  1. Crea una sesión SSH e indica el host, puerto y usuario del servidor.
  2. Selecciona tu llave privada o introduce la contraseña. Puedes guardarla en el gestor de credenciales.
  3. Comprueba la huella del servidor antes de confiar en él y conecta.

Opcional: X11 y consola serie

Para X11 en Windows puedes usar VcXsrv, Xming o X410. Para enviar archivos por ZMODEM en sesiones serie, instala lrzsz en Linux.