Sideband
Sideband 1.2.0
Боковая полоса - это расширяемый клиент обмена сообщениями LXMF, системная осведомленность и система дистанционного управления и мониторинга для Android, Linux, MacOS и Windows. Это позволяет вам общаться с другими людьми или LXMF-совместимыми системами через сети ретикулум с использованием LORA, Packet Radio, Wi-Fi, I2P, зашифрованных бумажных сообщений QR или чего-либо еще.
Боковая полоса полностью свободна, сквозная зашифрованная, без разрешения, анонимная и инфраструктура без. Боковая полоса использует одноранговую и распределенную систему обмена сообщениями LXMF. Нет регистрации, нет поставщиков услуг, нет «лицензионных соглашений конечных пользователей», нет кражи данных и никакого наблюдения. Вы владеете системой.
Это также означает, что боковая полоса работает иначе, чем то, к чему вы можете привыкнуть. Для работы в Интернете не нужно подключение к серверу в Интернете, и у вас нигде нет учетной записи. Пожалуйста, прочитайте раздел руководства, включенный в программу, чтобы понять, как боковая полоса отличается от других систем обмена сообщениями.
Боковая полоса предоставляет много полезных и интересных функций, таких как:
ping , отчеты signal и echo , и полная расширяемость плагинов .Боковая полоса полностью совместима с другими клиентами LXMF, такими как Meshchat и Nomad Network. Клиент Nomad Network также позволяет легко размещать узлы распространения для вашей сети LXMF и многое другое.
Боковая полоса может работать на большинстве вычислительных устройств, но методы установки варьируются в зависимости от типа устройства и операционной системы. Для инструкций по установке, пожалуйста, найдите соответствующий раздел ниже.
Для ваших устройств Android вы можете установить боковую полосу через F-Droid, добавив Repo между границами, или вы можете загрузить APK на последней странице выпуска. Оба источника подписаны с одинаковыми клавишами выпуска и могут использоваться взаимозаменяемыми.
После того, как приложение будет установлено на вашем устройстве Android, также возможно протянуть обновления непосредственно через раздел репозитория приложения.
Во всех операционных системах на основе Linux боковая полоса доступна в виде пакета pipx / pip . Этот метод установки включает в себя интеграцию настольных компьютеров , так что боковая полоса будет отображаться в вашем меню приложений и пусковых установок. Ниже приведены шаги установки для наиболее распространенных недавних дистрибутов Linux. Для Debian 11 см. Конец этого раздела.
Пожалуйста, обрати внимание! Самый последний релиз Python, Python 3.13 в настоящее время не совместим с Framework Kivy, которую боковая полоса использует для отображения своего пользовательского интерфейса. Если в вашем распределении 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Вы можете установить боковую полосу на все модели Raspberry Pi, которые поддерживают 64-битные операционные системы, и могут запускать хотя бы Python версию 3.11. Поскольку некоторые зависимости боковой полосы пока не имеют предварительно созданных пакетов, готовых к 64-битным процессорам Arm, вам нужно установить несколько дополнительных пакетов, которые позволят построить их при установке.
Адиторно, пакет pycodec2 должен быть установлен вручную. Я предоставил предварительно построенную версию, которую вы можете загрузить и установить с помощью одной команды, или если вы не хотите доверять моей предварительно построенной версии, вы можете создать и установить ее из Source.
Приведенные ниже инструкции по установке предполагают, что вы устанавливаете боковую полосу на 64-битной ОС Raspberry Pi (на основе 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, все еще рекомендуется установить пакет rns через диспетчер пакетов pip или pipx , чтобы вы могли использовать утилитные программы 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 в настоящее время не совместим с Framework Kivy, которую боковая полоса использует для отображения своего пользовательского интерфейса. Если ваша версия 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, у вас есть два варианта:
Просто загрузите упакованный zip -файл Windows с последней страницы выпуска, разкачивайте файл и запустите Sideband.exe из повседневного каталога. Вы можете создать ярлыки на рабочем столе или начать из этого исполняемого файла, если это необходимо.
При первом запуске боковой полосы будут созданы файл конфигурации ретикулума по умолчанию, если у вас его еще нет. Если у вас нет никакого существующего подключения к ретикулуме, доступных локально, вы можете редактировать файл, расположенный по адресу C:UsersUSERNAME.reticulumconfig и вручную добавить интерфейс, который обеспечивает подключение к более широкой сети. Если вы просто хотите подключиться к Интернету, вы можете добавить один из общественных центров в Testnet Reticulum.
Хотя ZIP -файл содержит все необходимое для запуска боковой полосы, также рекомендуется установить утилиты командной строки Reticulum отдельно, чтобы вы могли использовать такие команды, как rnstatus и rnsd из командной строки. Это облегчит управление подключением к ретикулуме в вашей системе. Если в вашей системе еще нет Python, загрузите и установите его первым.
Важный! Когда его спросили у установщика, обязательно добавьте программу Python в переменные среды вашего PATH . Если вы этого не сделаете, вы не сможете использовать установщик pip или запустить какую -либо из установленных команд. Когда Python установлен, вы можете открыть командную строку и установить пакет ретикулум через pip :
pip install rns Для более продвинутых настроек, включая возможность запуска боковой полосы в режиме демона без головы, включить вывод журнала отладки, импорт и экспорт конфигурации и многое другое, вы можете вместо этого установить его из исходного пакета через pip .
В этом случае вам нужно будет загрузить и установить последнюю поддерживаемую версию Python (в настоящее время Python 3.12.7), поскольку самый последний релиз Python, Python 3.13 в настоящее время не совместим с Framework Kivy, который боковая полоса использует для отображения своего пользовательского интерфейса. Бинарный пакет уже включает в себя совместимую версию Python, поэтому, если вы используете боковую полосу от этого, нет необходимости устанавливать определенную версию Python.
Когда Python установлен, вы можете открыть командную строку и установить боковую полосу через pip :
pip install sbapp Приложение боковой полосы теперь может быть запущено путем запуска командной sideband в командной строке. При необходимости вы можете создать ярлык для боковой полосы на рабочем столе или в меню «Пуск».
Поскольку этот метод установки автоматически устанавливает пакеты rns и lxmf , вы также будете иметь доступ к использованию всех включенных утилит RNS и LXMF, таких как rnstatus , rnsd и lxmd в вашей системе.
Вы можете попробовать функциональность обмена бумажными сообщениями, используя следующий QR-код. Это бумажное сообщение, отправленное по адресу LXMF 6b3362bd2c1dbf87b66a85f79a8d8c75 . Чтобы иметь возможность расшифровать и прочитать сообщение, вам нужно будет импортировать следующую идентификацию ретикулума Base32 в приложении:
3BPTDTQCRZPKJT3TXAJCMQFMOYWIM3OCLKPWMG4HCF2T4CH3YZHVNHNRDU6QAZWV2KBHMWBNT2C62TQEVC5GLFM4MN25VLZFSK3ADRQ=
Вы можете импортировать личность в боковую полосу в ключах шифрования в части программы. После того, как вы импортировали личность, вы можете сканировать следующий QR-код и открыть его в приложении, где он будет расшифрован и добавлен в ваши сообщения.
Вы также можете найти все сообщение в этой ссылке:
lxm://azNivSwdv4e2aoX3mo2MdTAozuI7BlzrLlHULmnVgpz3dNT9CMPVwgywzCJP8FVogj5j_kU7j7ywuvBNcr45kRTrd19c3iHenmnSDe4VEd6FuGsAiT0Khzl7T81YZHPTDhRNp0FdhDE9AJ7uphw7zKMyqhHHxOxqrYeBeKF66gpPxDceqjsOApvsSwggjcuHBx9OxOBy05XmnJxA1unCKgvNfOFYc1T47luxoY3c0dLOJnJPwZuFRytx2TXlQNZzOJ28yTEygIfkDqEO9mZi5lgev7XZJ0DvgioQxMIyoCm7lBUzfq66zW3SQj6vHHph7bhr36dLOCFgk4fZA6yia2MlTT9KV66Tn2l8mPNDlvuSAJhwDA_xx2PN9zKadCjo9sItkAp8r-Ss1CzoUWZUAyT1oDw7ly6RrzGBG-e3eM3CL6u1juIeFiHby7_3cON-6VTUuk4xR5nwKlFTu5vsYMVXe5H3VahiDSS4Q1aqX7I
В операционных системах, которые разрешают регистрацию пользовательских ури, вы можете щелкнуть по ссылке, и она будет декодирована непосредственно в вашем клиенте LXMF. Это работает с боковой полосой на Android.
Вы можете помочь поддержать дальнейшее развитие открытых, бесплатных и частных систем связи, пожертвовав по одному из следующих каналов:
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
Если не указано иное, эта работа лицензирована в соответствии с Creative Commons Attribution-Noncommercial-Sharealik 4.0 Международная лицензия.
Настоящим разрешено использовать боковую полосу в бинарной форме, для любых целей, и свободно распределять бинарные копии программы, при условии, что платеж или компенсация не взимается или получено за такое распределение или использование.
Скриншоты устройства, сгенерированные с помощью DeviceFrames. Спасибо!
