Sideband
Sideband 1.2.0
サイドバンドは、Android、Linux、MacOS、Windows用の拡張可能なLXMFメッセージングクライアント、状況認識トラッカー、リモートコントロールおよび監視システムです。 LORA、Packet Radio、WiFi、I2P、暗号化されたQRペーパーメッセージ、またはその他の網状体サポートを使用して、他の人やLXMF互換システムと通信することができます。
サイドバンドは、完全に無料で、エンドツーエンドの暗号化された、許可なし、匿名、インフラストラクチャレスです。サイドバンドは、ピアツーピアと分散のメッセージングシステムLXMFを使用します。サインアップ、サービスプロバイダー、「エンドユーザーライセンス契約」、データの盗難、監視はありません。あなたはシステムを所有しています。
これはまた、サイドバンドが慣れているものとは異なる動作をすることを意味します。機能するためにインターネット上のサーバーへの接続は必要ありません。また、どこにもアカウントがありません。サイドバンドが他のメッセージングシステムとどのように異なるかを理解するために、プログラムに含まれるガイドセクションをお読みください。
サイドバンドは、次のような多くの有用で興味深い機能を提供します。
ping 、 signal Report、 echo 、および完全なプラグインの拡張性などの組み込みコマンドを備えたリモートコマンドの実行と応答エンジン。サイドバンドは、MeshChatやNomad Networkなどの他のLXMFクライアントと完全に互換性があります。また、NOMADネットワーククライアントを使用すると、LXMFネットワークなどの伝播ノードを簡単にホストすることもできます。
サイドバンドはほとんどのコンピューティングデバイスで実行できますが、インストール方法はデバイスの種類とオペレーティングシステムによって異なります。インストール手順については、以下の関連セクションをご覧ください。
Androidデバイスの場合、Borders Repoを追加することにより、F-Droidからサイドバンドをインストールするか、最新リリースページにAPKをダウンロードできます。どちらのソースも同じリリースキーで署名されており、交換可能に使用できます。
Androidデバイスにアプリケーションがインストールされた後、アプリケーションのリポジトリセクションを介して更新を直接プルすることもできます。
すべてのLinuxベースのオペレーティングシステムでは、サイドバンドがpipx / pipパッケージとして利用できます。このインストール方法にはデスクトップ統合が含まれているため、そのサイドバンドはアプリケーションメニューとランチャーに表示されます。以下は、最も一般的な最近のLinuxディストリビューションのインストール手順です。 Debian 11については、このセクションの最後を参照してください。
ご注意ください！最新のPythonリリースであるPython 3.13は現在、Kivy Frameworkと互換性がありません。そのサイドバンドは、ユーザーインターフェイスをレンダリングするために使用しています。 Linux Distributionが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.main64ビットオペレーティングシステムをサポートするすべてのRaspberry PIモデルにサイドバンドをインストールでき、少なくともPythonバージョン3.11を実行できます。一部のサイドバンドの依存関係には、64ビットアームプロセッサ用の事前に構築されたパッケージがまだできていないため、インストール中にこれらを構築できるいくつかの追加パッケージをインストールする必要があります。
ADITIONTITIONALY、 pycodec2パッケージは手動でインストールする必要があります。事前に構築されたバージョンを提供しました。これを単一のコマンドでダウンロードしてインストールできます。または、事前に構築されたバージョンを信頼したくない場合は、SourceからBuild andoursからインストールできます。
以下のインストール手順では、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
sidebandMacOSにサイドバンドをインストールするには、2つのオプションがあります。
最新リリースページからMacOS（ARMおよびIntel）用のサイドバンドを備えたディスクイメージをダウンロードできます。ダウンロードしたディスクイメージをマウントし、 Sidebandアプリケーションフォルダーにドラッグして実行します。
ご注意ください！ MacOSインストールでアプリケーションインストール制限が有効になっている場合、またはApple App Storeからのアプリケーションのインストールのみを許可するようシステムが制限されている場合は、サイドバンドの例外を作成する必要があります。サイドバンドアプリケーションは、Appleが制御するデジタル署名で配布されることはありません。これにより、Appleがそうすることを決定した場合、または当局やその他の状況によって強制された場合、Appleはシステム上でのサイドバンドの実行を単純に無効にすることができるためです。
DMGファイルからサイドバンドをインストールする場合は、 pipまたはpipxパッケージマネージャーを介してrnsパッケージをインストールすることをお勧めします。そのため、 rnstatusなどのRNSユーティリティプログラムを使用して、ターミナルからのインターフェイスと接続ステータスを確認できます。システムに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にサイドバンドをインストールするには、2つのオプションがあります。
パッケージ化されたWindows zipファイルを最新リリースページからダウンロードし、ファイルを解凍し、未解除ディレクトリからSideband.exeを実行するだけです。必要に応じて、この実行可能ファイルからデスクトップまたはスタートメニューショートカットを作成できます。
サイドバンドを初めて実行するとき、まだ持っていない場合は、デフォルトのreticulum構成ファイルが作成されます。既存のreticulum接続がローカルで利用できる場合は、 C:UsersUSERNAME.reticulumconfigにあるファイルを編集し、より広いネットワークへの接続を提供するインターフェイスを手動で追加することをお勧めします。インターネットを介して接続したい場合は、Reticulum TestNetにパブリックハブの1つを追加できます。
ZIPファイルにはサイドバンドを実行するのに必要なすべてが含まれていますが、 rnstatusやrnsdなどのコマンドをコマンドラインから使用できるように、Reticulumコマンドラインユーティリティを個別にインストールすることもお勧めします。これにより、システムの網状体接続を容易にします。システムにPythonがまだインストールされていない場合は、最初にダウンロードしてインストールしてください。
重要！インストーラーから尋ねられたら、 PATH環境変数にPythonプログラムを追加してください。これを行わない場合は、 pipインストーラーを使用したり、インストールされているコマンドを実行したりすることはできません。 Pythonがインストールされたら、コマンドプロンプトを開き、 pip経由でReticulumパッケージをインストールできます。
pip install rnsヘッドレスデーモンモードでサイドバンドを実行する機能を含む、より高度なセットアップのために、デバッグロギング出力、構成のインポートとエクスポートなどを有効にするには、代わりにpip経由でソースパッケージからインストールすることをお勧めします。
この場合、最新のPythonリリースであるため、Python 3.13は現在、Kivyフレームワークと互換性がないため、Pythonの最新バージョン（現在はPython 3.12.7）をダウンロードしてインストールする必要があります。バイナリパッケージにはすでに互換性のあるPythonバージョンが含まれているため、サイドバンドを実行している場合は、特定のバージョンのPythonをインストールする必要はありません。
Pythonがインストールされたら、コマンドプロンプトを開き、 pipを介してサイドバンドをインストールできます。
pip install sbappサイドバンドアプリケーションは、コマンドプロンプトでコマンドsideband実行することで起動できるようになりました。必要に応じて、デスクトップまたは[スタート]メニューでサイドバンドのショートカットを作成できます。
このインストール方法はrnsおよびlxmfパッケージも自動的にインストールするため、システムにrnstatus 、 rnsd 、 lxmdなどのすべてのRNSおよびLXMFユーティリティを使用することもできます。
次のQRコードを使用して、ペーパーメッセージング機能を試すことができます。これは、LXMFアドレス6b3362bd2c1dbf87b66a85f79a8d8c75に送信された紙のメッセージです。メッセージを復号化して読み取るには、次のBase32でエンコードされた網状体IDをアプリにインポートする必要があります。
3BPTDTQCRZPKJT3TXAJCMQFMOYWIM3OCLKPWMG4HCF2T4CH3YZHVNHNRDU6QAZWV2KBHMWBNT2C62TQEVC5GLFM4MN25VLZFSK3ADRQ=
プログラムの暗号化キーの一部で、アイデンティティをサイドバンドにインポートできます。アイデンティティをインポートした後、次のQRコードをスキャンしてアプリで開くことができます。そこでは、復号化されてメッセージに追加されます。
このリンクにメッセージ全体を見つけることもできます。
lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5j_kU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDA_xx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I
カスタムURIハンドラーの登録を可能にするオペレーティングシステムでは、リンクをクリックすると、LXMFクライアントで直接デコードされます。これは、AndroidのSideBandで動作します。
次のチャネルのいずれかを介して寄付することにより、オープン、フリー、プライベートのコミュニケーションシステムの継続的な開発をサポートできます。
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
特に明記されていない限り、この作業は、クリエイティブコモンズの帰属ノンコマーシャルシャレアリーク4.0国際ライセンスの下でライセンスされています。
これにより、サイドバンドをバイナリ形式で、あらゆる目的で使用し、プログラムのバイナリコピーを自由に配布する許可が与えられます。
デバイスフレームで生成されたデバイススクリーンショット。ありがとう！
