BanchoXtermC++17 / Qt6
ESENPT
GitHubBaixar
← Voltar ao início
GUIA DE INSTALAÇÃO

Instalar o BanchoXterm

Instalação no Windows e compilação a partir do código-fonte no Linux, passo a passo.

Windows: instalador ou portátil

Abra a página de versões e baixe o arquivo do Windows correspondente à sua arquitetura. Escolha o instalador ou a edição portátil.

Ver downloads no GitHub ↗

Com instalador

  1. Baixe o instalador .exe no GitHub Releases.
  2. Execute o instalador e siga as etapas do assistente.
  3. Abra o BanchoXterm pelo menu Iniciar.

Edição portátil

  1. Baixe o ZIP portátil para Windows.
  2. Extraia todos os arquivos em uma pasta com permissão de escrita.
  3. Execute banchoxterm.exe nessa pasta. Mantenha os arquivos e subpastas incluídos.

Compilar no Windows com MSVC

  1. Abra x64 Native Tools Command Prompt for VS 2022.
  2. Baixe o código e os submódulos.
    git clone --recurse-submodules https://github.com/Gargadon/banchoxterm.git
cd banchoxterm
  3. Ajuste o caminho do Qt à sua instalação, compile e execute.
    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 a partir do código-fonte

O projeto ainda não publica pacotes Linux. Você precisa de Git, CMake 3.16 ou posterior, um compilador C++17, Qt 6.6 ou posterior e das dependências de desenvolvimento FreeRDP 3 e WinPR 3.

1. Instale as dependências

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. Baixe o código e os submódulos

O submódulo QTermWidget é necessário. O endereço HTTPS permite clonar sem configurar uma chave SSH do GitHub.

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

3. Compile e execute

O CMake baixa as bibliotecas incluídas por meio do FetchContent. Execute estes comandos dentro da pasta banchoxterm.

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

Salvar senhas no Linux

Você precisa do secret-tool e de um provedor Secret Service ativo na sessão do desktop. Use o gerenciador do seu desktop; se não tiver um, instale o GNOME Keyring ou um provedor KWallet compatível. Não é necessário instalar ambos.

macOS: funcionalidades não testadas

Nenhuma das funcionalidades do BanchoXterm foi testada no macOS. Se decidir compilar ou usar o programa nesse sistema, avalie seu funcionamento por sua conta e risco.

Primeira conexão

  1. Crie uma sessão SSH e informe o host, a porta e o usuário do servidor.
  2. Selecione sua chave privada ou informe a senha. Você pode salvá-la no gerenciador de credenciais.
  3. Confira a impressão digital do servidor antes de confiar nele e conecte.

Opcional: X11 e console serial

Para X11 no Windows, você pode usar VcXsrv, Xming ou X410. Para enviar arquivos por ZMODEM em sessões seriais, instale o lrzsz no Linux.