Sideband
Sideband 1.2.0
侧带是一个可扩展的LXMF消息传递客户端，情境意识跟踪器以及Android，Linux，MacOS和Windows的遥控和监视系统。它使您可以使用LORA，数据包无线电，WiFi，I2P，加密的QR纸质消息或其他任何网状支持，与其他人或LXMF兼容系统进行通信。
侧带是完全免费的，端到端的加密，无许可，匿名和基础架构。侧带使用点对点和分布式消息系统LXMF。没有注册，没有服务提供商，没有“最终用户许可协议”，没有数据盗窃，也没有监视。您拥有系统。
这也意味着边带的运行方式与您的使用方式不同。它不需要与Internet上的服务器的连接来运行，并且您在任何地方都没有帐户。请阅读程序中包含的指南部分，以了解侧带与其他消息系统的不同。
侧带提供了许多有用且有趣的功能，例如：
ping ， signal Reports和echo以及完整的插件可扩展性。侧带与其他LXMF客户端完全兼容，例如Meshchat和Nomad Network。 Nomad网络客户端还允许您轻松地托管LXMF网络的传播节点，等等。
侧带可以在大多数计算设备上运行，但是安装方法因设备类型和操作系统而异。有关安装说明，请找到下面的相关部分。
对于您的Android设备，您可以通过添加边框存储库中的F-Droid安装边界，也可以在最新版本页面上下载APK。两个源都使用相同的释放键签名，并且可以互换使用。
在您的Android设备上安装应用程序后，也可以直接通过应用程序的存储库部分拉更新。
在所有基于Linux的操作系统上，边带可作为pipx / pip软件包使用。此安装方法包括桌面集成，因此该边带将显示在您的应用程序菜单和启动器中。以下是最常见的Linux发行版的安装步骤。对于Debian 11，请参见本节的末尾。
请注意！最新的Python版本Python 3.13当前与Kivy Framework不兼容，该侧带用于渲染其用户界面。如果您的Linux发行版将Python 3.13用作其默认的Python安装，则您也需要安装较早的版本。建议使用最新版本的Python 3.12。
您首先需要安装一些依赖项，以进行音频消息传递和CODEC2支持以工作：
# 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
安装了这些内容后，请安装边带应用程序本身：
# 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.12安装后，您现在可以以多种不同的方式运行边带：
# 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 -v您还可以以各种替代方式安装边带：
# 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.main您可以在支持64位操作系统的所有Raspberry Pi型号上安装边带，并且至少可以运行Python版本3.11。由于一些边带的依赖项还没有准备好64位ARM处理器的预制软件包，因此您需要安装一些额外的软件包，这将允许在安装时构建这些软件包。
在广泛的情况下，需要手动安装pycodec2软件包。我提供了一个预构建的版本，可以使用一个命令下载和安装，或者如果您不想相信我的预构建版本，则可以自己构建和安装它。
下面的安装说明假定您正在将边带安装在64位Raspberry Pi OS（基于Debian Bookworm）上。如果您在PI上运行其他内容，则可能需要稍微修改一些命令。要在Raspberry Pi上安装侧带，请按照以下步骤：
# 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
sideband要在MacOS上安装边带，您有两个可用的选项：
您可以从最新版本的页面中下载带有MacOS（ARM和Intel）的侧带的磁盘映像。只需将下载的磁盘映像安装，将Sideband拖放到您的应用程序文件夹，然后运行即可。
请注意！如果您在MACOS安装上启用了应用程序安装限制，或者限制了系统以允许从Apple App Store安装应用程序，则需要为边带创建一个例外。侧带应用程序将永远不会使用Apple控制的数字签名分发，因为如果Apple决定这样做，或者被当局或其他情况强迫，苹果可以简单地禁用侧带在您的系统上运行。
如果您从DMG文件安装边带，仍然建议通过pip或pipx软件包管理器安装rns软件包，因此您可以使用RNS实用程序程序，例如rnstatus来查看终端的接口和连接状态。如果您已经在系统上安装了Python并已安装了pip ，只需打开终端窗口并使用以下命令之一：
# 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如果您没有Python和pip可用，请首先下载并安装。
对于更高级的设置，包括在无头守护程序模式下运行边界的功能，启用调试日志记录输出，配置导入和导出等，您可能需要通过pip从源包中安装它。
请注意！最新的Python版本Python 3.13当前与Kivy Framework不兼容，该侧带用于渲染其用户界面。如果您的MacOS版本使用Python 3.13作为默认的Python安装，则您也需要安装较早的版本。建议使用最新版本的Python 3.12。
要通过pip安装侧带，请按照以下说明：
# 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.
要在Windows上安装边带，您可以使用两个选项：
只需从最新发布页面下载包装的Windows zip文件，解压缩文件，然后从未拉链目录中运行Sideband.exe 。您可以根据需要创建此可执行文件的桌面或启动菜单快捷方式。
第一次运行边界时，如果您还没有一个默认的网状配置文件。如果您没有本地可用的任何现有网状连接，则可能需要编辑位于C:UsersUSERNAME.reticulumconfig文件，并手动添加一个为更宽网络提供连接的接口。如果您只想通过Internet连接，则可以在网状测试网上添加一个公共枢纽。
尽管ZIP文件包含运行边界所需的一切，但也建议单独安装网状命令行实用程序，以便您可以使用命令行中的rnstatus和rnsd等命令。这将使管理系统上的网状连接更加容易。如果您在系统上尚未安装Python，请先下载并安装。
重要的！当安装程序询问时，请确保将Python程序添加到PATH环境变量中。如果您不这样做，则将无法使用pip安装程序或运行任何已安装的命令。安装Python后，您可以打开命令提示符，并通过pip安装网状包：
pip install rns对于更高级的设置，包括在无头守护程序模式下运行边界的功能，启用调试日志记录输出，配置导入和导出等，您可能需要通过pip从源包中安装它。
在这种情况下，您将需要下载并安装最新的Python支持版本（当前Python 3.12.7），因为非常最新的Python版本，Python 3.13当前与Kivy Framework不兼容，该侧带用于渲染其用户界面。二进制软件包已经包含兼容的Python版本，因此，如果您从中运行边带，则无需安装特定版本的Python。
安装Python后，您可以打开命令提示符，并通过pip安装侧带：
pip install sbapp现在可以通过在命令提示符中运行命令sideband启动边界应用程序。如果需要，您可以在桌面或开始菜单上的边带创建快捷方式。
由于这种安装方法也会自动安装rns和lxmf软件包，因此您还可以访问系统上使用rnstatus ， rnsd和lxmd等所有随附的RNS和LXMF实用程序。
您可以使用以下QR代码尝试纸质消息传递功能。这是发送到LXMF地址6b3362bd2c1dbf87b66a85f79a8d8c75纸质消息。为了解密和阅读该消息，您需要将以下基本32编码的网状身份导入到应用中：
3BPTDTQCRZPKJT3TXAJCMQFMOYWIM3OCLKPWMG4HCF2T4CH3YZHVNHNRDU6QAZWV2KBHMWBNT2C62TQEVC5GLFM4MN25VLZFSK3ADRQ=
您可以将身份导入程序的加密键部分中的边界。导入身份之后，您可以在应用程序中扫描以下QR代码并将其打开，并将其解密并添加到您的消息中。
您还可以在此链接中找到整个消息：
lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5j_kU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDA_xx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I
在允许注册自定义URI Handler的操作系统上，您可以单击链接，并将直接在LXMF客户端中解码。这与Android上的边带一起使用。
您可以通过以下一个渠道之一捐赠：
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
除非另有说明，否则这项工作将根据创意共享归因于非商业交往4.0国际许可证获得许可。
特此允许以任何目的使用二进制形式的边带，并自由分发该计划的二进制副本，只要不收取或收到用于分配或使用的付款或补偿即可。
设备框架生成的设备屏幕截图。谢谢！
