Sideband
Sideband 1.2.0
A banda lateral é um cliente de mensagens LXMF extensível, rastreador de conscientização situacional e sistema de controle e monitoramento remoto para Android, Linux, MacOS e Windows. Ele permite que você se comunique com outras pessoas ou sistemas compatíveis com LXMF em redes de retículo usando LORA, Rádio de Pacotes, Wi-Fi, I2P, mensagens de papel QR criptografadas ou qualquer outra coisa do Retículo.
A banda lateral é totalmente gratuita e de ponta a ponta, sem permissão, anônima e sem infraestrutura. A banda lateral usa o sistema de mensagens ponto a ponto e distribuído LXMF. Não há inscrição, nenhum provedor de serviços, nenhum "contrato de licença do usuário final", nenhum roubo de dados e nenhuma vigilância. Você possui o sistema.
Isso também significa que a banda lateral opera de maneira diferente do que você pode estar acostumado. Ele não precisa de uma conexão com um servidor na Internet para funcionar e você não possui uma conta em nenhum lugar. Leia a seção Guia incluída no programa, para entender como a banda lateral difere de outros sistemas de mensagens.
A banda lateral fornece muitas funções úteis e interessantes, como:
ping , relatórios signal e echo e expansão completa do plug-in .A banda lateral é totalmente compatível com outros clientes LXMF, como MeshChat e Nomad Network. O Nomad Network Client também permite que você hospede facilmente nós de propagação para sua rede LXMF e muito mais.
A banda lateral pode ser executada na maioria dos dispositivos de computação, mas os métodos de instalação variam de acordo com o tipo de dispositivo e o sistema operacional. Para instruções de instalação, encontre a seção relevante abaixo.
Para seus dispositivos Android, você pode instalar a banda lateral através do F-DROID, adicionando o repositório entre as fronteiras ou pode baixar um APK na página de lançamento mais recente. Ambas as fontes são assinadas com as mesmas teclas de liberação e podem ser usadas de forma intercambiável.
Após a instalação do aplicativo no seu dispositivo Android, também é possível extrair atualizações diretamente através da seção repositório do aplicativo.
Em todos os sistemas operacionais baseados em Linux, a banda lateral está disponível como um pacote pipx / pip . Este método de instalação inclui integração de desktop , para que a banda lateral apareça no menu e nos lançadores de aplicativos. Abaixo estão as etapas de instalação para as distritos Linux recentes mais comuns. Para o Debian 11, consulte o final desta seção.
Observe! A versão mais recente do Python, Python 3.13, atualmente não é compatível com a estrutura Kivy, que a banda lateral usa para renderizar sua interface de usuário. Se a sua distribuição Linux usar o Python 3.13 como sua instalação padrão do Python, você também precisará instalar uma versão anterior. Usando o lançamento mais recente do Python 3.12 é recomendado.
Primeiro, você precisará instalar algumas dependências para mensagens de áudio e suporte ao Codec2 para funcionar:
# For Debian (12+), Ubuntu (22.04+) and derivatives
sudo apt install pipx python3-pyaudio python3-dev build-essential libopusfile0 portaudio19-dev codec2 xclip xsel
# For Manjaro and derivatives
pamac install python-pipx python-pyaudio base-devel codec2 xclip xsel
# For Arch and derivatives
sudo pacman -Sy python-pipx python-pyaudio base-devel codec2 xclip xsel
Depois que estes forem instalados, instale o próprio aplicativo de banda lateral:
# Finally, install Sideband using pipx:
pipx install sbapp
# If you need to specify a specific Python version,
# use something like the following:
pipx install sbapp --python python3.12Após a instalação, agora você pode executar a banda lateral de várias maneiras diferentes:
# If this is the first time installing something with pipx,
# you may need to use the following command, to make your
# installed applications available. You'll probably need
# to close and reopen your terminal after this.
pipx ensurepath
# The first time you run Sideband, you will need to do it
# from the terminal:
sideband
# At the first launch, it will add an application icon
# to your launcher or apps menu. You may need to log out
# of your session, and back in for the application to
# show up in your launcher, depending on your distro.
# You can also run Sideband in headless daemon
# mode, for example as a telemetry collector:
sideband --daemon
# You can also run Sideband with more verbose
# log output enabled:
sideband -vVocê também pode instalar a banda lateral de várias maneiras alternativas:
# Install Sideband via pip instead of pipx:
pip install sbapp
# Or, if pip is externally managed:
pip install sbapp --break-system-packages
# Or, if you intend to run Sideband in headless
# daemon mode, you can also install it without
# any of the normal UI dependencies:
pip install sbapp --no-dependencies
# In the case of using --no-dependencies, you
# will still need to manually install the RNS
# and LXMF dependencies:
pip install rns lxmf
# Install Sideband on Debian 11 and derivatives:
sudo apt install python3-pip python3-pyaudio python3-dev build-essential libopusfile0 portaudio19-dev codec2 xclip xsel
pip install sbapp
# On Debian 11, run Sideband manually via the
# terminal once to install desktop integration:
python3 -m sbapp.mainVocê pode instalar banda lateral em todos os modelos Raspberry Pi que suportam sistemas operacionais de 64 bits e podem executar pelo menos o Python versão 3.11. Como algumas das dependências da banda lateral ainda não possuem pacotes pré-criados prontos para processadores de ARM de 64 bits, você precisará instalar alguns pacotes extras, que permitirão construí-los durante a instalação.
Adicionalmente, o pacote pycodec2 precisa ser instalado manualmente. Eu forneci uma versão pré-criada, que você pode baixar e instalar com um único comando, ou se não deseja confiar na minha versão pré-criada, pode construí-lo e instalá-lo a partir de origem você mesmo.
As instruções de instalação abaixo assumem que você está instalando banda lateral no Raspberry Pi OS de 64 bits (baseado no Livrowworm). Se você estiver executando outra coisa no seu PI, talvez seja necessário modificar alguns comandos um pouco. Para instalar a banda lateral no Raspberry Pi, siga estas etapas:
# First of all, install the required dependencies:
sudo apt install python3-pip python3-pyaudio python3-dev python3-cryptography build-essential libopusfile0 libsdl2-dev libavcodec-dev libavdevice-dev libavfilter-dev portaudio19-dev codec2 libcodec2-1.0 xclip xsel
# If you don't want to compile pycodec2 yourself,
# download the pre-compiled package provided here
wget https://raw.githubusercontent.com/markqvist/Sideband/main/docs/utilities/pycodec2-3.0.1-cp311-cp311-linux_aarch64.whl
# Install it:
pip install ./pycodec2-3.0.1-cp311-cp311-linux_aarch64.whl --break-system-packages
# You can now install Sideband
pip install sbapp --break-system-packages
# Restart your Raspberry Pi
sudo reboot
# Everything is ready! You can now run Sideband
# from the terminal, or from the application menu
sidebandPara instalar a banda lateral no macOS, você tem duas opções disponíveis:
Você pode baixar uma imagem de disco com banda lateral para macOS (ARM e Intel) na página de lançamento mais recente. Basta montar a imagem do disco baixada, arrastar Sideband para a pasta de aplicativos e executá -la.
Observe! Se você tiver o aplicativo Instalar restrições ativadas na instalação do MacOS ou restringir o seu sistema a permitir apenas a instalação do aplicativo na Apple App Store, você precisará criar uma exceção para a banda lateral. O aplicativo de banda lateral nunca será distribuído com uma assinatura digital controlada pela Apple, pois isso permitirá que a Apple simplesmente desative a banda lateral de execução no seu sistema se eles decidirem fazê-lo ou forem forçados por autoridades ou outras circunstâncias.
Se você instalar banda lateral no arquivo DMG, ainda será recomendável instalar o pacote rns através do gerenciador de pacotes pip ou pipx , para que você possa usar os programas de utilitário RNS, como rnstatus para ver o status de interface e conectividade do terminal. Se você já possui Python e pip instalados em seu sistema, basta abrir uma janela de terminal e usar um dos seguintes comandos:
# Install Reticulum and utilities with pip:
pip3 install rns
# On some versions, you may need to use the
# flag --break-system-packages to install:
pip3 install rns --break-system-packages Se você não possui Python e pip disponíveis, faça o download e instale -o primeiro.
Para configurações mais avançadas, incluindo a capacidade de executar a banda lateral no modo Daemon sem cabeça, ativar a saída de log de depuração, importação de configuração e exportação e muito mais, você pode instalá -lo no pacote de origem via pip .
Observe! A versão mais recente do Python, Python 3.13, atualmente não é compatível com a estrutura Kivy, que a banda lateral usa para renderizar sua interface de usuário. Se a sua versão do MacOS usar o Python 3.13 como sua instalação Python padrão, você também precisará instalar uma versão anterior. Usando o lançamento mais recente do Python 3.12 é recomendado.
Para instalar a banda lateral via pip , siga estas instruções:
# Install Sideband and dependencies on macOS using pip:
pip3 install sbapp
# Run Sideband from the terminal:
# ################################
sideband
# or
python3 -m sbapp.main
# Enable debug logging:
# ################################
sideband -v
# or
python3 -m sbapp.main -v
# Start Sideband in daemon mode:
# ################################
sideband -d
# or
python3 -m sbapp.main -d
# If Python and pip was installed correctly,
# you can simply use the "sideband" command
# directly. Otherwise, you will manually
# need to add the pip binaries directory to
# your PATH environment variable, or start
# Sideband via the "python3 -m sbapp.main"
# syntax.
Para instalar a banda lateral no Windows, você tem duas opções disponíveis:
Basta baixar o arquivo zip do Windows embalado na página de lançamento mais recente, descompactar o arquivo e executar Sideband.exe no diretório descompactado. Você pode criar atalhos de menu de mesa ou iniciar a partir deste executável, se necessário.
Ao executar a banda lateral pela primeira vez, um arquivo de configuração do retículo padrão será criado, se você ainda não tiver um. Se você não tiver nenhuma conectividade do retículo existente disponível localmente, convém editar o arquivo, localizado em C:UsersUSERNAME.reticulumconfig e adicione manualmente uma interface que fornece conectividade a uma rede mais ampla. Se você deseja se conectar apenas pela Internet, poderá adicionar um dos hubs públicos no Retículo TestNet.
Embora o arquivo ZIP contenha tudo o que é necessário para executar a banda lateral, também é recomendável instalar os utilitários da linha de comando do Retículo separadamente, para que você possa usar comandos como rnstatus e rnsd da linha de comando. Isso facilitará o gerenciamento da conectividade do retículo no seu sistema. Se você ainda não possui o Python instalado no seu sistema, faça o download e instale -o primeiro.
Importante! Quando solicitado pelo instalador, adicione o programa Python às suas variáveis de ambiente PATH . Se você não fizer isso, não poderá usar o instalador pip ou executar qualquer um dos comandos instalados. Quando o Python estiver instalado, você pode abrir um prompt de comando e instalar o pacote de retículo via pip :
pip install rns Para configurações mais avançadas, incluindo a capacidade de executar a banda lateral no modo Daemon sem cabeça, ativar a saída de log de depuração, importação de configuração e exportação e muito mais, você pode instalá -lo no pacote de origem via pip .
Nesse caso, você precisará fazer o download e instalar a versão mais recente do Python (atualmente Python 3.12.7), uma vez que o lançamento do Python muito mais recente, o Python 3.13 atualmente não é compatível com a estrutura Kivy, que a banda lateral usa para renderizar sua interface do usuário. O pacote binário já inclui uma versão Python compatível; portanto, se você estiver executando a banda lateral, não há necessidade de instalar uma versão específica do Python.
Quando o Python estiver instalado, você pode abrir um prompt de comando e instalar a banda lateral via pip :
pip install sbapp O aplicativo de banda lateral agora pode ser iniciado executando a sideband de comando no prompt de comando. Se necessário, você pode criar um atalho para a banda lateral na sua área de trabalho ou no menu Iniciar.
Como este método de instalação instala automaticamente os pacotes rns e lxmf , você também terá acesso ao uso de todos os utilitários RNS e LXMF incluídos como rnstatus , rnsd e lxmd em seu sistema.
Você pode experimentar a funcionalidade de mensagens em papel usando o seguinte código QR. É uma mensagem em papel enviada ao endereço LXMF 6b3362bd2c1dbf87b66a85f79a8d8c75 . Para poder descriptografar e ler a mensagem, você precisará importar a seguinte identidade do retículo codificada por base32 no aplicativo:
3BPTDTQCRZPKJT3TXAJCMQFMOYWIM3OCLKPWMG4HCF2T4CH3YZHVNHNRDU6QAZWV2KBHMWBNT2C62TQEVC5GLFM4MN25VLZFSK3ADRQ=
Você pode importar a identidade para a banda lateral nas teclas de criptografia parte do programa. Após o que você importou a identidade, pode digitalizar o seguinte código QR e abri-lo no aplicativo, onde ele será descriptografado e adicionado às suas mensagens.
Você também pode encontrar a mensagem inteira neste link:
lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5j_kU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDA_xx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I
Nos sistemas operacionais que permitem registrar os manipuladores de Uri personalizados, você pode clicar no link e ele será decodificado diretamente no seu cliente LXMF. Isso funciona com a banda lateral no Android.
Você pode ajudar a apoiar o desenvolvimento contínuo de sistemas de comunicação aberta, gratuita e privada doando através de um dos seguintes canais:
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
Salvo indicação em contrário, este trabalho é licenciado sob uma Licença Internacional Creative Commons Attribution-NonCommercial-Sharealike 4.0.
A permissão é concedida para usar a banda lateral em forma binária, para todos e quaisquer propósitos, e para distribuir livremente cópias binárias do programa, desde que nenhum pagamento ou compensação seja cobrada ou recebida por essa distribuição ou uso.
Capturas de tela de dispositivos geradas com frames de dispositivos. Obrigado!
