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國際許可證獲得許可。
特此允許以任何目的使用二進制形式的邊帶，並自由分發該計劃的二進制副本，只要不收取或收到用於分配或使用的付款或補償即可。
設備框架生成的設備屏幕截圖。謝謝！
