Git-Mirrors/Sideband
1
0
Fork 0
mirror of https://github.com/markqvist/Sideband.git synced 2024-12-27 00:19:25 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity
1fb6c38247
Sideband/sbapp/main.py
Mark Qvist 8731be2293 Cleanup
2023-11-01 16:34:24 +01:00

4392 lines
219 KiB
Python
Raw Blame History

__debug_build__ = False
__disable_shaders__ = False
__version__ = "0.7.0"
__variant__ = "beta"
import sys
import argparse
parser = argparse.ArgumentParser(description="Sideband LXMF Client")
parser.add_argument("-v", "--verbose", action='store_true', default=False, help="increase logging verbosity")
parser.add_argument("-d", "--daemon", action='store_true', default=False, help="run as a daemon, without user interface")
parser.add_argument("--version", action="version", version="sideband {version}".format(version=__version__))
args = parser.parse_args()
sys.argv = [sys.argv[0]]
import RNS
import LXMF
import time
import os
import pathlib
import base64
import threading
import RNS.vendor.umsgpack as msgpack
if not args.daemon:
import plyer
from kivy.logger import Logger, LOG_LEVELS
# Squelch excessive method signature logging
class redirect_log():
def isEnabledFor(self, arg):
return False
def debug(self, arg):
pass
def trace(self, arg):
pass
def warning(self, arg):
RNS.log("Kivy error: "+str(arg), RNS.LOG_WARNING)
def critical(self, arg):
RNS.log("Kivy error: "+str(arg), RNS.LOG_ERROR)
if RNS.vendor.platformutils.get_platform() == "android":
import jnius.reflect
def mod(method, name, signature):
pass
jnius.reflect.log_method = mod
jnius.reflect.log = redirect_log()
if __debug_build__ or args.verbose:
Logger.setLevel(LOG_LEVELS["debug"])
else:
Logger.setLevel(LOG_LEVELS["error"])
if RNS.vendor.platformutils.get_platform() != "android":
local = os.path.dirname(__file__)
sys.path.append(local)
if args.daemon:
from .sideband.core import SidebandCore
class DaemonElement():
pass
class DaemonApp():
pass
MDApp = DaemonApp; OneLineIconListItem = DaemonElement; Window = DaemonElement; Clipboard = DaemonElement;
EventLoop = DaemonElement; Clock = DaemonElement; Builder = DaemonElement; ScrollEffect = DaemonElement; SlideTransition = DaemonElement;
ScreenManager = DaemonElement; FadeTransition = DaemonElement; NoTransition = DaemonElement; OneLineIconListItem = DaemonElement;
StringProperty = DaemonElement; BaseButton = DaemonElement; MDIconButton = DaemonElement; MDFileManager = DaemonElement;
toast = DaemonElement; dp = DaemonElement; sp = DaemonElement; MDRectangleFlatButton = DaemonElement; MDDialog = DaemonElement;
colors = DaemonElement; Telemeter = DaemonElement; CustomMapMarker = DaemonElement; MBTilesMapSource = DaemonElement;
MapSource = DaemonElement; webbrowser = DaemonElement; Conversations = DaemonElement; MsgSync = DaemonElement;
NewConv = DaemonElement; Telemetry = DaemonElement; ObjectDetails = DaemonElement; Announces = DaemonElement;
Messages = DaemonElement; ts_format = DaemonElement; messages_screen_kv = DaemonElement; plyer = DaemonElement;
ContentNavigationDrawer = DaemonElement; DrawerList = DaemonElement; IconListItem = DaemonElement;
else:
from kivymd.app import MDApp
app_superclass = MDApp
from kivy.core.window import Window
from kivy.core.clipboard import Clipboard
from kivy.base import EventLoop
from kivy.clock import Clock
from kivy.lang.builder import Builder
from kivy.effects.scroll import ScrollEffect
from kivy.uix.screenmanager import ScreenManager
from kivy.uix.screenmanager import FadeTransition, NoTransition, SlideTransition
from kivymd.uix.list import OneLineIconListItem
from kivy.properties import StringProperty
from kivymd.uix.button import BaseButton, MDIconButton
from kivymd.uix.filemanager import MDFileManager
from kivymd.toast import toast
from kivy.metrics import dp, sp
from kivymd.uix.button import MDRectangleFlatButton
from kivymd.uix.dialog import MDDialog
from kivymd.color_definitions import colors
from sideband.sense import Telemeter
from mapview import CustomMapMarker
from mapview.mbtsource import MBTilesMapSource
from mapview.source import MapSource
import webbrowser
import kivy.core.image
kivy.core.image.Logger = redirect_log()
if RNS.vendor.platformutils.get_platform() == "android":
from sideband.core import SidebandCore
from ui.layouts import *
from ui.conversations import Conversations, MsgSync, NewConv
from ui.telemetry import Telemetry
from ui.objectdetails import ObjectDetails
from ui.announces import Announces
from ui.messages import Messages, ts_format, messages_screen_kv
from ui.helpers import ContentNavigationDrawer, DrawerList, IconListItem
from jnius import cast
from jnius import autoclass
from android import mActivity
from android.permissions import request_permissions, check_permission
from android.storage import primary_external_storage_path, secondary_external_storage_path
from kivymd.utils.set_bars_colors import set_bars_colors
android_api_version = autoclass('android.os.Build$VERSION').SDK_INT
else:
from .sideband.core import SidebandCore
from .ui.layouts import *
from .ui.conversations import Conversations, MsgSync, NewConv
from .ui.announces import Announces
from .ui.telemetry import Telemetry
from .ui.objectdetails import ObjectDetails
from .ui.messages import Messages, ts_format, messages_screen_kv
from .ui.helpers import ContentNavigationDrawer, DrawerList, IconListItem
from kivy.config import Config
Config.set('input', 'mouse', 'mouse,disable_multitouch')
dark_theme_text_color = "ddd"
if RNS.vendor.platformutils.get_platform() == "android":
from jnius import autoclass
from android.runnable import run_on_ui_thread
TRANSITION_DURATION = 0.25
if RNS.vendor.platformutils.is_android():
ll_ot = 0.55
ll_ft = 0.275
else:
ll_ot = 0.4
ll_ft = 0.275
class SidebandApp(MDApp):
STARTING = 0x00
ACTIVE = 0x01
PAUSED = 0x02
STOPPING = 0x03
PKGNAME = "io.unsigned.sideband"
SERVICE_TIMEOUT = 30
EINK_BG_STR = "1,0,0,1"
EINK_BG_ARR = [1,0,0,1]
def __init__(self, **kwargs):
super().__init__(**kwargs)
self.title = "Sideband"
self.app_state = SidebandApp.STARTING
self.android_service = None
self.app_dir = plyer.storagepath.get_application_dir()
self.shaders_disabled = __disable_shaders__
self.keyboard_enabled = False
self.no_transition = NoTransition()
self.slide_transition = SlideTransition()
if RNS.vendor.platformutils.get_platform() == "android":
self.sideband = SidebandCore(self, is_client=True, android_app_dir=self.app_dir, verbose=__debug_build__)
else:
self.sideband = SidebandCore(self, is_client=False, verbose=(args.verbose or __debug_build__))
self.set_ui_theme()
self.dark_theme_text_color = dark_theme_text_color
self.conversations_view = None
self.messages_view = None
self.map = None
self.map_layer = None
self.map_screen = None
self.telemetry_screen = None
self.map_cache = self.sideband.map_cache
self.offline_source = None
self.map_settings_screen = None
self.object_details_screen = None
self.sync_dialog = None
self.settings_ready = False
self.telemetry_ready = False
self.connectivity_ready = False
self.hardware_ready = False
self.repository_ready = False
self.hardware_rnode_ready = False
self.hardware_modem_ready = False
self.hardware_serial_ready = False
self.final_load_completed = False
self.service_last_available = 0
Window.softinput_mode = "below_target"
self.icon = self.sideband.asset_dir+"/icon.png"
self.notification_icon = self.sideband.asset_dir+"/notification_icon.png"
self.connectivity_updater = None
self.last_map_update = 0
self.last_telemetry_received = 0
self.reposository_url = None
#################################################
# Application Startup #
#################################################
def update_loading_text(self):
if self.sideband:
loadingstate = self.sideband.getstate("init.loadingstate")
if loadingstate:
self.root.ids.connecting_status.text = loadingstate
def update_init_status(self, dt):
self.update_loading_text()
if not RNS.vendor.platformutils.is_android() or self.sideband.service_available():
self.service_last_available = time.time()
self.start_final()
self.loading_updater.cancel()
def start_core(self, dt):
self.loading_updater = Clock.schedule_interval(self.update_init_status, 0.1)
self.check_permissions()
self.check_bluetooth_permissions()
self.start_service()
Clock.schedule_interval(self.jobs, 1.5)
def dismiss_splash(dt):
from android import loadingscreen
loadingscreen.hide_loading_screen()
if RNS.vendor.platformutils.get_platform() == "android":
Clock.schedule_once(dismiss_splash, 0)
self.set_bars_colors()
def sjob(dt):
self.sideband.setstate("app.loaded", True)
self.sideband.setstate("app.running", True)
self.sideband.setstate("app.foreground", True)
Clock.schedule_once(sjob, 6.5)
def start_service(self):
if RNS.vendor.platformutils.is_android():
RNS.log("Running on Android API level "+str(android_api_version))
RNS.log("Launching platform-specific service for RNS and LXMF")
if RNS.vendor.platformutils.get_platform() == "android":
self.android_service = autoclass('io.unsigned.sideband.ServiceSidebandservice')
mActivity = autoclass('org.kivy.android.PythonActivity').mActivity
argument = self.app_dir
self.android_service.start(mActivity, argument)
def start_final(self):
# Start local core instance
self.sideband.start()
# Pre-load announce stream widgets
self.update_loading_text()
self.loader_init()
if not RNS.vendor.platformutils.is_android():
self.telemetry_init()
self.settings_init()
self.information_init()
self.object_details_screen = None
# Wait a little extra for user to react to permissions prompt
# if RNS.vendor.platformutils.get_platform() == "android":
# if self.sideband.first_run:
# time.sleep(6)
if self.sideband.first_run:
self.guide_action()
def fp(delta_time):
self.request_permissions()
Clock.schedule_once(fp, 5)
else:
self.open_conversations()
if not self.root.ids.screen_manager.has_screen("messages_screen"):
self.messages_screen = Builder.load_string(messages_screen_kv)
self.messages_screen.app = self
self.root.ids.screen_manager.add_widget(self.messages_screen)
self.app_state = SidebandApp.ACTIVE
self.loading_updater.cancel()
self.final_load_completed = True
self.keyboard_enabled = True
def check_errors(dt):
if self.sideband.getpersistent("startup.errors.rnode") != None:
description = self.sideband.getpersistent("startup.errors.rnode")["description"]
self.sideband.setpersistent("startup.errors.rnode", None)
yes_button = MDRectangleFlatButton(
text="OK",
font_size=dp(18),
)
self.hw_error_dialog = MDDialog(
title="Hardware Error",
text="When starting a connected RNode, Reticulum reported the following error:\n\n[i]"+str(description)+"[/i]",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
self.hw_error_dialog.dismiss()
yes_button.bind(on_release=dl_yes)
self.hw_error_dialog.open()
Clock.schedule_once(check_errors, 1.5)
#################################################
# General helpers #
#################################################
def set_ui_theme(self):
self.theme_cls.material_style = "M3"
self.theme_cls.widget_style = "android"
self.theme_cls.accent_palette = "Orange"
if self.sideband.config["telemetry_allow_requests_from_anyone"]:
self.theme_cls.primary_palette = "DeepOrange"
else:
self.theme_cls.primary_palette = "BlueGray"
if self.sideband.config["dark_ui"]:
self.theme_cls.theme_style = "Dark"
else:
self.theme_cls.theme_style = "Light"
self.update_ui_colors()
def update_ui_colors(self):
if self.sideband.config["dark_ui"]:
self.color_reject = colors["DeepOrange"]["900"]
self.color_accept = colors["LightGreen"]["700"]
else:
self.color_reject = colors["DeepOrange"]["800"]
self.color_accept = colors["LightGreen"]["700"]
self.apply_eink_mods()
def update_ui_theme(self):
if self.sideband.config["dark_ui"]:
self.theme_cls.theme_style = "Dark"
else:
self.theme_cls.theme_style = "Light"
self.apply_eink_mods()
self.update_ui_colors()
def apply_eink_mods(self):
if self.sideband.config["eink_mode"]:
if self.root != None:
self.root.md_bg_color = self.theme_cls.bg_light
else:
if self.root != None:
self.root.md_bg_color = self.theme_cls.bg_darkest
def set_bars_colors(self):
if RNS.vendor.platformutils.get_platform() == "android":
set_bars_colors(
self.theme_cls.primary_color, # status bar color
[0,0,0,0], # navigation bar color
"Light", # icons color of status bar
)
def close_any_action(self, sender=None):
self.open_conversations(direction="right")
def share_text(self, text):
if RNS.vendor.platformutils.get_platform() == "android":
Intent = autoclass('android.content.Intent')
JString = autoclass('java.lang.String')
shareIntent = Intent()
shareIntent.setAction(Intent.ACTION_SEND)
shareIntent.setType("text/plain")
shareIntent.putExtra(Intent.EXTRA_TEXT, JString(text))
mActivity.startActivity(shareIntent)
def share_image(self, image, filename):
if RNS.vendor.platformutils.get_platform() == "android":
save_path = self.sideband.exports_dir
file_path = save_path+"/"+filename
try:
if not os.path.isdir(save_path):
RNS.log("Creating directory: "+str(save_path))
os.makedirs(save_path)
Intent = autoclass("android.content.Intent")
Uri = autoclass("android.net.Uri")
File = autoclass("java.io.File")
FileProvider = autoclass("androidx.core.content.FileProvider")
image.save(file_path)
i_file = File(file_path)
image_uri = FileProvider.getUriForFile(mActivity, "io.unsigned.sideband.provider", i_file)
shareIntent = Intent()
shareIntent.setAction(Intent.ACTION_SEND)
shareIntent.setType("image/png")
shareIntent.putExtra(Intent.EXTRA_STREAM, cast('android.os.Parcelable', image_uri))
mActivity.startActivity(shareIntent)
except Exception as e:
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Export Error",
text="The QR-code could not be exported and shared:\n\n"+str(e),
buttons=[ ok_button ],
)
def dl_ok(s):
dialog.dismiss()
ok_button.bind(on_release=dl_ok)
dialog.open()
def on_pause(self):
if self.sideband:
if self.sideband.getstate("flag.focusfix_pause"):
self.sideband.setstate("flag.focusfix_pause", False)
return True
else:
RNS.log("App pausing...", RNS.LOG_DEBUG)
self.sideband.setstate("app.running", True)
self.sideband.setstate("app.foreground", False)
self.app_state = SidebandApp.PAUSED
self.sideband.should_persist_data()
if self.conversations_view != None:
self.conversations_view.ids.conversations_scrollview.effect_cls = ScrollEffect
self.conversations_view.ids.conversations_scrollview.scroll = 1
RNS.log("App paused", RNS.LOG_DEBUG)
return True
else:
return True
def on_resume(self):
if self.sideband:
if self.sideband.getstate("flag.focusfix_resume"):
self.sideband.setstate("flag.focusfix_resume", False)
return True
else:
RNS.log("App resuming...", RNS.LOG_DEBUG)
self.sideband.setstate("app.running", True)
self.sideband.setstate("app.foreground", True)
self.sideband.setstate("wants.clear_notifications", True)
self.app_state = SidebandApp.ACTIVE
if self.conversations_view != None:
self.conversations_view.ids.conversations_scrollview.effect_cls = ScrollEffect
self.conversations_view.ids.conversations_scrollview.scroll = 1
else:
RNS.log("Conversations view did not exist", RNS.LOG_DEBUG)
RNS.log("App resumed", RNS.LOG_DEBUG)
def on_stop(self):
RNS.log("App stopping...", RNS.LOG_DEBUG)
self.sideband.setstate("app.running", False)
self.sideband.setstate("app.foreground", False)
self.app_state = SidebandApp.STOPPING
RNS.log("App stopped", RNS.LOG_DEBUG)
def is_in_foreground(self):
if self.app_state == SidebandApp.ACTIVE:
return True
else:
return False
def check_bluetooth_permissions(self):
if RNS.vendor.platformutils.get_platform() == "android":
mActivity = autoclass('org.kivy.android.PythonActivity').mActivity
Context = autoclass('android.content.Context')
if android_api_version > 30:
bt_permission_name = "android.permission.BLUETOOTH_CONNECT"
else:
bt_permission_name = "android.permission.BLUETOOTH"
if check_permission(bt_permission_name):
RNS.log("Have bluetooth connect permissions", RNS.LOG_DEBUG)
self.sideband.setpersistent("permissions.bluetooth", True)
else:
RNS.log("Do not have bluetooth connect permissions")
self.sideband.setpersistent("permissions.bluetooth", False)
else:
self.sideband.setpersistent("permissions.bluetooth", True)
def check_permissions(self):
if RNS.vendor.platformutils.get_platform() == "android":
mActivity = autoclass('org.kivy.android.PythonActivity').mActivity
Context = autoclass('android.content.Context')
NotificationManager = autoclass('android.app.NotificationManager')
notification_service = cast(NotificationManager, mActivity.getSystemService(Context.NOTIFICATION_SERVICE))
if notification_service.areNotificationsEnabled():
self.sideband.setpersistent("permissions.notifications", True)
else:
if check_permission("android.permission.POST_NOTIFICATIONS"):
RNS.log("Have notification permissions", RNS.LOG_DEBUG)
self.sideband.setpersistent("permissions.notifications", True)
else:
RNS.log("Do not have notification permissions")
self.sideband.setpersistent("permissions.notifications", False)
else:
self.sideband.setpersistent("permissions.notifications", True)
def request_permissions(self):
self.request_notifications_permission()
def request_notifications_permission(self):
if RNS.vendor.platformutils.get_platform() == "android":
if not check_permission("android.permission.POST_NOTIFICATIONS"):
RNS.log("Requesting notification permission", RNS.LOG_DEBUG)
request_permissions(["android.permission.POST_NOTIFICATIONS"])
self.check_permissions()
def check_storage_permission(self):
storage_permissions_ok = False
if android_api_version < 30:
if check_permission("android.permission.WRITE_EXTERNAL_STORAGE") and check_permission("android.permission.READ_EXTERNAL_STORAGE"):
storage_permissions_ok = True
else:
self.request_storage_permission()
else:
Environment = autoclass('android.os.Environment')
if Environment.isExternalStorageManager():
storage_permissions_ok = True
else:
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Storage Permission",
text="Sideband needs external storage permission to to read offline map files.\n\nOn this Android version, the Manage All Files permission is needed, since normal external storage permission is no longer supported.\n\nSideband will only ever read and write to files you select, and does not read any other data from your system.",
buttons=[ ok_button ],
)
def dl_ok(s):
dialog.dismiss()
self.request_storage_permission()
ok_button.bind(on_release=dl_ok)
dialog.open()
return storage_permissions_ok
def request_storage_permission(self):
if RNS.vendor.platformutils.get_platform() == "android":
if android_api_version < 30:
if not check_permission("android.permission.WRITE_EXTERNAL_STORAGE"):
RNS.log("Requesting storage write permission", RNS.LOG_DEBUG)
request_permissions(["android.permission.WRITE_EXTERNAL_STORAGE"])
if not check_permission("android.permission.READ_EXTERNAL_STORAGE"):
RNS.log("Requesting storage read permission", RNS.LOG_DEBUG)
request_permissions(["android.permission.READ_EXTERNAL_STORAGE"])
else:
Intent = autoclass('android.content.Intent')
Settings = autoclass('android.provider.Settings')
pIntent = Intent()
pIntent.setAction(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION)
mActivity.startActivity(pIntent)
def request_bluetooth_permissions(self):
if RNS.vendor.platformutils.get_platform() == "android":
if not check_permission("android.permission.BLUETOOTH_CONNECT"):
RNS.log("Requesting bluetooth permission", RNS.LOG_DEBUG)
request_permissions(["android.permission.BLUETOOTH_CONNECT"])
self.check_bluetooth_permissions()
def on_new_intent(self, intent):
RNS.log("Received intent", RNS.LOG_DEBUG)
intent_action = intent.getAction()
action = None
data = None
if intent_action == "android.intent.action.WEB_SEARCH":
SearchManager = autoclass('android.app.SearchManager')
data = intent.getStringExtra(SearchManager.QUERY)
if data.lower().startswith(LXMF.LXMessage.URI_SCHEMA):
action = "lxm_uri"
if intent_action == "android.intent.action.VIEW":
data = intent.getData().toString()
if data.lower().startswith(LXMF.LXMessage.URI_SCHEMA):
action = "lxm_uri"
if action != None:
self.handle_action(action, data)
def handle_action(self, action, data):
if action == "lxm_uri":
self.ingest_lxm_uri(data)
def ingest_lxm_uri(self, lxm_uri):
RNS.log("Ingesting LXMF paper message from URI: "+str(lxm_uri), RNS.LOG_DEBUG)
self.sideband.lxm_ingest_uri(lxm_uri)
def build(self):
FONT_PATH = self.sideband.asset_dir+"/fonts"
if RNS.vendor.platformutils.is_darwin():
self.icon = self.sideband.asset_dir+"/icon_macos_formed.png"
else:
self.icon = self.sideband.asset_dir+"/icon.png"
self.announces_view = None
if RNS.vendor.platformutils.is_android():
ActivityInfo = autoclass('android.content.pm.ActivityInfo')
activity = autoclass('org.kivy.android.PythonActivity').mActivity
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
from android import activity as a_activity
a_activity.bind(on_new_intent=self.on_new_intent)
if self.sideband.config["eink_mode"] == True:
screen = Builder.load_string(root_layout.replace("app.theme_cls.bg_darkest", "app.theme_cls.bg_light"))
else:
screen = Builder.load_string(root_layout)
self.nav_drawer = screen.ids.nav_drawer
return screen
def _state_jobs(self):
props = []
def jobs(self, delta_time):
if self.final_load_completed:
if RNS.vendor.platformutils.is_android() and not self.sideband.service_available():
if time.time() - self.service_last_available > SidebandApp.SERVICE_TIMEOUT:
if self.app_state == SidebandApp.ACTIVE:
info_text = "The Reticulum and LXMF service seem to have disappeared, and Sideband is no longer connected. This should not happen, and probably indicates a bug in the background service. Please restart Sideband to regain connectivity."
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Error",
text=info_text,
buttons=[ ok_button ],
# elevation=0,
)
def dl_ok(s):
dialog.dismiss()
self.quit_action(s)
ok_button.bind(on_release=dl_ok)
self.final_load_completed = False
dialog.open()
else:
self.quit_action(s)
else:
self.service_last_available = time.time()
if self.root.ids.screen_manager.current == "messages_screen":
self.messages_view.update()
if not self.messages_view.ids.messages_scrollview.dest_known:
self.message_area_detect()
elif self.root.ids.screen_manager.current == "conversations_screen":
if self.sideband.getstate("app.flags.unread_conversations", allow_cache=True):
if self.conversations_view != None:
self.conversations_view.update()
if self.sideband.getstate("app.flags.lxmf_sync_dialog_open", allow_cache=True) and self.sync_dialog != None:
state = self.sideband.message_router.propagation_transfer_state
dlg_sp = self.sideband.get_sync_progress()*100; dlg_ss = self.sideband.get_sync_status()
if state > LXMF.LXMRouter.PR_IDLE and state <= LXMF.LXMRouter.PR_COMPLETE:
self.sync_dialog.ids.sync_progress.value = dlg_sp
else:
self.sync_dialog.ids.sync_progress.value = 0.1
self.sync_dialog.ids.sync_status.text = dlg_ss
if state > LXMF.LXMRouter.PR_IDLE and state < LXMF.LXMRouter.PR_COMPLETE:
self.widget_hide(self.sync_dialog.stop_button, False)
else:
self.widget_hide(self.sync_dialog.stop_button, True)
elif self.root.ids.screen_manager.current == "announces_screen":
if self.sideband.getstate("app.flags.new_announces", allow_cache=True):
if self.announces_view != None:
self.announces_view.update()
elif self.root.ids.screen_manager.current == "map_screen":
if self.map_screen and hasattr(self.map_screen.ids.map_layout, "map") and self.map_screen.ids.map_layout.map != None:
self.sideband.config["map_lat"] = self.map_screen.ids.map_layout.map.lat
self.sideband.config["map_lon"] = self.map_screen.ids.map_layout.map.lon
self.sideband.config["map_zoom"] = self.map_screen.ids.map_layout.map.zoom
self.last_telemetry_received = self.sideband.getstate("app.flags.last_telemetry", allow_cache=True) or 0
if self.last_telemetry_received > self.last_map_update:
self.map_update_markers()
if self.sideband.getstate("app.flags.new_conversations", allow_cache=True):
if self.conversations_view != None:
self.conversations_view.update()
if self.sideband.getstate("wants.viewupdate.conversations", allow_cache=True):
if self.conversations_view != None:
self.conversations_view.update()
imr = self.sideband.getstate("lxm_uri_ingest.result", allow_cache=True)
if imr != None and imr != "None":
info_text = str(imr)
self.sideband.setstate("lxm_uri_ingest.result", False)
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Message Scan",
text=str(info_text),
buttons=[ ok_button ],
# elevation=0,
)
def dl_ok(s):
dialog.dismiss()
ok_button.bind(on_release=dl_ok)
dialog.open()
hwe = self.sideband.getstate("hardware_operation.error", allow_cache=True)
if hwe != None and hwe != "None":
info_text = str(hwe)
self.sideband.setstate("hardware_operation.error", False)
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Error",
text=str(info_text),
buttons=[ ok_button ],
# elevation=0,
)
def dl_ok(s):
dialog.dismiss()
ok_button.bind(on_release=dl_ok)
dialog.open()
def on_start(self):
self.last_exit_event = time.time()
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.duration = TRANSITION_DURATION
self.root.ids.screen_manager.transition.bind(on_complete=self.screen_transition_complete)
EventLoop.window.bind(on_keyboard=self.keyboard_event)
EventLoop.window.bind(on_key_down=self.keydown_event)
self.root.ids.screen_manager.app = self
self.root.ids.app_version_info.text = "Sideband v"+__version__+" "+__variant__
self.root.ids.nav_scrollview.effect_cls = ScrollEffect
Clock.schedule_once(self.start_core, 0.25)
def keydown_event(self, instance, keyboard, keycode, text, modifiers):
if self.keyboard_enabled:
if self.root.ids.screen_manager.current == "map_screen":
if not (len(modifiers) > 0 and "ctrl" in modifiers):
if len(modifiers) > 0 and "shift" in modifiers:
nav_mod = 4
elif len(modifiers) > 0 and "alt" in modifiers:
nav_mod = 0.25
else:
nav_mod = 1.0
if keycode == 79 or text == "d" or text == "l": self.map_nav_right(modifier=nav_mod)
if keycode == 80 or text == "a" or text == "h": self.map_nav_left(modifier=nav_mod)
if keycode == 81 or text == "s" or text == "j": self.map_nav_down(modifier=nav_mod)
if keycode == 82 or text == "w" or text == "k": self.map_nav_up(modifier=nav_mod)
if text == "q" or text == "-": self.map_nav_zoom_out(modifier=nav_mod)
if text == "e" or text == "+": self.map_nav_zoom_in(modifier=nav_mod)
if True or self.root.ids.screen_manager.current == "conversations_screen":
if len(modifiers) > 0 and "ctrl" in modifiers:
if keycode < 40 and keycode > 29:
c_index = keycode-29
self.conversation_index_action(c_index)
if len(modifiers) > 0:
if modifiers[0] == "ctrl":
if text == "q":
self.quit_action(self)
if text == "w":
if self.root.ids.screen_manager.current == "conversations_screen":
self.quit_action(self)
elif self.root.ids.screen_manager.current == "map_settings_screen":
self.close_sub_map_action()
elif self.root.ids.screen_manager.current == "object_details_screen":
self.object_details_screen.close_action()
elif self.root.ids.screen_manager.current == "sensors_screen":
self.close_sub_telemetry_action()
elif self.root.ids.screen_manager.current == "icons_screen":
self.close_sub_telemetry_action()
else:
self.open_conversations(direction="right")
if text == "s" or text == "d":
if self.root.ids.screen_manager.current == "messages_screen":
self.message_send_action()
if text == "l":
if self.root.ids.screen_manager.current == "messages_screen":
self.message_propagation_action(self)
elif self.root.ids.screen_manager.current == "map_screen":
self.map_layers_action()
else:
self.announces_action(self)
if text == "m":
if self.root.ids.screen_manager.current == "messages_screen":
context_dest = self.messages_view.ids.messages_scrollview.active_conversation
self.map_show_peer_location(context_dest)
elif self.root.ids.screen_manager.current == "object_details_screen":
context_dest = self.object_details_screen.object_hash
self.map_show_peer_location(context_dest)
else:
self.map_action(self)
if text == "p":
if self.root.ids.screen_manager.current == "map_screen":
self.map_settings_action()
else:
self.settings_action(self)
if text == "t":
if self.root.ids.screen_manager.current == "messages_screen":
self.object_details_action(self.messages_view, from_conv=True)
elif self.root.ids.screen_manager.current == "object_details_screen":
self.object_details_screen.reload_telemetry()
else:
self.telemetry_action(self)
if text == "o":
# if self.root.ids.screen_manager.current == "telemetry_screen":
self.map_display_own_telemetry()
if text == "r":
if self.root.ids.screen_manager.current == "conversations_screen":
self.lxmf_sync_action(self)
elif self.root.ids.screen_manager.current == "telemetry_screen":
self.conversations_action(self, direction="right")
elif self.root.ids.screen_manager.current == "object_details_screen":
if not self.object_details_screen.object_hash == self.sideband.lxmf_destination.hash:
self.converse_from_telemetry(self)
else:
self.conversations_action(self, direction="right")
else:
self.conversations_action(self, direction="right")
if len(modifiers) > 0 and modifiers[0] == 'ctrl' and (text == "g"):
self.guide_action(self)
if text == "n":
if self.root.ids.screen_manager.current == "conversations_screen":
if not hasattr(self, "dialog_open") or not self.dialog_open:
self.new_conversation_action(self)
def keyboard_event(self, window, key, *largs):
if self.keyboard_enabled:
# Handle escape/back
if key == 27:
if self.root.ids.screen_manager.current == "conversations_screen":
if time.time() - self.last_exit_event < 2:
self.quit_action(self)
else:
self.last_exit_event = time.time()
else:
if self.root.ids.screen_manager.current == "hardware_rnode_screen":
self.close_sub_hardware_action()
elif self.root.ids.screen_manager.current == "hardware_modem_screen":
self.close_sub_hardware_action()
elif self.root.ids.screen_manager.current == "hardware_serial_screen":
self.close_sub_hardware_action()
elif self.root.ids.screen_manager.current == "object_details_screen":
self.object_details_screen.close_action()
elif self.root.ids.screen_manager.current == "map_settings_screen":
self.close_sub_map_action()
elif self.root.ids.screen_manager.current == "sensors_screen":
self.close_sub_telemetry_action()
elif self.root.ids.screen_manager.current == "icons_screen":
self.close_sub_telemetry_action()
else:
self.open_conversations(direction="right")
return True
def widget_hide(self, w, hide=True):
if hasattr(w, "saved_attrs"):
if not hide:
w.height, w.size_hint_y, w.opacity, w.disabled = w.saved_attrs
del w.saved_attrs
elif hide:
w.saved_attrs = w.height, w.size_hint_y, w.opacity, w.disabled
w.height, w.size_hint_y, w.opacity, w.disabled = 0, None, 0, True
def ui_clipboard_action(self, sender=None, event=None):
try:
if len(sender.text) == 0:
sender.text = Clipboard.paste()
else:
Clipboard.copy(sender.text)
action = "tap" if RNS.vendor.platformutils.is_android() else "click"
toast(f"Field copied, double-{action} any empty field to paste")
except Exception as e:
RNS.log("An error occurred while handling clipboard action: "+str(e), RNS.LOG_ERROR)
def loader_init(self, sender=None):
if not self.root.ids.screen_manager.has_screen("loader_screen"):
self.loader_screen = Builder.load_string(layout_loader_screen)
self.root.ids.screen_manager.add_widget(self.loader_screen)
def loader_action(self, target=None, direction="left"):
if not self.root.ids.screen_manager.has_screen("loader_screen"):
self.loader_init()
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "loader_screen"
self.root.ids.nav_drawer.set_state("closed")
def quit_action(self, sender):
self.root.ids.nav_drawer.set_state("closed")
self.sideband.should_persist_data()
if not self.root.ids.screen_manager.has_screen("exit_screen"):
self.exit_screen = Builder.load_string(layout_exit_screen)
self.root.ids.screen_manager.add_widget(self.exit_screen)
self.root.ids.screen_manager.transition = NoTransition()
self.root.ids.screen_manager.current = "exit_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
self.sideband.setstate("app.running", False)
self.sideband.setstate("app.foreground", False)
def final_exit(dt):
RNS.log("Stopping service...")
self.sideband.setstate("wants.service_stop", True)
while self.sideband.service_available():
time.sleep(0.2)
RNS.log("Service stopped")
if RNS.vendor.platformutils.is_android():
RNS.log("Finishing activity")
activity = autoclass('org.kivy.android.PythonActivity').mActivity
activity.finishAndRemoveTask()
else:
RNS.exit()
MDApp.get_running_app().stop()
Window.close()
Clock.schedule_once(final_exit, 0.85)
def announce_now_action(self, sender=None):
self.sideband.lxmf_announce()
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Announce Sent",
text="Your LXMF address has been announced on all available interfaces",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
#################################################
# Screens #
#################################################
### Messages (conversation) screen
######################################
def conversation_from_announce_action(self, context_dest):
if self.sideband.has_conversation(context_dest):
pass
else:
self.sideband.create_conversation(context_dest)
self.sideband.setstate("app.flags.new_conversations", True)
self.open_conversation(context_dest)
def conversation_index_action(self, index):
if self.conversations_view != None and self.conversations_view.list != None:
i = index-1
c = self.conversations_view.list.children
if len(c) > i:
item = c[(len(c)-1)-i]
self.conversation_action(item)
def conversation_action(self, sender):
context_dest = sender.sb_uid
def cb(dt):
self.open_conversation(context_dest)
def cbu(dt):
self.conversations_view.update()
Clock.schedule_once(cb, 0.15)
Clock.schedule_once(cbu, 0.15+0.25)
def open_conversation(self, context_dest, direction="left"):
self.outbound_mode_paper = False
self.outbound_mode_command = False
if self.sideband.config["propagation_by_default"]:
self.outbound_mode_propagation = True
else:
self.outbound_mode_propagation = False
self.root.ids.screen_manager.transition.direction = direction
self.messages_view = Messages(self, context_dest)
self.messages_view.ids.messages_scrollview.effect_cls = ScrollEffect
for child in self.messages_view.ids.messages_scrollview.children:
self.messages_view.ids.messages_scrollview.remove_widget(child)
list_widget = self.messages_view.get_widget()
self.messages_view.ids.messages_scrollview.add_widget(list_widget)
self.messages_view.ids.messages_scrollview.scroll_y = 0.0
self.messages_view.ids.messages_toolbar.title = self.sideband.peer_display_name(context_dest)
self.messages_view.ids.messages_scrollview.active_conversation = context_dest
self.sideband.setstate("app.active_conversation", context_dest)
self.messages_view.ids.nokeys_text.text = ""
self.message_area_detect()
self.update_message_widgets()
self.messages_view.ids.message_text.disabled = False
self.root.ids.screen_manager.current = "messages_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
self.sideband.read_conversation(context_dest)
self.sideband.setstate("app.flags.unread_conversations", True)
def scb(dt):
self.messages_view.ids.messages_scrollview.scroll_y = 0.0
Clock.schedule_once(scb, 0.33)
def close_messages_action(self, sender=None):
self.open_conversations(direction="right")
def message_send_action(self, sender=None):
if self.messages_view.ids.message_text.text == "":
return
def cb(dt):
self.message_send_dispatch(sender)
Clock.schedule_once(cb, 0.20)
def message_send_dispatch(self, sender=None):
self.messages_view.ids.message_send_button.disabled = True
if self.root.ids.screen_manager.current == "messages_screen":
if self.outbound_mode_propagation and self.sideband.message_router.get_outbound_propagation_node() == None:
self.messages_view.send_error_dialog = MDDialog(
title="Error",
text="Propagated delivery was requested, but no active LXMF propagation nodes were found. Cannot send message.\n\nWait for a Propagation Node to announce on the network, or manually specify one in the settings.",
buttons=[
MDRectangleFlatButton(
text="OK",
font_size=dp(18),
on_release=self.messages_view.close_send_error_dialog
)
],
# elevation=0,
)
self.messages_view.send_error_dialog.open()
else:
msg_content = self.messages_view.ids.message_text.text
context_dest = self.messages_view.ids.messages_scrollview.active_conversation
if self.outbound_mode_command:
if self.sideband.send_command(msg_content, context_dest, False):
self.messages_view.ids.message_text.text = ""
self.messages_view.ids.messages_scrollview.scroll_y = 0
self.jobs(0)
else:
self.messages_view.send_error_dialog = MDDialog(
title="Error",
text="Could not send the command. Check that the syntax is correct, and that the command is supported.",
buttons=[
MDRectangleFlatButton(
text="OK",
font_size=dp(18),
on_release=self.messages_view.close_send_error_dialog
)
],
)
self.messages_view.send_error_dialog.open()
elif self.outbound_mode_paper:
if self.sideband.paper_message(msg_content, context_dest):
self.messages_view.ids.message_text.text = ""
self.messages_view.ids.messages_scrollview.scroll_y = 0
self.jobs(0)
elif self.sideband.send_message(msg_content, context_dest, self.outbound_mode_propagation):
self.messages_view.ids.message_text.text = ""
self.messages_view.ids.messages_scrollview.scroll_y = 0
self.jobs(0)
else:
self.messages_view.send_error_dialog = MDDialog(
title="Error",
text="Could not send the message",
buttons=[
MDRectangleFlatButton(
text="OK",
font_size=dp(18),
on_release=self.messages_view.close_send_error_dialog
)
],
)
self.messages_view.send_error_dialog.open()
def cb(dt):
self.messages_view.ids.message_send_button.disabled = False
Clock.schedule_once(cb, 0.5)
def peer_show_location_action(self, sender):
if self.root.ids.screen_manager.current == "messages_screen":
context_dest = self.messages_view.ids.messages_scrollview.active_conversation
self.map_show_peer_location(context_dest)
if self.root.ids.screen_manager.current == "object_details_screen":
context_dest = self.object_details_screen.object_hash
self.map_show_peer_location(context_dest)
def peer_show_telemetry_action(self, sender):
if self.root.ids.screen_manager.current == "messages_screen":
self.object_details_action(self.messages_view, from_conv=True)
def message_propagation_action(self, sender):
if self.outbound_mode_command:
self.outbound_mode_paper = False
self.outbound_mode_propagation = False
self.outbound_mode_command = False
else:
if self.outbound_mode_paper:
self.outbound_mode_paper = False
self.outbound_mode_propagation = False
self.outbound_mode_command = True
else:
if self.outbound_mode_propagation:
self.outbound_mode_paper = True
self.outbound_mode_propagation = False
self.outbound_mode_command = False
else:
self.outbound_mode_propagation = True
self.outbound_mode_paper = False
self.outbound_mode_command = False
self.update_message_widgets()
def update_message_widgets(self):
toolbar_items = self.messages_view.ids.messages_toolbar.ids.right_actions.children
mode_item = toolbar_items[1]
if self.outbound_mode_paper:
mode_item.icon = "qrcode"
self.messages_view.ids.message_text.hint_text = "Paper message"
else:
if self.outbound_mode_command:
mode_item.icon = "console"
self.messages_view.ids.message_text.hint_text = "Send command or request"
else:
if not self.outbound_mode_propagation:
mode_item.icon = "lan-connect"
self.messages_view.ids.message_text.hint_text = "Message for direct delivery"
else:
mode_item.icon = "upload-network"
self.messages_view.ids.message_text.hint_text = "Message for propagation"
# self.root.ids.message_text.hint_text = "Write message for delivery via propagation nodes"
def key_query_action(self, sender):
context_dest = self.messages_view.ids.messages_scrollview.active_conversation
if self.sideband.request_key(context_dest):
keys_str = "Public key information for "+RNS.prettyhexrep(context_dest)+" was requested from the network. Waiting for request to be answered."
self.messages_view.ids.nokeys_text.text = keys_str
else:
keys_str = "Could not send request. Check your connectivity and addresses."
self.messages_view.ids.nokeys_text.text = keys_str
def message_area_detect(self):
context_dest = self.messages_view.ids.messages_scrollview.active_conversation
if self.sideband.is_known(context_dest):
self.messages_view.ids.messages_scrollview.dest_known = True
self.widget_hide(self.messages_view.ids.message_input_part, False)
self.widget_hide(self.messages_view.ids.no_keys_part, True)
else:
self.messages_view.ids.messages_scrollview.dest_known = False
if self.messages_view.ids.nokeys_text.text == "":
keys_str = "The crytographic keys for the destination address are unknown at this time. You can wait for an announce to arrive, or query the network for the necessary keys."
self.messages_view.ids.nokeys_text.text = keys_str
self.widget_hide(self.messages_view.ids.message_input_part, True)
self.widget_hide(self.messages_view.ids.no_keys_part, False)
### Conversations screen
######################################
def conversations_action(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.open_conversations(direction=direction)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def open_conversations(self, direction="left"):
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.nav_drawer.set_state("closed")
if not self.conversations_view:
self.conversations_view = Conversations(self)
for child in self.conversations_view.ids.conversations_scrollview.children:
self.conversations_view.ids.conversations_scrollview.remove_widget(child)
self.conversations_view.ids.conversations_scrollview.effect_cls = ScrollEffect
self.conversations_view.ids.conversations_scrollview.add_widget(self.conversations_view.get_widget())
self.root.ids.screen_manager.current = "conversations_screen"
if self.messages_view:
self.messages_view.ids.messages_scrollview.active_conversation = None
def cb(dt):
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
self.sideband.setstate("wants.clear_notifications", True)
Clock.schedule_once(cb, 0.10)
def get_connectivity_text(self):
try:
connectivity_status = ""
if RNS.vendor.platformutils.get_platform() == "android":
connectivity_status = str(self.sideband.getstate("service.connectivity_status"))
else:
if self.sideband.reticulum.is_connected_to_shared_instance:
connectivity_status = "Sideband is connected via a shared Reticulum instance running on this system. Use the [b]rnstatus[/b] utility to obtain full connectivity info."
else:
connectivity_status = "Sideband is currently running a standalone or master Reticulum instance on this system. Use the [b]rnstatus[/b] utility to obtain full connectivity info."
return connectivity_status
except Exception as e:
RNS.log("An error occurred while retrieving connectivity status: "+str(e), RNS.LOG_ERROR)
return "Could not retrieve connectivity status"
def connectivity_status(self, sender):
hs = dp(22)
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Connectivity Status",
text=str(self.get_connectivity_text()),
buttons=[ yes_button ],
# elevation=0,
)
def cs_updater(dt):
dialog.text = str(self.get_connectivity_text())
def dl_yes(s):
self.connectivity_updater.cancel()
dialog.dismiss()
if self.connectivity_updater != None:
self.connectivity_updater.cancel()
yes_button.bind(on_release=dl_yes)
dialog.open()
if self.connectivity_updater != None:
self.connectivity_updater.cancel()
self.connectivity_updater = Clock.schedule_interval(cs_updater, 2.0)
def ingest_lxm_action(self, sender):
def cb(dt):
self.open_ingest_lxm_dialog(sender)
Clock.schedule_once(cb, 0.15)
def open_ingest_lxm_dialog(self, sender=None):
try:
cancel_button = MDRectangleFlatButton(text="Cancel",font_size=dp(18))
ingest_button = MDRectangleFlatButton(text="Read LXM",font_size=dp(18), theme_text_color="Custom", line_color=self.color_accept, text_color=self.color_accept)
dialog = MDDialog(
title="Ingest Paper Message",
text="You can read LXMF paper messages into this program by scanning a QR-code containing the message with your device camera or QR-scanner app, and then opening the resulting link in Sideband.\n\nAlternatively, you can copy an [b]lxm://[/b] link from any source to your clipboard, and ingest it using the [i]Read LXM[/i] button below.",
buttons=[ ingest_button, cancel_button ],
)
def dl_yes(s):
try:
lxm_uri = Clipboard.paste()
if not lxm_uri.lower().startswith(LXMF.LXMessage.URI_SCHEMA+"://"):
lxm_uri = LXMF.LXMessage.URI_SCHEMA+"://"+lxm_uri
self.ingest_lxm_uri(lxm_uri)
dialog.dismiss()
except Exception as e:
response = "Error ingesting message from URI: "+str(e)
RNS.log(response, RNS.LOG_ERROR)
self.sideband.setstate("lxm_uri_ingest.result", response)
dialog.dismiss()
def dl_no(s):
dialog.dismiss()
def dl_ds(s):
self.dialog_open = False
ingest_button.bind(on_release=dl_yes)
cancel_button.bind(on_release=dl_no)
dialog.bind(on_dismiss=dl_ds)
dialog.open()
self.dialog_open = True
except Exception as e:
RNS.log("Error while creating ingest LXM dialog: "+str(e), RNS.LOG_ERROR)
def lxmf_sync_action(self, sender):
def cb(dt):
self.lxmf_sync_request(sender)
Clock.schedule_once(cb, 0.15)
def lxmf_sync_request(self, sender):
if self.sideband.message_router.get_outbound_propagation_node() == None:
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Can't Sync",
text="No active LXMF propagation nodes were found. Cannot fetch messages. Wait for a Propagation Node to announce on the network, or manually specify one in the settings.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
else:
if self.sideband.config["lxmf_sync_limit"]:
sl = self.sideband.config["lxmf_sync_max"]
else:
sl = None
if not hasattr(self, "message_sync_dialog") or self.message_sync_dialog == None:
close_button = MDRectangleFlatButton(text="Close",font_size=dp(18))
stop_button = MDRectangleFlatButton(text="Stop",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
dialog_content = MsgSync()
dialog = MDDialog(
title="LXMF Sync via "+RNS.prettyhexrep(self.sideband.message_router.get_outbound_propagation_node()),
type="custom",
content_cls=dialog_content,
buttons=[ stop_button, close_button ],
# elevation=0,
)
dialog.d_content = dialog_content
def dl_close(s):
self.sideband.setstate("app.flags.lxmf_sync_dialog_open", False)
dialog.dismiss()
self.message_sync_dialog.d_content.ids.sync_progress.value = 0.1
self.message_sync_dialog.d_content.ids.sync_status.text = ""
# self.sideband.cancel_lxmf_sync()
def dl_stop(s):
# self.sideband.setstate("app.flags.lxmf_sync_dialog_open", False)
# dialog.dismiss()
self.sideband.cancel_lxmf_sync()
def cb(dt):
self.widget_hide(self.sync_dialog.stop_button, True)
Clock.schedule_once(cb, 0.25)
close_button.bind(on_release=dl_close)
stop_button.bind(on_release=dl_stop)
self.message_sync_dialog = dialog
self.sync_dialog = dialog_content
self.sync_dialog.stop_button = stop_button
s_state = self.sideband.message_router.propagation_transfer_state
if s_state > LXMF.LXMRouter.PR_PATH_REQUESTED and s_state <= LXMF.LXMRouter.PR_COMPLETE:
dsp = self.sideband.get_sync_progress()*100
else:
dsp = 0
self.sideband.setstate("app.flags.lxmf_sync_dialog_open", True)
self.message_sync_dialog.title = f"LXMF Sync via "+RNS.prettyhexrep(self.sideband.message_router.get_outbound_propagation_node())
self.message_sync_dialog.d_content.ids.sync_status.text = self.sideband.get_sync_status()
self.message_sync_dialog.d_content.ids.sync_progress.value = dsp
self.message_sync_dialog.d_content.ids.sync_progress.start()
self.sync_dialog.ids.sync_progress.stop()
self.message_sync_dialog.open()
def sij(dt):
self.sideband.setpersistent("lxmf.lastsync", time.time())
self.sideband.setpersistent("lxmf.syncretrying", False)
self.sideband.request_lxmf_sync(limit=sl)
Clock.schedule_once(sij, 0.1)
def new_conversation_action(self, sender=None):
def cb(dt):
self.new_conversation_request(sender)
Clock.schedule_once(cb, 0.15)
def new_conversation_request(self, sender=None):
try:
cancel_button = MDRectangleFlatButton(text="Cancel",font_size=dp(18))
create_button = MDRectangleFlatButton(text="Create",font_size=dp(18), theme_text_color="Custom", line_color=self.color_accept, text_color=self.color_accept)
dialog_content = NewConv()
dialog = MDDialog(
title="New Conversation",
type="custom",
content_cls=dialog_content,
buttons=[ create_button, cancel_button ],
# elevation=0,
)
dialog.d_content = dialog_content
def dl_yes(s):
new_result = False
try:
n_address = dialog.d_content.ids["n_address_field"].text
n_name = dialog.d_content.ids["n_name_field"].text
n_trusted = dialog.d_content.ids["n_trusted"].active
new_result = self.sideband.new_conversation(n_address, n_name, n_trusted)
except Exception as e:
RNS.log("Error while creating conversation: "+str(e), RNS.LOG_ERROR)
if new_result:
dialog.d_content.ids["n_address_field"].error = False
dialog.dismiss()
if self.conversations_view != None:
self.conversations_view.update()
else:
dialog.d_content.ids["n_address_field"].error = True
# dialog.d_content.ids["n_error_field"].text = "Could not create conversation. Check your input."
def dl_no(s):
dialog.dismiss()
def dl_ds(s):
self.dialog_open = False
create_button.bind(on_release=dl_yes)
cancel_button.bind(on_release=dl_no)
dialog.bind(on_dismiss=dl_ds)
dialog.open()
self.dialog_open = True
except Exception as e:
RNS.log("Error while creating new conversation dialog: "+str(e), RNS.LOG_ERROR)
### Information/version screen
######################################
def information_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("information_screen"):
self.information_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.information_init()
def o(dt):
self.information_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def information_init(self):
if not self.root.ids.screen_manager.has_screen("information_screen"):
self.information_screen = Builder.load_string(layout_information_screen)
self.information_screen.app = self
self.root.ids.screen_manager.add_widget(self.information_screen)
def link_exec(sender=None, event=None):
def lj():
webbrowser.open("https://unsigned.io/donate")
threading.Thread(target=lj, daemon=True).start()
self.information_screen.ids.information_scrollview.effect_cls = ScrollEffect
self.information_screen.ids.information_logo.icon = self.sideband.asset_dir+"/rns_256.png"
info = "This is Sideband v"+__version__+" "+__variant__+", on RNS v"+RNS.__version__+" and LXMF v"+LXMF.__version__+".\n\nHumbly build using the following open components:\n\n - [b]Reticulum[/b] (MIT License)\n - [b]LXMF[/b] (MIT License)\n - [b]KivyMD[/b] (MIT License)\n - [b]Kivy[/b] (MIT License)\n - [b]Python[/b] (PSF License)"+"\n\nGo to [u][ref=link]https://unsigned.io/donate[/ref][/u] to support the project.\n\nThe Sideband app is Copyright (c) 2022 Mark Qvist / unsigned.io\n\nPermission is granted to freely share and distribute binary copies of Sideband v"+__version__+" "+__variant__+", so long as no payment or compensation is charged for said distribution or sharing.\n\nIf you were charged or paid anything for this copy of Sideband, please report it to [b]license@unsigned.io[/b].\n\nTHIS IS EXPERIMENTAL SOFTWARE - SIDEBAND COMES WITH ABSOLUTELY NO WARRANTY - USE AT YOUR OWN RISK AND RESPONSIBILITY"
self.information_screen.ids.information_info.text = info
self.information_screen.ids.information_info.bind(on_ref_press=link_exec)
def information_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.screen_manager.current = "information_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def close_information_action(self, sender=None):
self.open_conversations(direction="right")
### Settings screen
######################################
def settings_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.nav_drawer.set_state("closed")
if self.sideband.active_propagation_node != None:
self.settings_screen.ids.settings_propagation_node_address.text = RNS.hexrep(self.sideband.active_propagation_node, delimit=False)
self.root.ids.screen_manager.current = "settings_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def settings_action(self, sender=None, direction="left"):
if self.settings_ready:
self.settings_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.settings_init()
def o(dt):
self.settings_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def interval_to_slider_val(self, interval):
try:
mseg = 72; hseg = 84; sv = 0
mm = mseg*5*60; hm = hseg*60*30+mm
if interval <= mm:
sv = interval/60/5
elif interval > mm and interval <= hm:
half_hours = interval/(60*30)-(mm/(60*30))
sv = mseg+half_hours
else:
days = (interval/86400)-((hseg*60*30)/84600)-(mm/86400)
sv = 1+mseg+hseg+days
except Exception as e:
return 43200
return sv
def bind_clipboard_actions(self, ids, force=False):
if force or RNS.vendor.platformutils.is_android():
BIND_CLASSES = ["kivymd.uix.textfield.textfield.MDTextField",]
for e in ids:
te = ids[e]
ts = str(te).split(" ")[0].replace("<", "")
if ts in BIND_CLASSES and not hasattr(e, "no_clipboard"):
RNS.log("Binding clipboard action to "+str(e))
te.bind(on_double_tap=self.ui_clipboard_action)
def settings_init(self, sender=None):
if not self.settings_ready:
if not self.root.ids.screen_manager.has_screen("settings_screen"):
self.settings_screen = Builder.load_string(layout_settings_screen)
self.settings_screen.app = self
self.root.ids.screen_manager.add_widget(self.settings_screen)
self.bind_clipboard_actions(self.settings_screen.ids)
self.settings_screen.ids.settings_scrollview.effect_cls = ScrollEffect
info1_text = "\nYou can set your [b]Display Name[/b] to a custom value, or leave it as the default unspecified value. "
info1_text += "This name will be included in any announces you send, and will be visible to others on the network. "
info1_text += "\n\nYou can manually specify which [b]Propagation Node[/b] to use, but if none is specified, Sideband will "
info1_text += "automatically select one nearby."
if RNS.vendor.platformutils.is_android():
info1_text += "\n\nDouble-tap any field to copy its value, and double-tap an empty field to paste into it."
self.settings_screen.ids.settings_info1.text = info1_text
def save_disp_name(sender=None, event=None):
if not sender.focus:
in_name = self.settings_screen.ids.settings_display_name.text
if in_name == "":
new_name = "Anonymous Peer"
else:
new_name = in_name
self.sideband.config["display_name"] = new_name
self.sideband.save_configuration()
def save_prop_addr(sender=None, event=None):
if not sender.focus:
in_addr = self.settings_screen.ids.settings_propagation_node_address.text
new_addr = None
if in_addr == "":
new_addr = None
self.settings_screen.ids.settings_propagation_node_address.error = False
else:
if len(in_addr) != RNS.Reticulum.TRUNCATED_HASHLENGTH//8*2:
new_addr = None
else:
try:
new_addr = bytes.fromhex(in_addr)
except Exception as e:
new_addr = None
if new_addr == None:
self.settings_screen.ids.settings_propagation_node_address.error = True
else:
self.settings_screen.ids.settings_propagation_node_address.error = False
self.sideband.config["lxmf_propagation_node"] = new_addr
self.sideband.set_active_propagation_node(self.sideband.config["lxmf_propagation_node"])
def save_dark_ui(sender=None, event=None):
self.sideband.config["dark_ui"] = self.settings_screen.ids.settings_dark_ui.active
self.sideband.save_configuration()
self.update_ui_theme()
def save_eink_mode(sender=None, event=None):
self.sideband.config["eink_mode"] = self.settings_screen.ids.settings_eink_mode.active
self.sideband.save_configuration()
self.update_ui_theme()
def save_display_style_in_contact_list(sender=None, event=None):
self.sideband.config["display_style_in_contact_list"] = self.settings_screen.ids.display_style_in_contact_list.active
self.sideband.save_configuration()
self.sideband.setstate("wants.viewupdate.conversations", True)
def save_advanced_stats(sender=None, event=None):
self.sideband.config["advanced_stats"] = self.settings_screen.ids.settings_advanced_statistics.active
self.sideband.save_configuration()
def save_notifications_on(sender=None, event=None):
self.sideband.config["notifications_on"] = self.settings_screen.ids.settings_notifications_on.active
self.sideband.save_configuration()
def save_start_announce(sender=None, event=None):
self.sideband.config["start_announce"] = self.settings_screen.ids.settings_start_announce.active
self.sideband.save_configuration()
def save_lxmf_delivery_by_default(sender=None, event=None):
self.sideband.config["propagation_by_default"] = self.settings_screen.ids.settings_lxmf_delivery_by_default.active
self.sideband.save_configuration()
def save_lxmf_try_propagation_on_fail(sender=None, event=None):
self.sideband.config["lxmf_try_propagation_on_fail"] = self.settings_screen.ids.settings_lxmf_try_propagation_on_fail.active
self.sideband.save_configuration()
def save_lxmf_ignore_unknown(sender=None, event=None):
self.sideband.config["lxmf_ignore_unknown"] = self.settings_screen.ids.settings_lxmf_ignore_unknown.active
self.sideband.save_configuration()
def save_lxmf_sync_limit(sender=None, event=None):
self.sideband.config["lxmf_sync_limit"] = self.settings_screen.ids.settings_lxmf_sync_limit.active
self.sideband.save_configuration()
def save_debug(sender=None, event=None):
self.sideband.config["debug"] = self.settings_screen.ids.settings_debug.active
self.sideband.save_configuration()
self.sideband._reticulum_log_debug(self.sideband.config["debug"])
def save_print_command(sender=None, event=None):
if not sender.focus:
in_cmd = self.settings_screen.ids.settings_print_command.text
if in_cmd == "":
new_cmd = "lp"
else:
new_cmd = in_cmd
self.sideband.config["print_command"] = new_cmd.strip()
self.settings_screen.ids.settings_print_command.text = self.sideband.config["print_command"]
self.sideband.save_configuration()
def save_lxmf_periodic_sync(sender=None, event=None, save=True):
if self.settings_screen.ids.settings_lxmf_periodic_sync.active:
self.widget_hide(self.settings_screen.ids.lxmf_syncslider_container, False)
else:
self.widget_hide(self.settings_screen.ids.lxmf_syncslider_container, True)
if save:
self.sideband.config["lxmf_periodic_sync"] = self.settings_screen.ids.settings_lxmf_periodic_sync.active
self.sideband.save_configuration()
def sync_interval_change(sender=None, event=None, save=True):
slider_val = int(self.settings_screen.ids.settings_lxmf_sync_interval.value)
mseg = 72; hseg = 84
if slider_val <= mseg:
interval = slider_val*5*60
elif slider_val > mseg and slider_val <= mseg+hseg:
h = (slider_val-mseg)/2; mm = mseg*5*60
interval = h*60*60+mm
else:
d = slider_val-hseg-mseg
hm = (hseg/2)*60*60; mm = mseg*5*60
interval = d*86400+hm+mm
interval_text = RNS.prettytime(interval)
pre = self.settings_screen.ids.settings_lxmf_sync_periodic.text
self.settings_screen.ids.settings_lxmf_sync_periodic.text = "Auto sync every "+interval_text
if save:
self.sideband.config["lxmf_sync_interval"] = interval
self.sideband.save_configuration()
self.settings_screen.ids.settings_lxmf_address.text = RNS.hexrep(self.sideband.lxmf_destination.hash, delimit=False)
self.settings_screen.ids.settings_identity_hash.text = RNS.hexrep(self.sideband.lxmf_destination.identity.hash, delimit=False)
self.settings_screen.ids.settings_display_name.text = self.sideband.config["display_name"]
self.settings_screen.ids.settings_display_name.bind(focus=save_disp_name)
if RNS.vendor.platformutils.is_android():
pass
# self.widget_hide(self.settings_screen.ids.settings_print_command, True)
else:
self.settings_screen.ids.settings_print_command.text = self.sideband.config["print_command"]
self.settings_screen.ids.settings_print_command.bind(focus=save_print_command)
if self.sideband.config["lxmf_propagation_node"] == None:
prop_node_addr = ""
else:
prop_node_addr = RNS.hexrep(self.sideband.config["lxmf_propagation_node"], delimit=False)
self.settings_screen.ids.settings_propagation_node_address.text = prop_node_addr
self.settings_screen.ids.settings_propagation_node_address.bind(focus=save_prop_addr)
if not RNS.vendor.platformutils.is_android() or android_api_version >= 26:
self.settings_screen.ids.settings_notifications_on.active = self.sideband.config["notifications_on"]
self.settings_screen.ids.settings_notifications_on.bind(active=save_notifications_on)
else:
self.settings_screen.ids.settings_notifications_on.active = False
self.settings_screen.ids.settings_notifications_on.disabled = True
self.settings_screen.ids.settings_dark_ui.active = self.sideband.config["dark_ui"]
self.settings_screen.ids.settings_dark_ui.bind(active=save_dark_ui)
self.settings_screen.ids.settings_eink_mode.active = self.sideband.config["eink_mode"]
self.settings_screen.ids.settings_eink_mode.bind(active=save_eink_mode)
self.settings_screen.ids.display_style_in_contact_list.active = self.sideband.config["display_style_in_contact_list"]
self.settings_screen.ids.display_style_in_contact_list.bind(active=save_display_style_in_contact_list)
self.settings_screen.ids.settings_advanced_statistics.active = self.sideband.config["advanced_stats"]
self.settings_screen.ids.settings_advanced_statistics.bind(active=save_advanced_stats)
self.settings_screen.ids.settings_start_announce.active = self.sideband.config["start_announce"]
self.settings_screen.ids.settings_start_announce.bind(active=save_start_announce)
self.settings_screen.ids.settings_lxmf_delivery_by_default.active = self.sideband.config["propagation_by_default"]
self.settings_screen.ids.settings_lxmf_delivery_by_default.bind(active=save_lxmf_delivery_by_default)
self.settings_screen.ids.settings_lxmf_try_propagation_on_fail.active = self.sideband.config["lxmf_try_propagation_on_fail"]
self.settings_screen.ids.settings_lxmf_try_propagation_on_fail.bind(active=save_lxmf_try_propagation_on_fail)
self.settings_screen.ids.settings_lxmf_ignore_unknown.active = self.sideband.config["lxmf_ignore_unknown"]
self.settings_screen.ids.settings_lxmf_ignore_unknown.bind(active=save_lxmf_ignore_unknown)
self.settings_screen.ids.settings_lxmf_periodic_sync.active = self.sideband.config["lxmf_periodic_sync"]
self.settings_screen.ids.settings_lxmf_periodic_sync.bind(active=save_lxmf_periodic_sync)
save_lxmf_periodic_sync(save=False)
def sync_interval_change_cb(sender=None, event=None):
sync_interval_change(sender=sender, event=event, save=False)
self.settings_screen.ids.settings_lxmf_sync_interval.bind(value=sync_interval_change_cb)
self.settings_screen.ids.settings_lxmf_sync_interval.bind(on_touch_up=sync_interval_change)
self.settings_screen.ids.settings_lxmf_sync_interval.value = self.interval_to_slider_val(self.sideband.config["lxmf_sync_interval"])
sync_interval_change(save=False)
if self.sideband.config["lxmf_sync_limit"] == None or self.sideband.config["lxmf_sync_limit"] == False:
sync_limit = False
else:
sync_limit = True
self.settings_screen.ids.settings_lxmf_sync_limit.active = sync_limit
self.settings_screen.ids.settings_lxmf_sync_limit.bind(active=save_lxmf_sync_limit)
self.settings_screen.ids.settings_debug.active = self.sideband.config["debug"]
self.settings_screen.ids.settings_debug.bind(active=save_debug)
self.settings_ready = True
def close_settings_action(self, sender=None):
self.open_conversations(direction="right")
### Connectivity screen
######################################
def connectivity_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.nav_drawer.set_state("closed")
self.connectivity_init()
self.root.ids.screen_manager.current = "connectivity_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def connectivity_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("connectivity_screen"):
self.connectivity_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.connectivity_init()
def o(dt):
self.connectivity_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def connectivity_init(self, sender=None):
if not self.connectivity_ready:
if not self.root.ids.screen_manager.has_screen("connectivity_screen"):
self.connectivity_screen = Builder.load_string(layout_connectivity_screen)
self.connectivity_screen.app = self
self.root.ids.screen_manager.add_widget(self.connectivity_screen)
self.bind_clipboard_actions(self.connectivity_screen.ids)
self.connectivity_screen.ids.connectivity_scrollview.effect_cls = ScrollEffect
def con_hide_settings():
self.widget_hide(self.connectivity_screen.ids.connectivity_use_local)
self.widget_hide(self.connectivity_screen.ids.connectivity_local_groupid)
self.widget_hide(self.connectivity_screen.ids.connectivity_local_ifac_netname)
self.widget_hide(self.connectivity_screen.ids.connectivity_local_ifac_passphrase)
self.widget_hide(self.connectivity_screen.ids.connectivity_use_tcp)
self.widget_hide(self.connectivity_screen.ids.connectivity_tcp_host)
self.widget_hide(self.connectivity_screen.ids.connectivity_tcp_port)
self.widget_hide(self.connectivity_screen.ids.connectivity_tcp_ifac_netname)
self.widget_hide(self.connectivity_screen.ids.connectivity_tcp_ifac_passphrase)
self.widget_hide(self.connectivity_screen.ids.connectivity_use_i2p)
self.widget_hide(self.connectivity_screen.ids.connectivity_i2p_b32)
self.widget_hide(self.connectivity_screen.ids.connectivity_i2p_ifac_netname)
self.widget_hide(self.connectivity_screen.ids.connectivity_i2p_ifac_passphrase)
self.widget_hide(self.connectivity_screen.ids.connectivity_tcp_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_local_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_i2p_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_rnode_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_rnode_ifac_netname)
self.widget_hide(self.connectivity_screen.ids.connectivity_rnode_ifac_passphrase)
self.widget_hide(self.connectivity_screen.ids.connectivity_use_rnode)
self.widget_hide(self.connectivity_screen.ids.connectivity_modem_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_use_modem)
self.widget_hide(self.connectivity_screen.ids.connectivity_modem_fields)
self.widget_hide(self.connectivity_screen.ids.connectivity_transport_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_enable_transport)
self.widget_hide(self.connectivity_screen.ids.connectivity_serial_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_use_serial)
self.widget_hide(self.connectivity_screen.ids.connectivity_serial_fields)
self.widget_hide(self.connectivity_screen.ids.connectivity_shared_access)
self.widget_hide(self.connectivity_screen.ids.connectivity_shared_access_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_shared_access_fields)
self.widget_hide(self.connectivity_screen.ids.connectivity_transport_label)
self.widget_hide(self.connectivity_screen.ids.connectivity_enable_transport)
self.widget_hide(self.connectivity_screen.ids.connectivity_transport_info)
self.widget_hide(self.connectivity_screen.ids.connectivity_transport_fields)
def con_collapse_local(collapse=True):
# self.widget_hide(self.root.ids.connectivity_local_fields, collapse)
pass
def con_collapse_tcp(collapse=True):
# self.widget_hide(self.root.ids.connectivity_tcp_fields, collapse)
pass
def con_collapse_i2p(collapse=True):
# self.widget_hide(self.root.ids.connectivity_i2p_fields, collapse)
pass
def con_collapse_bluetooth(collapse=True):
# self.widget_hide(self.root.ids.connectivity_bluetooth_fields, collapse)
pass
def con_collapse_rnode(collapse=True):
# self.widget_hide(self.root.ids.connectivity_rnode_fields, collapse)
pass
def con_collapse_modem(collapse=True):
# self.widget_hide(self.root.ids.connectivity_modem_fields, collapse)
pass
def con_collapse_serial(collapse=True):
# self.widget_hide(self.root.ids.connectivity_serial_fields, collapse)
pass
def con_collapse_transport(collapse=True):
# self.widget_hide(self.root.ids.connectivity_transport_fields, collapse)
pass
def save_connectivity(sender=None, event=None):
self.sideband.config["connect_transport"] = self.connectivity_screen.ids.connectivity_enable_transport.active
self.sideband.config["connect_local"] = self.connectivity_screen.ids.connectivity_use_local.active
self.sideband.config["connect_local_groupid"] = self.connectivity_screen.ids.connectivity_local_groupid.text
self.sideband.config["connect_local_ifac_netname"] = self.connectivity_screen.ids.connectivity_local_ifac_netname.text
self.sideband.config["connect_local_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_local_ifac_passphrase.text
self.sideband.config["connect_tcp"] = self.connectivity_screen.ids.connectivity_use_tcp.active
self.sideband.config["connect_tcp_host"] = self.connectivity_screen.ids.connectivity_tcp_host.text
self.sideband.config["connect_tcp_port"] = self.connectivity_screen.ids.connectivity_tcp_port.text
self.sideband.config["connect_tcp_ifac_netname"] = self.connectivity_screen.ids.connectivity_tcp_ifac_netname.text
self.sideband.config["connect_tcp_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_tcp_ifac_passphrase.text
self.sideband.config["connect_i2p"] = self.connectivity_screen.ids.connectivity_use_i2p.active
self.sideband.config["connect_i2p_b32"] = self.connectivity_screen.ids.connectivity_i2p_b32.text
self.sideband.config["connect_i2p_ifac_netname"] = self.connectivity_screen.ids.connectivity_i2p_ifac_netname.text
self.sideband.config["connect_i2p_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_i2p_ifac_passphrase.text
self.sideband.config["connect_rnode"] = self.connectivity_screen.ids.connectivity_use_rnode.active
self.sideband.config["connect_rnode_ifac_netname"] = self.connectivity_screen.ids.connectivity_rnode_ifac_netname.text
self.sideband.config["connect_rnode_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_rnode_ifac_passphrase.text
self.sideband.config["connect_serial"] = self.connectivity_screen.ids.connectivity_use_serial.active
self.sideband.config["connect_serial_ifac_netname"] = self.connectivity_screen.ids.connectivity_serial_ifac_netname.text
self.sideband.config["connect_serial_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_serial_ifac_passphrase.text
self.sideband.config["connect_modem"] = self.connectivity_screen.ids.connectivity_use_modem.active
self.sideband.config["connect_modem_ifac_netname"] = self.connectivity_screen.ids.connectivity_modem_ifac_netname.text
self.sideband.config["connect_modem_ifac_passphrase"] = self.connectivity_screen.ids.connectivity_modem_ifac_passphrase.text
self.sideband.config["connect_ifmode_local"] = self.connectivity_screen.ids.connectivity_local_ifmode.text.lower()
self.sideband.config["connect_ifmode_tcp"] = self.connectivity_screen.ids.connectivity_tcp_ifmode.text.lower()
self.sideband.config["connect_ifmode_i2p"] = self.connectivity_screen.ids.connectivity_i2p_ifmode.text.lower()
self.sideband.config["connect_ifmode_rnode"] = self.connectivity_screen.ids.connectivity_rnode_ifmode.text.lower()
self.sideband.config["connect_ifmode_modem"] = self.connectivity_screen.ids.connectivity_modem_ifmode.text.lower()
self.sideband.config["connect_ifmode_serial"] = self.connectivity_screen.ids.connectivity_serial_ifmode.text.lower()
con_collapse_local(collapse=not self.connectivity_screen.ids.connectivity_use_local.active)
con_collapse_tcp(collapse=not self.connectivity_screen.ids.connectivity_use_tcp.active)
con_collapse_i2p(collapse=not self.connectivity_screen.ids.connectivity_use_i2p.active)
con_collapse_rnode(collapse=not self.connectivity_screen.ids.connectivity_use_rnode.active)
con_collapse_modem(collapse=not self.connectivity_screen.ids.connectivity_use_modem.active)
con_collapse_serial(collapse=not self.connectivity_screen.ids.connectivity_use_serial.active)
con_collapse_transport(collapse=not self.sideband.config["connect_transport"])
self.sideband.save_configuration()
if sender == self.connectivity_screen.ids.connectivity_enable_transport:
if sender.active:
def cb(dt):
yes_button = MDRectangleFlatButton(text="Understood",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
dialog = MDDialog(
title="Warning!",
text="You have enabled [i]Reticulum Transport[/i] for this device.\n\nFor normal operation, and for most users, this is [b]not[/b] necessary, and might even degrade your network performance.\n\nWhen Transport is enabled, your device will route traffic between all connected interfaces and for all reachable devices on the network.\n\nThis should only be done if you intend to keep your device in a fixed position and for it to remain available continously.\n\nIf this is not the case, or you don't understand any of this, turn off Transport.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
Clock.schedule_once(cb, 0.65)
def serial_connectivity_save(sender=None, event=None):
if sender.active:
self.connectivity_screen.ids.connectivity_use_rnode.unbind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_use_modem.unbind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_use_serial.unbind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_use_rnode.active = False
self.connectivity_screen.ids.connectivity_use_modem.active = False
self.connectivity_screen.ids.connectivity_use_serial.active = False
sender.active = True
self.connectivity_screen.ids.connectivity_use_rnode.bind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_use_modem.bind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_use_serial.bind(active=serial_connectivity_save)
save_connectivity(sender, event)
def focus_save(sender=None, event=None):
if not sender.focus:
save_connectivity(sender, event)
def ifmode_validate(sender=None, event=None):
if not sender.focus:
all_valid = True
iftypes = ["local", "tcp", "i2p", "rnode", "modem", "serial"]
for iftype in iftypes:
element = self.root.ids["connectivity_"+iftype+"_ifmode"]
modes = ["full", "gateway", "access point", "roaming", "boundary"]
value = element.text.lower()
if value in ["", "f"] or value.startswith("fu"):
value = "full"
elif value in ["g", "gw"] or value.startswith("ga"):
value = "gateway"
elif value in ["a", "ap", "a p", "accesspoint", "access point", "ac", "acc", "acce", "acces"] or value.startswith("access"):
value = "access point"
elif value in ["r"] or value.startswith("ro"):
value = "roaming"
elif value in ["b", "edge"] or value.startswith("bo"):
value = "boundary"
else:
value = "full"
if value in modes:
element.text = value.capitalize()
element.error = False
else:
element.error = True
all_valid = False
if all_valid:
save_connectivity(sender, event)
if RNS.vendor.platformutils.get_platform() == "android":
if not self.sideband.getpersistent("service.is_controlling_connectivity"):
info = "Sideband is connected via a shared Reticulum instance running on this system.\n\n"
info += "To configure connectivity, edit the relevant configuration file for the instance."
self.connectivity_screen.ids.connectivity_info.text = info
con_hide_settings()
else:
info = "By default, Sideband will try to discover and connect to any available Reticulum networks via active WiFi and/or Ethernet interfaces. If any Reticulum Transport Instances are found, Sideband will use these to connect to wider Reticulum networks. You can disable this behaviour if you don't want it.\n\n"
info += "You can also connect to a network via a remote or local Reticulum instance using TCP or I2P. [b]Please Note![/b] Connecting via I2P requires that you already have I2P running on your device, and that the SAM API is enabled.\n\n"
info += "For changes to connectivity to take effect, you must shut down and restart Sideband.\n"
self.connectivity_screen.ids.connectivity_info.text = info
self.connectivity_screen.ids.connectivity_use_local.active = self.sideband.config["connect_local"]
con_collapse_local(collapse=not self.connectivity_screen.ids.connectivity_use_local.active)
self.connectivity_screen.ids.connectivity_local_groupid.text = self.sideband.config["connect_local_groupid"]
self.connectivity_screen.ids.connectivity_local_ifac_netname.text = self.sideband.config["connect_local_ifac_netname"]
self.connectivity_screen.ids.connectivity_local_ifac_passphrase.text = self.sideband.config["connect_local_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_use_tcp.active = self.sideband.config["connect_tcp"]
con_collapse_tcp(collapse=not self.connectivity_screen.ids.connectivity_use_tcp.active)
self.connectivity_screen.ids.connectivity_tcp_host.text = self.sideband.config["connect_tcp_host"]
self.connectivity_screen.ids.connectivity_tcp_port.text = self.sideband.config["connect_tcp_port"]
self.connectivity_screen.ids.connectivity_tcp_ifac_netname.text = self.sideband.config["connect_tcp_ifac_netname"]
self.connectivity_screen.ids.connectivity_tcp_ifac_passphrase.text = self.sideband.config["connect_tcp_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_use_i2p.active = self.sideband.config["connect_i2p"]
con_collapse_i2p(collapse=not self.connectivity_screen.ids.connectivity_use_i2p.active)
self.connectivity_screen.ids.connectivity_i2p_b32.text = self.sideband.config["connect_i2p_b32"]
self.connectivity_screen.ids.connectivity_i2p_ifac_netname.text = self.sideband.config["connect_i2p_ifac_netname"]
self.connectivity_screen.ids.connectivity_i2p_ifac_passphrase.text = self.sideband.config["connect_i2p_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_use_rnode.active = self.sideband.config["connect_rnode"]
con_collapse_rnode(collapse=not self.connectivity_screen.ids.connectivity_use_rnode.active)
self.connectivity_screen.ids.connectivity_rnode_ifac_netname.text = self.sideband.config["connect_rnode_ifac_netname"]
self.connectivity_screen.ids.connectivity_rnode_ifac_passphrase.text = self.sideband.config["connect_rnode_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_use_modem.active = self.sideband.config["connect_modem"]
con_collapse_modem(collapse=not self.connectivity_screen.ids.connectivity_use_modem.active)
self.connectivity_screen.ids.connectivity_modem_ifac_netname.text = self.sideband.config["connect_modem_ifac_netname"]
self.connectivity_screen.ids.connectivity_modem_ifac_passphrase.text = self.sideband.config["connect_modem_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_use_serial.active = self.sideband.config["connect_serial"]
con_collapse_serial(collapse=not self.connectivity_screen.ids.connectivity_use_serial.active)
self.connectivity_screen.ids.connectivity_serial_ifac_netname.text = self.sideband.config["connect_serial_ifac_netname"]
self.connectivity_screen.ids.connectivity_serial_ifac_passphrase.text = self.sideband.config["connect_serial_ifac_passphrase"]
self.connectivity_screen.ids.connectivity_enable_transport.active = self.sideband.config["connect_transport"]
con_collapse_transport(collapse=not self.sideband.config["connect_transport"])
self.connectivity_screen.ids.connectivity_enable_transport.bind(active=save_connectivity)
self.connectivity_screen.ids.connectivity_local_ifmode.text = self.sideband.config["connect_ifmode_local"].capitalize()
self.connectivity_screen.ids.connectivity_tcp_ifmode.text = self.sideband.config["connect_ifmode_tcp"].capitalize()
self.connectivity_screen.ids.connectivity_i2p_ifmode.text = self.sideband.config["connect_ifmode_i2p"].capitalize()
self.connectivity_screen.ids.connectivity_rnode_ifmode.text = self.sideband.config["connect_ifmode_rnode"].capitalize()
self.connectivity_screen.ids.connectivity_modem_ifmode.text = self.sideband.config["connect_ifmode_modem"].capitalize()
self.connectivity_screen.ids.connectivity_serial_ifmode.text = self.sideband.config["connect_ifmode_serial"].capitalize()
self.connectivity_screen.ids.connectivity_use_local.bind(active=save_connectivity)
self.connectivity_screen.ids.connectivity_local_groupid.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_local_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_local_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_use_tcp.bind(active=save_connectivity)
self.connectivity_screen.ids.connectivity_tcp_host.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_tcp_port.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_tcp_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_tcp_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_use_i2p.bind(active=save_connectivity)
self.connectivity_screen.ids.connectivity_i2p_b32.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_i2p_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_i2p_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_use_rnode.bind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_rnode_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_rnode_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_use_modem.bind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_modem_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_modem_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_use_serial.bind(active=serial_connectivity_save)
self.connectivity_screen.ids.connectivity_serial_ifac_netname.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_serial_ifac_passphrase.bind(focus=focus_save)
self.connectivity_screen.ids.connectivity_local_ifmode.bind(focus=ifmode_validate)
self.connectivity_screen.ids.connectivity_tcp_ifmode.bind(focus=ifmode_validate)
self.connectivity_screen.ids.connectivity_i2p_ifmode.bind(focus=ifmode_validate)
self.connectivity_screen.ids.connectivity_rnode_ifmode.bind(focus=ifmode_validate)
self.connectivity_screen.ids.connectivity_modem_ifmode.bind(focus=ifmode_validate)
self.connectivity_screen.ids.connectivity_serial_ifmode.bind(focus=ifmode_validate)
else:
info = ""
if self.sideband.reticulum.is_connected_to_shared_instance:
info = "Sideband is connected via a shared Reticulum instance running on this system.\n\n"
info += "To get connectivity status, use the [b]rnstatus[/b] utility.\n\n"
info += "To configure connectivity, edit the configuration file located at:\n\n"
info += str(RNS.Reticulum.configpath)
else:
info = "Sideband is currently running a standalone or master Reticulum instance on this system.\n\n"
info += "To get connectivity status, use the [b]rnstatus[/b] utility.\n\n"
info += "To configure connectivity, edit the configuration file located at:\n\n"
info += str(RNS.Reticulum.configpath)
self.connectivity_screen.ids.connectivity_info.text = info
con_hide_settings()
self.connectivity_ready = True
def close_connectivity_action(self, sender=None):
self.open_conversations(direction="right")
def rpc_copy_action(self, sender=None):
c_yes_button = MDRectangleFlatButton(text="Yes",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
c_no_button = MDRectangleFlatButton(text="No, go back",font_size=dp(18))
c_dialog = MDDialog(text="[b]Caution![/b]\n\nA configuration line containing your Reticulum RPC key will be copied to the system clipboard.\n\nWhile the key can only be used by other programs running locally on this system, it is still recommended to take care in not exposing it to unwanted programs.\n\nAre you sure that you wish to proceed?", buttons=[ c_no_button, c_yes_button ])
def c_dl_no(s):
c_dialog.dismiss()
def c_dl_yes(s):
c_dialog.dismiss()
yes_button = MDRectangleFlatButton(text="OK")
dialog = MDDialog(text="The RPC configuration was copied to the system clipboard. Paste in into the [b][reticulum][/b] section of the relevant Reticulum configuration file to allow access to this instance.", buttons=[ yes_button ])
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
rpc_string = "rpc_key = "+RNS.hexrep(self.sideband.reticulum.rpc_key, delimit=False)
Clipboard.copy(rpc_string)
dialog.open()
c_yes_button.bind(on_release=c_dl_yes)
c_no_button.bind(on_release=c_dl_no)
c_dialog.open()
### Repository screen
######################################
def repository_action(self, sender=None, direction="left"):
if self.repository_ready:
self.repository_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.repository_init()
def o(dt):
self.repository_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def repository_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.repository_screen.ids.repository_update.text = ""
self.root.ids.screen_manager.current = "repository_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def repository_link_action(self, sender=None, event=None):
if self.reposository_url != None:
def lj():
webbrowser.open(self.reposository_url)
threading.Thread(target=lj, daemon=True).start()
def repository_update_info(self, sender=None):
info = "Sideband includes a small repository of useful software and guides related to the Sideband and Reticulum ecosystem. You can start this repository to allow other people on your local network to download software and information directly from this device, without needing an Internet connection.\n\n"
info += "If you want to share the Sideband application itself via the repository server, you must first download it into the local repository, using the \"Update Content\" button below.\n\n"
info += "To make the repository available on your local network, simply start it below, and it will become browsable on a local IP address for anyone connected to the same WiFi or wired network.\n\n"
if self.sideband.webshare_server != None:
if RNS.vendor.platformutils.is_android():
def getIP():
adrs = []
try:
from jnius import autoclass
import ipaddress
mActivity = autoclass('org.kivy.android.PythonActivity').mActivity
SystemProperties = autoclass('android.os.SystemProperties')
Context = autoclass('android.content.Context')
connectivity_manager = mActivity.getSystemService(Context.CONNECTIVITY_SERVICE)
ns = connectivity_manager.getAllNetworks()
if not ns == None and len(ns) > 0:
for n in ns:
lps = connectivity_manager.getLinkProperties(n)
las = lps.getLinkAddresses()
for la in las:
ina = la.getAddress()
ha = ina.getHostAddress()
if not ina.isLinkLocalAddress():
adrs.append(ha)
except Exception as e:
RNS.log("Error while getting repository IP address: "+str(e), RNS.LOG_ERROR)
return None
return adrs
ips = getIP()
if ips == None or len(ips) == 0:
info += "The repository server is running, but the local device IP address could not be determined.\n\nYou can access the repository by pointing a browser to: http://DEVICE_IP:4444/"
self.reposository_url = None
else:
ipstr = ""
for ip in ips:
ipstr += "http://"+str(ip)+":4444/\n"
self.reposository_url = ipstr
ms = "" if len(ips) == 1 else "es"
info += "The repository server is running at the following address"+ms+":\n [u][ref=link]"+ipstr+"[/ref][u]"
self.repository_screen.ids.repository_info.bind(on_ref_press=self.repository_link_action)
self.repository_screen.ids.repository_enable_button.disabled = True
self.repository_screen.ids.repository_disable_button.disabled = False
else:
self.repository_screen.ids.repository_enable_button.disabled = False
self.repository_screen.ids.repository_disable_button.disabled = True
info += "\n"
self.repository_screen.ids.repository_info.text = info
def repository_start_action(self, sender=None):
self.sideband.start_webshare()
Clock.schedule_once(self.repository_update_info, 1.0)
def repository_stop_action(self, sender=None):
self.reposository_url = None
self.sideband.stop_webshare()
Clock.schedule_once(self.repository_update_info, 0.75)
def repository_download_action(self, sender=None):
def update_job(sender=None):
try:
import requests
# Get release info
apk_version = None
apk_url = None
pkgname = None
try:
release_url = "https://api.github.com/repos/markqvist/sideband/releases"
with requests.get(release_url) as response:
releases = response.json()
release = releases[0]
assets = release["assets"]
for asset in assets:
if asset["name"].lower().endswith(".apk"):
apk_url = asset["browser_download_url"]
pkgname = asset["name"]
apk_version = release["tag_name"]
RNS.log(f"Found version {apk_version} artefact {pkgname} at {apk_url}")
except Exception as e:
self.repository_screen.ids.repository_update.text = f"Downloading release info failed with the error:\n"+str(e)
return
self.repository_screen.ids.repository_update.text = "Downloading: "+str(apk_url)
with requests.get(apk_url, stream=True) as response:
with open("./dl_tmp", "wb") as tmp_file:
cs = 32*1024
tds = 0
for chunk in response.iter_content(chunk_size=cs):
tmp_file.write(chunk)
tds += cs
self.repository_screen.ids.repository_update.text = "Downloaded "+RNS.prettysize(tds)+" of "+str(pkgname)
os.rename("./dl_tmp", f"./share/pkg/{pkgname}")
self.repository_screen.ids.repository_update.text = f"Added {pkgname} to the repository!"
except Exception as e:
self.repository_screen.ids.repository_update.text = f"Downloading contents failed with the error:\n"+str(e)
self.repository_screen.ids.repository_update.text = "Starting package download..."
def start_update_job(sender=None):
threading.Thread(target=update_job, daemon=True).start()
Clock.schedule_once(start_update_job, 0.5)
def repository_init(self, sender=None):
if not self.repository_ready:
if not self.root.ids.screen_manager.has_screen("repository_screen"):
self.repository_screen = Builder.load_string(layout_repository_screen)
self.repository_screen.app = self
self.root.ids.screen_manager.add_widget(self.repository_screen)
self.repository_screen.ids.repository_scrollview.effect_cls = ScrollEffect
self.repository_update_info()
if not RNS.vendor.platformutils.is_android():
self.widget_hide(self.repository_screen.ids.repository_enable_button)
self.widget_hide(self.repository_screen.ids.repository_disable_button)
self.widget_hide(self.repository_screen.ids.repository_download_button)
self.repository_screen.ids.repository_info.text = "\nThe [b]Repository Webserver[/b] feature is currently only available on mobile devices."
self.repository_ready = True
def close_repository_action(self, sender=None):
self.open_conversations(direction="right")
### Hardware screen
######################################
def hardware_action(self, sender=None, direction="left"):
if self.hardware_ready:
self.hardware_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.hardware_init()
def o(dt):
self.hardware_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def hardware_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.hardware_init()
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "hardware_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def close_sub_hardware_action(self, sender=None):
self.hardware_action(direction="right")
def hardware_init(self, sender=None):
if not self.hardware_ready:
if not self.root.ids.screen_manager.has_screen("hardware_screen"):
self.hardware_screen = Builder.load_string(layout_hardware_screen)
self.hardware_screen.app = self
self.root.ids.screen_manager.add_widget(self.hardware_screen)
self.hardware_screen.ids.hardware_scrollview.effect_cls = ScrollEffect
def con_hide_settings():
self.widget_hide(self.hardware_screen.ids.hardware_rnode_button)
self.widget_hide(self.hardware_screen.ids.hardware_modem_button)
self.widget_hide(self.hardware_screen.ids.hardware_serial_button)
if RNS.vendor.platformutils.get_platform() == "android":
if not self.sideband.getpersistent("service.is_controlling_connectivity"):
info = "Sideband is connected via a shared Reticulum instance running on this system.\n\n"
info += "To configure hardware parameters, edit the relevant configuration file for the instance."
self.hardware_screen.ids.hardware_info.text = info
con_hide_settings()
else:
info = "When using external hardware for communicating, you may configure various parameters, such as channel settings, modulation schemes, interface speeds and access parameters. You can set up these parameters per device type, and Sideband will apply the configuration when opening a device of that type.\n\n"
info += "Hardware configurations can also be exported or imported as [i]config motes[/i], which are self-contained plaintext strings that are easy to share with others. When importing a config mote, Sideband will automatically set all relevant parameters as specified within it.\n\n"
info += "For changes to hardware parameters to take effect, you must shut down and restart Sideband.\n"
self.hardware_screen.ids.hardware_info.text = info
else:
info = ""
if self.sideband.reticulum.is_connected_to_shared_instance:
info = "Sideband is connected via a shared Reticulum instance running on this system.\n\n"
info += "To configure hardware parameters, edit the configuration file located at:\n\n"
info += str(RNS.Reticulum.configpath)
else:
info = "Sideband is currently running a standalone or master Reticulum instance on this system.\n\n"
info += "To configure hardware parameters, edit the configuration file located at:\n\n"
info += str(RNS.Reticulum.configpath)
self.hardware_screen.ids.hardware_info.text = info
con_hide_settings()
self.hardware_ready = True
def close_hardware_action(self, sender=None):
self.open_conversations(direction="right")
## RNode hardware screen
def hardware_rnode_action(self, sender=None, direction="left"):
if self.hardware_rnode_ready:
self.hardware_rnode_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.hardware_rnode_init()
def o(dt):
self.hardware_rnode_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def hardware_rnode_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.screen_manager.current = "hardware_rnode_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def hardware_rnode_save(self):
try:
self.sideband.config["hw_rnode_frequency"] = int(float(self.hardware_rnode_screen.ids.hardware_rnode_frequency.text)*1000000)
except:
pass
try:
self.sideband.config["hw_rnode_bandwidth"] = int(float(self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.text)*1000)
except:
pass
try:
self.sideband.config["hw_rnode_tx_power"] = int(self.hardware_rnode_screen.ids.hardware_rnode_txpower.text)
except:
pass
try:
self.sideband.config["hw_rnode_spreading_factor"] = int(self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.text)
except:
pass
try:
self.sideband.config["hw_rnode_coding_rate"] = int(self.hardware_rnode_screen.ids.hardware_rnode_codingrate.text)
except:
pass
try:
self.sideband.config["hw_rnode_atl_short"] = float(self.hardware_rnode_screen.ids.hardware_rnode_atl_short.text)
except:
self.sideband.config["hw_rnode_atl_short"] = None
try:
self.sideband.config["hw_rnode_atl_long"] = float(self.hardware_rnode_screen.ids.hardware_rnode_atl_long.text)
except:
self.sideband.config["hw_rnode_atl_long"] = None
if self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text == "":
self.sideband.config["hw_rnode_beaconinterval"] = None
else:
try:
self.sideband.config["hw_rnode_beaconinterval"] = int(self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text)
except:
pass
if self.hardware_rnode_screen.ids.hardware_rnode_beacondata.text == "":
self.sideband.config["hw_rnode_beacondata"] = None
else:
self.sideband.config["hw_rnode_beacondata"] = self.hardware_rnode_screen.ids.hardware_rnode_beacondata.text
if self.hardware_rnode_screen.ids.hardware_rnode_bt_device.text == "":
self.sideband.config["hw_rnode_bt_device"] = None
else:
self.sideband.config["hw_rnode_bt_device"] = self.hardware_rnode_screen.ids.hardware_rnode_bt_device.text
self.sideband.save_configuration()
def hardware_rnode_bt_on_action(self, sender=None):
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = True
def re_enable():
time.sleep(2)
while self.sideband.getstate("executing.bt_on"):
time.sleep(1)
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = False
threading.Thread(target=re_enable, daemon=True).start()
self.sideband.setstate("wants.bt_on", True)
def hardware_rnode_bt_off_action(self, sender=None):
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = True
def re_enable():
time.sleep(2)
while self.sideband.getstate("executing.bt_off"):
time.sleep(1)
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = False
threading.Thread(target=re_enable, daemon=True).start()
self.sideband.setstate("wants.bt_off", True)
def hardware_rnode_bt_pair_action(self, sender=None):
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = True
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = True
def re_enable():
time.sleep(2)
while self.sideband.getstate("executing.bt_pair"):
time.sleep(1)
self.hardware_rnode_screen.ids.hardware_rnode_bt_off_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_pair_button.disabled = False
self.hardware_rnode_screen.ids.hardware_rnode_bt_on_button.disabled = False
threading.Thread(target=re_enable, daemon=True).start()
self.sideband.setstate("wants.bt_pair", True)
def hardware_rnode_bt_toggle_action(self, sender=None, event=None):
if sender.active:
self.sideband.config["hw_rnode_bluetooth"] = True
self.request_bluetooth_permissions()
else:
self.sideband.config["hw_rnode_bluetooth"] = False
self.sideband.save_configuration()
def hardware_rnode_framebuffer_toggle_action(self, sender=None, event=None):
if sender.active:
self.sideband.config["hw_rnode_enable_framebuffer"] = True
else:
self.sideband.config["hw_rnode_enable_framebuffer"] = False
self.sideband.save_configuration()
def hardware_rnode_init(self, sender=None):
if not self.hardware_rnode_ready:
if not self.root.ids.screen_manager.has_screen("hardware_rnode_screen"):
self.hardware_rnode_screen = Builder.load_string(layout_hardware_rnode_screen)
self.hardware_rnode_screen.app = self
self.root.ids.screen_manager.add_widget(self.hardware_rnode_screen)
self.hardware_rnode_screen.ids.hardware_rnode_scrollview.effect_cls = ScrollEffect
def save_connectivity(sender=None, event=None):
if self.hardware_rnode_validate():
self.hardware_rnode_save()
def focus_save(sender=None, event=None):
if sender != None:
if not sender.focus:
save_connectivity(sender=sender)
if self.sideband.config["hw_rnode_frequency"] != None:
t_freq = str(self.sideband.config["hw_rnode_frequency"]/1000000.0)
else:
t_freq = ""
if self.sideband.config["hw_rnode_bandwidth"] != None:
t_bw = str(self.sideband.config["hw_rnode_bandwidth"]/1000.0)
else:
t_bw = str(62.5)
if self.sideband.config["hw_rnode_tx_power"] != None:
t_p = str(self.sideband.config["hw_rnode_tx_power"])
else:
t_p = str(0)
if self.sideband.config["hw_rnode_spreading_factor"] != None:
t_sf = str(self.sideband.config["hw_rnode_spreading_factor"])
else:
t_sf = str(8)
if self.sideband.config["hw_rnode_coding_rate"] != None:
t_cr = str(self.sideband.config["hw_rnode_coding_rate"])
else:
t_cr = str(6)
if self.sideband.config["hw_rnode_beaconinterval"] != None:
t_bi = str(self.sideband.config["hw_rnode_beaconinterval"])
else:
t_bi = ""
if self.sideband.config["hw_rnode_beacondata"] != None:
t_bd = str(self.sideband.config["hw_rnode_beacondata"])
else:
t_bd = ""
if self.sideband.config["hw_rnode_bt_device"] != None:
t_btd = str(self.sideband.config["hw_rnode_bt_device"])
else:
t_btd = ""
if self.sideband.config["hw_rnode_atl_short"] != None:
t_ats = str(self.sideband.config["hw_rnode_atl_short"])
else:
t_ats = ""
if self.sideband.config["hw_rnode_atl_long"] != None:
t_atl = str(self.sideband.config["hw_rnode_atl_long"])
else:
t_atl = ""
self.hardware_rnode_screen.ids.hardware_rnode_bluetooth.active = self.sideband.config["hw_rnode_bluetooth"]
self.hardware_rnode_screen.ids.hardware_rnode_framebuffer.active = self.sideband.config["hw_rnode_enable_framebuffer"]
self.hardware_rnode_screen.ids.hardware_rnode_frequency.text = t_freq
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.text = t_bw
self.hardware_rnode_screen.ids.hardware_rnode_txpower.text = t_p
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.text = t_sf
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.text = t_cr
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text = t_bi
self.hardware_rnode_screen.ids.hardware_rnode_beacondata.text = t_bd
self.hardware_rnode_screen.ids.hardware_rnode_bt_device.text = t_btd
self.hardware_rnode_screen.ids.hardware_rnode_atl_short.text = t_ats
self.hardware_rnode_screen.ids.hardware_rnode_atl_long.text = t_atl
self.hardware_rnode_screen.ids.hardware_rnode_frequency.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_txpower.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_beacondata.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_bt_device.bind(focus=focus_save)
self.hardware_rnode_screen.ids.hardware_rnode_frequency.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_txpower.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_beacondata.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_atl_short.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_atl_long.bind(on_text_validate=save_connectivity)
self.hardware_rnode_screen.ids.hardware_rnode_bluetooth.bind(active=self.hardware_rnode_bt_toggle_action)
self.hardware_rnode_screen.ids.hardware_rnode_framebuffer.bind(active=self.hardware_rnode_framebuffer_toggle_action)
self.hardware_rnode_ready = True
def hardware_rnode_validate(self, sender=None):
valid = True
try:
val = float(self.hardware_rnode_screen.ids.hardware_rnode_frequency.text)
if not val > 0:
raise ValueError("Invalid frequency")
self.hardware_rnode_screen.ids.hardware_rnode_frequency.error = False
self.hardware_rnode_screen.ids.hardware_rnode_frequency.text = str(val)
except:
self.hardware_rnode_screen.ids.hardware_rnode_frequency.error = True
valid = False
try:
valid_vals = [7.8, 10.4, 15.6, 20.8, 31.25, 41.7, 62.5, 125, 250, 500]
val = float(self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.text)
if not val in valid_vals:
raise ValueError("Invalid bandwidth")
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.error = False
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.text = str(val)
except:
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.error = True
valid = False
try:
val = int(self.hardware_rnode_screen.ids.hardware_rnode_txpower.text)
if not val >= 0:
raise ValueError("Invalid TX power")
self.hardware_rnode_screen.ids.hardware_rnode_txpower.error = False
self.hardware_rnode_screen.ids.hardware_rnode_txpower.text = str(val)
except:
self.hardware_rnode_screen.ids.hardware_rnode_txpower.error = True
valid = False
try:
val = int(self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.text)
if val < 7 or val > 12:
raise ValueError("Invalid sf")
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.error = False
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.text = str(val)
except:
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.error = True
valid = False
try:
val = int(self.hardware_rnode_screen.ids.hardware_rnode_codingrate.text)
if val < 5 or val > 8:
raise ValueError("Invalid cr")
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.error = False
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.text = str(val)
except:
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.error = True
valid = False
try:
if self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text != "":
val = int(self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text)
if val < 10:
raise ValueError("Invalid bi")
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text = str(val)
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.error = False
except:
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text = ""
valid = False
return valid
def hardware_rnode_import(self, sender=None):
mote = None
try:
mote = Clipboard.paste()
except Exception as e:
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Import Failed",
text="Could not read data from your clipboard, please check your system permissions.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
try:
config = msgpack.unpackb(base64.b32decode(mote))
self.hardware_rnode_screen.ids.hardware_rnode_frequency.text = str(config["f"]/1000000.0)
self.hardware_rnode_screen.ids.hardware_rnode_bandwidth.text = str(config["b"]/1000.0)
self.hardware_rnode_screen.ids.hardware_rnode_txpower.text = str(config["t"])
self.hardware_rnode_screen.ids.hardware_rnode_spreadingfactor.text = str(config["s"])
self.hardware_rnode_screen.ids.hardware_rnode_codingrate.text = str(config["c"])
if "n" in config and config["n"] != None:
ifn = str(config["n"])
else:
ifn = ""
if "p" in config and config["p"] != None:
ifp = str(config["p"])
else:
ifp = ""
self.connectivity_screen.ids.connectivity_rnode_ifac_netname.text = ifn
self.sideband.config["connect_rnode_ifac_netname"] = ifn
self.connectivity_screen.ids.connectivity_rnode_ifac_passphrase.text = ifp
self.sideband.config["connect_rnode_ifac_passphrase"] = ifp
if config["i"] != None:
ti = str(config["i"])
else:
ti = ""
self.hardware_rnode_screen.ids.hardware_rnode_beaconinterval.text = ti
if config["d"] != None:
td = str(config["d"])
else:
td = ""
self.hardware_rnode_screen.ids.hardware_rnode_beacondata.text = td
if self.hardware_rnode_validate():
self.hardware_rnode_save()
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Configuration Imported",
text="The config mote was imported and saved as your active configuration.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
else:
raise ValueError("Invalid mote")
except Exception as e:
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Import Failed",
text="The read data did not contain a valid config mote. If any data was decoded, you may try to correct it by editing the relevant fields. The reported error was:\n\n"+str(e),
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
def hardware_rnode_export(self, sender=None):
mote = None
try:
mote = base64.b32encode(msgpack.packb({
"f": self.sideband.config["hw_rnode_frequency"],
"b": self.sideband.config["hw_rnode_bandwidth"],
"t": self.sideband.config["hw_rnode_tx_power"],
"s": self.sideband.config["hw_rnode_spreading_factor"],
"c": self.sideband.config["hw_rnode_coding_rate"],
"i": self.sideband.config["hw_rnode_beaconinterval"],
"d": self.sideband.config["hw_rnode_beacondata"],
"n": self.sideband.config["connect_rnode_ifac_netname"],
"p": self.sideband.config["connect_rnode_ifac_passphrase"],
}))
except Exception as e:
pass
if mote != None:
Clipboard.copy(mote)
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Configuration Exported",
text="The config mote was created and copied to your clipboard.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
else:
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
title="Export Failed",
text="The config mote could not be created, please check your settings.",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
## Modem hardware screen
def hardware_modem_action(self, sender=None, direction="left"):
if self.hardware_modem_ready:
self.hardware_modem_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.hardware_modem_init()
def o(dt):
self.hardware_modem_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def hardware_modem_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.hardware_modem_init()
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.screen_manager.current = "hardware_modem_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def hardware_modem_init(self, sender=None):
if not self.hardware_modem_ready:
if not self.root.ids.screen_manager.has_screen("hardware_modem_screen"):
self.hardware_modem_screen = Builder.load_string(layout_hardware_modem_screen)
self.hardware_modem_screen.app = self
self.root.ids.screen_manager.add_widget(self.hardware_modem_screen)
self.hardware_modem_screen.ids.hardware_modem_scrollview.effect_cls = ScrollEffect
def save_connectivity(sender=None, event=None):
if self.hardware_modem_validate():
self.hardware_modem_save()
def focus_save(sender=None, event=None):
if sender != None:
if not sender.focus:
save_connectivity(sender=sender)
if self.sideband.config["hw_modem_baudrate"] != None:
t_b = str(self.sideband.config["hw_modem_baudrate"])
else:
t_b = ""
if self.sideband.config["hw_modem_databits"] != None:
t_db = str(self.sideband.config["hw_modem_databits"])
else:
t_db = ""
if self.sideband.config["hw_modem_parity"] != None:
t_p = str(self.sideband.config["hw_modem_parity"])
else:
t_p = ""
if self.sideband.config["hw_modem_stopbits"] != None:
t_sb = str(self.sideband.config["hw_modem_stopbits"])
else:
t_sb = ""
if self.sideband.config["hw_modem_preamble"] != None:
t_pa = str(self.sideband.config["hw_modem_preamble"])
else:
t_pa = ""
if self.sideband.config["hw_modem_tail"] != None:
t_t = str(self.sideband.config["hw_modem_tail"])
else:
t_t = ""
if self.sideband.config["hw_modem_persistence"] != None:
t_ps = str(self.sideband.config["hw_modem_persistence"])
else:
t_ps = ""
if self.sideband.config["hw_modem_slottime"] != None:
t_st = str(self.sideband.config["hw_modem_slottime"])
else:
t_st = ""
if self.sideband.config["hw_modem_beaconinterval"] != None:
t_bi = str(self.sideband.config["hw_modem_beaconinterval"])
else:
t_bi = ""
if self.sideband.config["hw_modem_beacondata"] != None:
t_bd = str(self.sideband.config["hw_modem_beacondata"])
else:
t_bd = ""
self.hardware_modem_screen.ids.hardware_modem_baudrate.text = t_b
self.hardware_modem_screen.ids.hardware_modem_databits.text = t_db
self.hardware_modem_screen.ids.hardware_modem_parity.text = t_p
self.hardware_modem_screen.ids.hardware_modem_stopbits.text = t_sb
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text = t_bi
self.hardware_modem_screen.ids.hardware_modem_beacondata.text = t_bd
self.hardware_modem_screen.ids.hardware_modem_preamble.text = t_pa
self.hardware_modem_screen.ids.hardware_modem_tail.text = t_t
self.hardware_modem_screen.ids.hardware_modem_persistence.text = t_ps
self.hardware_modem_screen.ids.hardware_modem_slottime.text = t_st
self.hardware_modem_screen.ids.hardware_modem_baudrate.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_databits.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_parity.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_stopbits.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_beacondata.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_preamble.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_tail.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_persistence.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_slottime.bind(focus=focus_save)
self.hardware_modem_screen.ids.hardware_modem_baudrate.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_databits.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_parity.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_stopbits.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_beacondata.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_preamble.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_tail.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_persistence.bind(on_text_validate=save_connectivity)
self.hardware_modem_screen.ids.hardware_modem_slottime.bind(on_text_validate=save_connectivity)
self.hardware_modem_ready = True
def hardware_modem_save(self):
self.sideband.config["hw_modem_baudrate"] = int(self.hardware_modem_screen.ids.hardware_modem_baudrate.text)
self.sideband.config["hw_modem_databits"] = int(self.hardware_modem_screen.ids.hardware_modem_databits.text)
self.sideband.config["hw_modem_parity"] = self.hardware_modem_screen.ids.hardware_modem_parity.text
self.sideband.config["hw_modem_stopbits"] = int(self.hardware_modem_screen.ids.hardware_modem_stopbits.text)
self.sideband.config["hw_modem_preamble"] = int(self.hardware_modem_screen.ids.hardware_modem_preamble.text)
self.sideband.config["hw_modem_tail"] = int(self.hardware_modem_screen.ids.hardware_modem_tail.text)
self.sideband.config["hw_modem_persistence"] = int(self.hardware_modem_screen.ids.hardware_modem_persistence.text)
self.sideband.config["hw_modem_slottime"] = int(self.hardware_modem_screen.ids.hardware_modem_slottime.text)
if self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text == "":
self.sideband.config["hw_modem_beaconinterval"] = None
else:
self.sideband.config["hw_modem_beaconinterval"] = int(self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text)
if self.hardware_modem_screen.ids.hardware_modem_beacondata.text == "":
self.sideband.config["hw_modem_beacondata"] = None
else:
self.sideband.config["hw_modem_beacondata"] = self.hardware_modem_screen.ids.hardware_modem_beacondata.text
self.sideband.save_configuration()
def hardware_modem_validate(self, sender=None):
valid = True
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_baudrate.text)
if not val > 0:
raise ValueError("Invalid baudrate")
self.hardware_modem_screen.ids.hardware_modem_baudrate.error = False
self.hardware_modem_screen.ids.hardware_modem_baudrate.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_baudrate.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_databits.text)
if not val > 0:
raise ValueError("Invalid databits")
self.hardware_modem_screen.ids.hardware_modem_databits.error = False
self.hardware_modem_screen.ids.hardware_modem_databits.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_databits.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_stopbits.text)
if not val > 0:
raise ValueError("Invalid stopbits")
self.hardware_modem_screen.ids.hardware_modem_stopbits.error = False
self.hardware_modem_screen.ids.hardware_modem_stopbits.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_stopbits.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_preamble.text)
if not (val >= 0 and val <= 1000):
raise ValueError("Invalid preamble")
self.hardware_modem_screen.ids.hardware_modem_preamble.error = False
self.hardware_modem_screen.ids.hardware_modem_preamble.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_preamble.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_tail.text)
if not (val > 0 and val <= 500):
raise ValueError("Invalid tail")
self.hardware_modem_screen.ids.hardware_modem_tail.error = False
self.hardware_modem_screen.ids.hardware_modem_tail.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_tail.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_slottime.text)
if not (val > 0 and val <= 500):
raise ValueError("Invalid slottime")
self.hardware_modem_screen.ids.hardware_modem_slottime.error = False
self.hardware_modem_screen.ids.hardware_modem_slottime.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_slottime.error = True
valid = False
try:
val = int(self.hardware_modem_screen.ids.hardware_modem_persistence.text)
if not (val > 0 and val <= 255):
raise ValueError("Invalid persistence")
self.hardware_modem_screen.ids.hardware_modem_persistence.error = False
self.hardware_modem_screen.ids.hardware_modem_persistence.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_persistence.error = True
valid = False
try:
val = self.hardware_modem_screen.ids.hardware_modem_parity.text
nval = val.lower()
if nval in ["e", "ev", "eve", "even"]:
val = "even"
if nval in ["o", "od", "odd"]:
val = "odd"
if nval in ["n", "no", "non", "none", "not", "null", "off"]:
val = "none"
if not val in ["even", "odd", "none"]:
raise ValueError("Invalid parity")
self.hardware_modem_screen.ids.hardware_modem_parity.error = False
self.hardware_modem_screen.ids.hardware_modem_parity.text = str(val)
except:
self.hardware_modem_screen.ids.hardware_modem_parity.error = True
valid = False
try:
if self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text != "":
val = int(self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text)
if val < 10:
raise ValueError("Invalid bi")
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text = str(val)
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.error = False
except:
self.hardware_modem_screen.ids.hardware_modem_beaconinterval.text = ""
valid = False
return valid
## Serial hardware screen
def hardware_serial_action(self, sender=None, direction="left"):
if self.hardware_serial_ready:
self.hardware_serial_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.hardware_serial_init()
def o(dt):
self.hardware_serial_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def hardware_serial_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.screen_manager.current = "hardware_serial_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def hardware_serial_init(self, sender=None):
if not self.hardware_serial_ready:
if not self.root.ids.screen_manager.has_screen("hardware_serial_screen"):
self.hardware_serial_screen = Builder.load_string(layout_hardware_serial_screen)
self.hardware_serial_screen.app = self
self.root.ids.screen_manager.add_widget(self.hardware_serial_screen)
self.hardware_serial_screen.ids.hardware_serial_scrollview.effect_cls = ScrollEffect
def save_connectivity(sender=None, event=None):
if self.hardware_serial_validate():
self.hardware_serial_save()
def focus_save(sender=None, event=None):
if sender != None:
if not sender.focus:
save_connectivity(sender=sender)
if self.sideband.config["hw_serial_baudrate"] != None:
t_b = str(self.sideband.config["hw_serial_baudrate"])
else:
t_b = ""
if self.sideband.config["hw_serial_databits"] != None:
t_db = str(self.sideband.config["hw_serial_databits"])
else:
t_db = ""
if self.sideband.config["hw_serial_parity"] != None:
t_p = str(self.sideband.config["hw_serial_parity"])
else:
t_p = ""
if self.sideband.config["hw_serial_stopbits"] != None:
t_sb = str(self.sideband.config["hw_serial_stopbits"])
else:
t_sb = ""
self.hardware_serial_screen.ids.hardware_serial_baudrate.text = t_b
self.hardware_serial_screen.ids.hardware_serial_databits.text = t_db
self.hardware_serial_screen.ids.hardware_serial_parity.text = t_p
self.hardware_serial_screen.ids.hardware_serial_stopbits.text = t_sb
self.hardware_serial_screen.ids.hardware_serial_baudrate.bind(focus=focus_save)
self.hardware_serial_screen.ids.hardware_serial_databits.bind(focus=focus_save)
self.hardware_serial_screen.ids.hardware_serial_parity.bind(focus=focus_save)
self.hardware_serial_screen.ids.hardware_serial_stopbits.bind(focus=focus_save)
self.hardware_serial_screen.ids.hardware_serial_baudrate.bind(on_text_validate=save_connectivity)
self.hardware_serial_screen.ids.hardware_serial_databits.bind(on_text_validate=save_connectivity)
self.hardware_serial_screen.ids.hardware_serial_parity.bind(on_text_validate=save_connectivity)
self.hardware_serial_screen.ids.hardware_serial_stopbits.bind(on_text_validate=save_connectivity)
self.hardware_serial_ready = True
def hardware_serial_validate(self, sender=None):
valid = True
try:
val = int(self.hardware_serial_screen.ids.hardware_serial_baudrate.text)
if not val > 0:
raise ValueError("Invalid baudrate")
self.hardware_serial_screen.ids.hardware_serial_baudrate.error = False
self.hardware_serial_screen.ids.hardware_serial_baudrate.text = str(val)
except:
self.hardware_serial_screen.ids.hardware_serial_baudrate.error = True
valid = False
try:
val = int(self.hardware_serial_screen.ids.hardware_serial_databits.text)
if not val > 0:
raise ValueError("Invalid databits")
self.hardware_serial_screen.ids.hardware_serial_databits.error = False
self.hardware_serial_screen.ids.hardware_serial_databits.text = str(val)
except:
self.hardware_serial_screen.ids.hardware_serial_databits.error = True
valid = False
try:
val = int(self.hardware_serial_screen.ids.hardware_serial_stopbits.text)
if not val > 0:
raise ValueError("Invalid stopbits")
self.hardware_serial_screen.ids.hardware_serial_stopbits.error = False
self.hardware_serial_screen.ids.hardware_serial_stopbits.text = str(val)
except:
self.hardware_serial_screen.ids.hardware_serial_stopbits.error = True
valid = False
try:
val = self.hardware_serial_screen.ids.hardware_serial_parity.text
nval = val.lower()
if nval in ["e", "ev", "eve", "even"]:
val = "even"
if nval in ["o", "od", "odd"]:
val = "odd"
if nval in ["n", "no", "non", "none", "not", "null", "off"]:
val = "none"
if not val in ["even", "odd", "none"]:
raise ValueError("Invalid parity")
self.hardware_serial_screen.ids.hardware_serial_parity.error = False
self.hardware_serial_screen.ids.hardware_serial_parity.text = str(val)
except:
self.hardware_serial_screen.ids.hardware_serial_parity.error = True
valid = False
return valid
def hardware_serial_save(self):
self.sideband.config["hw_serial_baudrate"] = int(self.hardware_serial_screen.ids.hardware_serial_baudrate.text)
self.sideband.config["hw_serial_databits"] = int(self.hardware_serial_screen.ids.hardware_serial_databits.text)
self.sideband.config["hw_serial_parity"] = self.hardware_serial_screen.ids.hardware_serial_parity.text
self.sideband.config["hw_serial_stopbits"] = int(self.hardware_serial_screen.ids.hardware_serial_stopbits.text)
self.sideband.save_configuration()
### Announce Stream screen
######################################
def init_announces_view(self, sender=None):
if not self.announces_view:
self.announces_view = Announces(self)
self.sideband.setstate("app.flags.new_announces", True)
for child in self.announces_view.ids.announces_scrollview.children:
self.announces_view.ids.announces_scrollview.remove_widget(child)
self.announces_view.ids.announces_scrollview.effect_cls = ScrollEffect
self.announces_view.ids.announces_scrollview.add_widget(self.announces_view.get_widget())
self.announces_view.update()
def announces_action(self, sender=None, direction="left"):
if self.announces_view:
self.announces_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.init_announces_view()
def o(dt):
self.announces_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def announces_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.nav_drawer.set_state("closed")
if self.sideband.getstate("app.flags.new_announces"):
self.announces_view.update()
self.root.ids.screen_manager.current = "announces_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def close_announces_action(self, sender=None):
self.open_conversations(direction="right")
def announce_filter_action(self, sender=None):
pass
def screen_transition_complete(self, sender):
if self.root.ids.screen_manager.current == "announces_screen":
pass
if self.root.ids.screen_manager.current == "conversations_screen":
pass
### Keys screen
######################################
def keys_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("keys_screen"):
self.keys_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.keys_init()
def o(dt):
self.keys_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def keys_init(self):
if not self.root.ids.screen_manager.has_screen("keys_screen"):
self.keys_screen = Builder.load_string(layout_keys_screen)
self.keys_screen.app = self
self.root.ids.screen_manager.add_widget(self.keys_screen)
self.bind_clipboard_actions(self.keys_screen.ids)
self.keys_screen.ids.keys_scrollview.effect_cls = ScrollEffect
info = "Your primary encryption keys are stored in a Reticulum Identity within the Sideband app. If you want to backup this Identity for later use on this or another device, you can export it as a plain text blob, with the key data encoded in Base32 format. This will allow you to restore your address in Sideband or other LXMF clients at a later point.\n\n[b]Warning![/b] Anyone that gets access to the key data will be able to control your LXMF address, impersonate you, and read your messages. In is [b]extremely important[/b] that you keep the Identity data secure if you export it.\n\nBefore displaying or exporting your Identity data, make sure that no machine or person in your vicinity is able to see, copy or record your device screen or similar."
if not RNS.vendor.platformutils.get_platform() == "android":
self.widget_hide(self.keys_screen.ids.keys_share)
self.keys_screen.ids.keys_info.text = info
def keys_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = "left"
self.root.ids.screen_manager.current = "keys_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def close_keys_action(self, sender=None):
self.open_conversations(direction="right")
def identity_display_action(self, sender=None):
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(
text="Your Identity key, in base32 format is as follows:\n\n[b]"+str(base64.b32encode(self.sideband.identity.get_private_key()).decode("utf-8"))+"[/b]",
buttons=[ yes_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
def identity_copy_action(self, sender=None):
c_yes_button = MDRectangleFlatButton(text="Yes",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
c_no_button = MDRectangleFlatButton(text="No, go back",font_size=dp(18))
c_dialog = MDDialog(text="[b]Caution![/b]\n\nYour Identity key will be copied to the system clipboard. Take extreme care that no untrusted app steals your key by reading the clipboard data. Clear the system clipboard immediately after pasting your key where you need it.\n\nAre you sure that you wish to proceed?", buttons=[ c_no_button, c_yes_button ])
def c_dl_no(s):
c_dialog.dismiss()
def c_dl_yes(s):
c_dialog.dismiss()
yes_button = MDRectangleFlatButton(text="OK")
dialog = MDDialog(text="Your Identity key was copied to the system clipboard", buttons=[ yes_button ])
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
Clipboard.copy(str(base64.b32encode(self.sideband.identity.get_private_key()).decode("utf-8")))
dialog.open()
c_yes_button.bind(on_release=c_dl_yes)
c_no_button.bind(on_release=c_dl_no)
c_dialog.open()
def identity_share_action(self, sender=None):
if RNS.vendor.platformutils.get_platform() == "android":
self.share_text(str(base64.b32encode(self.sideband.identity.get_private_key()).decode("utf-8")))
def identity_restore_action(self, sender=None):
c_yes_button = MDRectangleFlatButton(text="Yes",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
c_no_button = MDRectangleFlatButton(text="No, go back",font_size=dp(18))
c_dialog = MDDialog(text="[b]Caution![/b]\n\nYou are about to import a new Identity key into Sideband. The currently active key will be irreversibly destroyed, and you will loose your LXMF address if you have not already backed up your current Identity key.\n\nAre you sure that you wish to import the key?", buttons=[ c_no_button, c_yes_button ])
def c_dl_no(s):
c_dialog.dismiss()
def c_dl_yes(s):
c_dialog.dismiss()
b32_text = self.keys_screen.ids.key_restore_text.text
try:
key_bytes = base64.b32decode(b32_text)
new_id = RNS.Identity.from_bytes(key_bytes)
if new_id != None:
new_id.to_file(self.sideband.identity_path)
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(text="[b]The provided Identity key data was imported[/b]\n\nThe app will now exit. Please restart Sideband to use the new Identity.", buttons=[ yes_button ])
def dl_yes(s):
dialog.dismiss()
self.quit_action(sender=self)
yes_button.bind(on_release=dl_yes)
dialog.open()
except Exception as e:
yes_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
dialog = MDDialog(text="[b]The provided Identity key data was not valid[/b]\n\nThe error reported by Reticulum was:\n\n[i]"+str(e)+"[/i]\n\nNo Identity was imported into Sideband.", buttons=[ yes_button ])
def dl_yes(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
dialog.open()
c_yes_button.bind(on_release=c_dl_yes)
c_no_button.bind(on_release=c_dl_no)
c_dialog.open()
### Telemetry Screen
######################################
def telemetry_init(self):
if not self.telemetry_ready:
self.telemetry_screen = Telemetry(self)
self.telemetry_ready = True
def telemetry_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "telemetry_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def telemetry_action(self, sender=None, direction="left"):
if self.telemetry_ready:
self.telemetry_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.telemetry_init()
def o(dt):
self.telemetry_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def close_sub_telemetry_action(self, sender=None):
self.telemetry_action(direction="right")
def converse_from_telemetry(self, sender=None):
if self.object_details_screen != None:
context_dest = self.object_details_screen.object_hash
if not self.object_details_screen.object_hash == self.sideband.lxmf_destination.hash:
if self.sideband.has_conversation(context_dest):
pass
else:
self.sideband.create_conversation(context_dest)
self.sideband.setstate("app.flags.new_conversations", True)
self.open_conversation(context_dest)
def telemetry_send_update(self, sender=None):
if not hasattr(self, "telemetry_info_dialog") or self.telemetry_info_dialog == None:
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
self.telemetry_info_dialog = MDDialog(
title="Info",
text="",
buttons=[ ok_button ],
)
def dl_ok(s):
self.telemetry_info_dialog.dismiss()
ok_button.bind(on_release=dl_ok)
collector_address = self.sideband.config["telemetry_collector"]
if self.sideband.config["telemetry_send_all_to_collector"]:
last_timebase = (self.sideband.getpersistent(f"telemetry.{RNS.hexrep(collector_address, delimit=False)}.last_send_success_timebase") or 0)
result = self.sideband.create_telemetry_collector_response(to_addr=collector_address, timebase=last_timebase, is_authorized_telemetry_request=True)
else:
result = self.sideband.send_latest_telemetry(to_addr=collector_address)
if result == "no_address":
title_str = "Invalid Address"
info_str = "You must specify a valid LXMF address for the collector you want to sent data to."
elif result == "destination_unknown":
title_str = "Unknown Destination"
info_str = "No keys known for the destination. Connected reticules have been queried for the keys. Try again when an announce for the destination has arrived."
elif result == "in_progress":
title_str = "Transfer In Progress"
info_str = "There is already an outbound telemetry transfer in progress to the collector."
elif result == "already_sent":
title_str = "Already Delivered"
info_str = "The current telemetry data was already sent and delivered to the collector or propagation network."
elif result == "sent":
title_str = "Update Sent"
info_str = "A telemetry update was sent to the collector."
elif result == "not_sent":
title_str = "Not Sent"
info_str = "The telemetry update could not be sent."
elif result == "nothing_to_send":
title_str = "Nothing to Send"
info_str = "There was no new data to send."
else:
title_str = "Unknown Status"
info_str = "The status of the telemetry update is unknown: "+str(result)
self.telemetry_info_dialog.title = title_str
self.telemetry_info_dialog.text = info_str
self.telemetry_info_dialog.open()
def telemetry_request_action(self, sender=None):
if not hasattr(self, "telemetry_info_dialog") or self.telemetry_info_dialog == None:
ok_button = MDRectangleFlatButton(text="OK",font_size=dp(18))
self.telemetry_info_dialog = MDDialog(
title="Info",
text="",
buttons=[ ok_button ],
)
def dl_ok(s):
self.telemetry_info_dialog.dismiss()
ok_button.bind(on_release=dl_ok)
result = self.sideband.request_latest_telemetry(from_addr=self.sideband.config["telemetry_collector"])
if result == "no_address":
title_str = "Invalid Address"
info_str = "You must specify a valid LXMF address for the collector you want to request data from."
elif result == "destination_unknown":
title_str = "Unknown Destination"
info_str = "No keys known for the destination. Connected reticules have been queried for the keys. Try again when an announce for the destination has arrived."
elif result == "in_progress":
title_str = "Transfer In Progress"
info_str = "There is already a telemetry request transfer in progress for this peer."
elif result == "sent":
title_str = "Request Sent"
info_str = "A telemetry request was sent to the peer. The peer should send any available telemetry shortly."
elif result == "not_sent":
title_str = "Not Sent"
info_str = "A telemetry request could not be sent."
else:
title_str = "Unknown Status"
info_str = "The status of the telemetry request is unknown: "+str(result)
self.telemetry_info_dialog.title = title_str
self.telemetry_info_dialog.text = info_str
self.telemetry_info_dialog.open()
### Map Screen
######################################
def map_fm_got_path(self, path):
self.map_fm_exited()
try:
source = MBTilesMapSource(path)
self.map_update_source()
self.sideband.config["map_storage_file"] = path
self.sideband.config["map_storage_path"] = str(pathlib.Path(path).parent.resolve())
self.sideband.save_configuration()
toast("Using \""+os.path.basename(path)+"\" as offline map")
except Exception as e:
RNS.log(f"Error while loading map \"{path}\": "+str(e), RNS.LOG_ERROR)
toast("Could not load map \""+os.path.basename(path)+"\"")
self.sideband.config["map_storage_file"] = None
self.sideband.config["map_use_offline"] = False
self.sideband.config["map_use_online"] = True
self.map_settings_load_states()
self.map_update_source()
def map_fm_exited(self, *args):
self.manager_open = False
self.file_manager.close()
self.map_update_source()
def map_get_offline_source(self):
if self.offline_source != None:
return self.offline_source
else:
try:
current_map_path = self.sideband.config["map_storage_file"]
if current_map_path == None:
raise ValueError("Map path cannot be None")
source = MBTilesMapSource(current_map_path, cache_dir=self.map_cache)
self.offline_source = source
return self.offline_source
except Exception as e:
RNS.log(f"Error while loading map from \"{current_map_path}\": "+str(e))
self.sideband.config["map_storage_file"] = None
self.sideband.config["map_use_offline"] = False
self.sideband.config["map_use_online"] = True
self.sideband.save_configuration()
self.map_settings_load_states()
return None
def map_get_source(self):
source = None
if self.sideband.config["map_use_offline"]:
source = self.map_get_offline_source()
if source == None:
source = MapSource.from_provider("osm", cache_dir=self.map_cache, quad_key=False)
return source
def map_update_source(self, source=None):
ns = source or self.map_get_source()
if self.map != None:
if source != None:
maxz = source.max_zoom
minz = source.min_zoom
if self.map.zoom > maxz:
mz = maxz; px, py = self.map_get_zoom_center(); self.map.set_zoom_at(mz, px, py)
if self.map.zoom < minz:
mz = minz; px, py = self.map_get_zoom_center(); self.map.set_zoom_at(mz, px, py)
m = self.map
nlat = self.map.lat
nlon = self.map.lon
if nlat < -89: nlat = -89
if nlat > 89: nlat = 89
if nlon < -179: nlon = -179
if nlon > 179: nlon = 179
self.map.center_on(nlat,nlon)
self.map.map_source = ns
def map_layers_action(self, sender=None):
try:
ml = self.map_layer
layers = []
if self.sideband.config["map_use_offline"]:
layers.append("offline")
if self.sideband.config["map_use_online"]:
layers.append("osm")
layers.append("ve")
if ml == None: ml = layers[0]
if not ml in layers:
ml = layers[0]
mli = layers.index(ml)
mli = (mli+1)%len(layers)
ml = layers[mli]
source = None
if ml == "offline": source = self.map_get_offline_source()
if ml == "osm": source = MapSource.from_provider("osm", cache_dir=self.map_cache, quad_key=False)
if ml == "ve": source = MapSource.from_provider("ve", cache_dir=self.map_cache, quad_key=True)
if source != None:
self.map_layer = ml
self.map_update_source(source)
except Exception as e:
RNS.log("Error while switching map layer: "+str(e), RNS.LOG_ERROR)
def map_select_file_action(self, sender=None):
perm_ok = False
if self.sideband.config["map_storage_path"] == None:
if RNS.vendor.platformutils.is_android():
perm_ok = self.check_storage_permission()
if self.sideband.config["map_storage_external"]:
path = secondary_external_storage_path()
if path == None: path = primary_external_storage_path()
else:
path = primary_external_storage_path()
else:
perm_ok = True
if self.sideband.config["map_storage_external"]:
path = "/"
else:
path = os.path.expanduser("~")
else:
perm_ok = True
path = self.sideband.config["map_storage_path"]
if perm_ok and path != None:
try:
self.file_manager = MDFileManager(
exit_manager=self.map_fm_exited,
select_path=self.map_fm_got_path,
)
self.file_manager.ext = [".mbtiles"]
self.file_manager.show(path)
except Exception as e:
self.sideband.config["map_storage_path"] = None
self.sideband.save_configuration()
toast("Error reading directory, check permissions!")
else:
self.sideband.config["map_storage_path"] = None
self.sideband.save_configuration()
toast("No file access, check permissions!")
map_nav_divisor = 12
map_nav_zoom = 0.25
def map_nav_left(self, sender=None, modifier=1.0):
if self.map != None:
bb = self.map.get_bbox()
lat_span = abs(bb[0] - bb[2])
lon_span = abs(bb[1] - bb[3])
span = min(lat_span, lon_span)
delta = (-span/self.map_nav_divisor)*modifier
self.map.center_on(self.map.lat, self.map.lon+delta)
def map_nav_right(self, sender=None, modifier=1.0):
if self.map != None:
bb = self.map.get_bbox()
lat_span = abs(bb[0] - bb[2])
lon_span = abs(bb[1] - bb[3])
span = min(lat_span, lon_span)
delta = (span/self.map_nav_divisor)*modifier
self.map.center_on(self.map.lat, self.map.lon+delta)
def map_nav_up(self, sender=None, modifier=1.0):
if self.map != None:
bb = self.map.get_bbox()
lat_span = abs(bb[0] - bb[2])
lon_span = abs(bb[1] - bb[3])
span = min(lat_span, lon_span)
delta = (span/self.map_nav_divisor)*modifier
self.map.center_on(self.map.lat+delta, self.map.lon)
def map_nav_down(self, sender=None, modifier=1.0):
if self.map != None:
bb = self.map.get_bbox()
lat_span = abs(bb[0] - bb[2])
lon_span = abs(bb[1] - bb[3])
span = min(lat_span, lon_span)
delta = (-span/self.map_nav_divisor)*modifier
self.map.center_on(self.map.lat+delta, self.map.lon)
def map_get_zoom_center(self):
bb = self.map.get_bbox()
slat = (bb[2]-bb[0])/2; slon = (bb[3]-bb[1])/2
zlat = bb[0]+slat; zlon = bb[1]+slon
return self.map.get_window_xy_from(zlat, zlon, self.map.zoom)
def map_nav_zoom_out(self, sender=None, modifier=1.0):
if self.map != None:
zd = -self.map_nav_zoom*modifier
if self.map.zoom+zd > self.map.map_source.min_zoom:
px, py = self.map_get_zoom_center()
self.map.animated_diff_scale_at(zd, px, py)
def map_nav_zoom_in(self, sender=None, modifier=1.0):
if self.map != None:
zd = self.map_nav_zoom*modifier
if self.map.zoom+zd < self.map.map_source.max_zoom or self.map.scale < 3.0:
px, py = self.map_get_zoom_center()
self.map.animated_diff_scale_at(zd, px, py)
def map_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("map_screen"):
self.map_open(sender=sender, direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.map_init()
def o(dt):
self.map_open(sender=sender, no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def map_init(self):
if not self.root.ids.screen_manager.has_screen("map_screen"):
msource = self.map_get_source()
mzoom = self.sideband.config["map_zoom"]
mlat = self.sideband.config["map_lat"]; mlon = self.sideband.config["map_lon"]
if mzoom > msource.max_zoom: mzoom = msource.max_zoom
if mzoom < msource.min_zoom: mzoom = msource.min_zoom
if mlat < -89: mlat = -89
if mlat > 89: mlat = 89
if mlon < -179: mlon = -179
if mlon > 179: mlon = 179
self.map_screen = Builder.load_string(layout_map_screen)
self.map_screen.app = self
self.root.ids.screen_manager.add_widget(self.map_screen)
from mapview import MapView
mapview = MapView(map_source=msource, zoom=mzoom, lat=mlat, lon=mlon)
mapview.snap_to_zoom = False
mapview.double_tap_zoom = True
self.map = mapview
self.map_screen.ids.map_layout.map = mapview
self.map_screen.ids.map_layout.add_widget(self.map_screen.ids.map_layout.map)
def map_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "map_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if not hasattr(self, "map_markers") or self.map_markers == None:
self.map_markers = {}
def am_job(dt):
self.map_update_markers()
Clock.schedule_once(am_job, 0.15)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def map_settings_load_states(self):
if self.map_settings_screen != None:
self.map_settings_screen.ids.map_use_online.active = self.sideband.config["map_use_online"]
self.map_settings_screen.ids.map_use_offline.active = self.sideband.config["map_use_offline"]
self.map_settings_screen.ids.map_storage_external.active = self.sideband.config["map_storage_external"]
def map_settings_init(self):
self.map_settings_load_states()
def map_settings_save(sender=None, event=None):
self.sideband.config["map_storage_external"] = self.map_settings_screen.ids.map_storage_external.active
self.sideband.config["map_use_online"] = self.map_settings_screen.ids.map_use_online.active
self.sideband.config["map_use_offline"] = self.map_settings_screen.ids.map_use_offline.active
self.sideband.save_configuration()
def external_toggle(sender=None, event=None):
self.sideband.config["map_storage_path"] = None
map_settings_save()
def offline_toggle(sender=None, event=None):
if self.map_settings_screen.ids.map_use_offline.active:
# self.map_settings_screen.ids.map_use_online.active = False
if self.sideband.config["map_storage_file"] == None:
self.map_select_file_action()
else:
self.map_settings_screen.ids.map_use_online.active = True
map_settings_save(); self.map_update_source()
def online_toggle(sender=None, event=None):
if self.map_settings_screen.ids.map_use_online.active:
# self.map_settings_screen.ids.map_use_offline.active = False
pass
else:
self.map_settings_screen.ids.map_use_offline.active = True
map_settings_save(); self.map_update_source()
self.map_settings_screen.ids.map_use_offline.bind(active=offline_toggle)
self.map_settings_screen.ids.map_use_online.bind(active=online_toggle)
self.map_settings_screen.ids.map_storage_external.bind(active=external_toggle)
def map_settings_action(self, sender=None, direction="left"):
if not self.root.ids.screen_manager.has_screen("map_settings_screen"):
self.map_settings_screen = Builder.load_string(layout_map_settings_screen)
self.map_settings_screen.app = self
self.root.ids.screen_manager.add_widget(self.map_settings_screen)
self.map_settings_screen.ids.map_config_info.text = "\n\nSideband can use map sources from the Internet, or a map source stored locally on this device in MBTiles format."
self.map_settings_screen.ids.map_settings_scrollview.effect_cls = ScrollEffect
self.map_settings_init()
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "map_settings_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
def update_cache_size(dt):
size = self.sideband.get_map_cache_size()
size_str = RNS.prettysize(size)
self.map_settings_screen.ids.map_cache_button.text = f"Clear {size_str} map cache"
if size > 0.0:
self.map_settings_screen.ids.map_cache_button.disabled = False
else:
self.map_settings_screen.ids.map_cache_button.disabled = True
self.map_settings_screen.ids.map_cache_button.text = f"No data in map cache"
Clock.schedule_once(update_cache_size, 0.35)
def map_clear_cache(self, sender=None):
yes_button = MDRectangleFlatButton(text="Yes",font_size=dp(18), theme_text_color="Custom", line_color=self.color_reject, text_color=self.color_reject)
no_button = MDRectangleFlatButton(text="No",font_size=dp(18))
dialog = MDDialog(
title="Clear map cache?",
buttons=[ yes_button, no_button ],
# elevation=0,
)
def dl_yes(s):
dialog.dismiss()
self.sideband.clear_map_cache()
def cb(dt):
self.map_settings_action()
self.map_settings_screen.ids.map_cache_button.disabled = True
Clock.schedule_once(cb, 1.2)
def dl_no(s):
dialog.dismiss()
yes_button.bind(on_release=dl_yes)
no_button.bind(on_release=dl_no)
dialog.open()
def close_location_error_dialog(self, sender=None):
if hasattr(self, "location_error_dialog") and self.location_error_dialog != None:
self.location_error_dialog.dismiss()
def map_object_list(self, sender):
pass
def map_show(self, location, retry=0):
max_tries = 6
if hasattr(self, "map") and self.map:
mz = 16
lat = location["latitude"]
lon = location["longtitude"]
if mz > self.map.map_source.max_zoom: mz = self.map.map_source.max_zoom
if mz < self.map.map_source.min_zoom: mz = self.map.map_source.min_zoom
self.map.zoom = mz
self.map.trigger_update(True)
self.map.center_on(lat,lon)
self.map.trigger_update(True)
else:
if retry < max_tries:
def j(dt):
self.map_show(location, retry=retry+1)
Clock.schedule_once(j, 0.5)
def map_show_peer_location(self, context_dest):
location = self.sideband.peer_location(context_dest)
if not location:
self.location_error_dialog = MDDialog(
title="No Location",
text="No location updates have been received from this peer. You can use the the [b]Situation Map[/b] to manually search for earlier telemetry.",
buttons=[
MDRectangleFlatButton(
text="OK",
font_size=dp(18),
on_release=self.close_location_error_dialog
)
],
)
self.location_error_dialog.open()
else:
self.map_action()
self.map_show(location)
def map_display_telemetry(self, sender=None):
self.object_details_action(sender)
def map_display_own_telemetry(self, sender=None):
self.sideband.update_telemetry()
self.object_details_action(source_dest=self.sideband.lxmf_destination.hash,from_telemetry=True)
def close_sub_map_action(self, sender=None):
self.map_action(direction="right")
def object_details_action(self, sender=None, from_conv=False, from_telemetry=False, source_dest=None, direction="left"):
if self.root.ids.screen_manager.has_screen("object_details_screen"):
self.object_details_open(sender=sender, from_conv=from_conv, from_telemetry=from_telemetry, source_dest=source_dest, direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.object_details_init()
def o(dt):
self.object_details_open(sender=sender, from_conv=from_conv, from_telemetry=from_telemetry, source_dest=source_dest, no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def object_details_init(self):
self.object_details_screen = ObjectDetails(self)
def object_details_open(self, sender=None, from_conv=False, from_telemetry=False, source_dest=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
if self.sideband.config["telemetry_enabled"] == True:
self.sideband.update_telemetry()
if source_dest != None:
telemetry_source = source_dest
else:
if sender != None and hasattr(sender, "source_dest") and sender.source_dest != None:
telemetry_source = sender.source_dest
else:
telemetry_source = None
self.root.ids.nav_drawer.set_state("closed")
if telemetry_source == None:
self.conversations_action(direction="right")
else:
Clock.schedule_once(lambda dt: self.object_details_screen.set_source(telemetry_source, from_conv=from_conv, from_telemetry=from_telemetry), 0.0)
def vj(dt):
self.root.ids.screen_manager.current = "object_details_screen"
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
Clock.schedule_once(vj, 0.15)
def map_create_marker(self, source, telemetry, appearance):
try:
l = telemetry["location"]
a_icon = appearance[0]
a_fg = appearance[1]; a_bg = appearance[2]
marker = CustomMapMarker(lat=l["latitude"], lon=l["longtitude"], icon_bg=a_bg)
marker.app = self
marker.source_dest = source
marker.location_time = l["last_update"]
marker.icon = MDMapIconButton(
icon=a_icon, icon_color=a_fg,
md_bg_color=a_bg, theme_icon_color="Custom",
icon_size=dp(32),
on_release=self.map_display_telemetry,
)
marker.icon._default_icon_pad = dp(16)
marker.icon.source_dest = marker.source_dest
marker.add_widget(marker.icon)
########
# marker.badge = MDMapIconButton(
# icon="network-strength-2", icon_color=[0,0,0,1],
# md_bg_color=[1,1,1,1], theme_icon_color="Custom",
# icon_size=dp(18),
# )
# marker.badge._default_icon_pad = dp(5)
# marker.icon.add_widget(marker.badge)
########
return marker
except Exception as e:
RNS.log("Could not create map marker for "+RNS.prettyhexrep(source)+": "+str(e), RNS.LOG_ERROR)
return None
def map_update_markers(self, sender=None):
RNS.log("Updating map markers", RNS.LOG_DEBUG)
earliest = time.time() - self.sideband.config["map_history_limit"]
telemetry_entries = self.sideband.list_telemetry(after=earliest)
own_address = self.sideband.lxmf_destination.hash
changes = False
# Add own marker if available
retain_own = False
own_telemetry = self.sideband.get_telemetry()
own_appearance = [
self.sideband.config["telemetry_icon"],
self.sideband.config["telemetry_fg"],
self.sideband.config["telemetry_bg"]
]
skip_entries = []
if self.sideband.config["telemetry_display_trusted_only"]:
for telemetry_source in telemetry_entries:
try:
if not self.sideband.is_trusted(telemetry_source):
skip_entries.append(telemetry_source)
except:
pass
for skip_entry in skip_entries:
try:
telemetry_entries.pop(skip_entry)
except:
pass
try:
if own_telemetry != None and "location" in own_telemetry and own_telemetry["location"] != None and own_telemetry["location"]["latitude"] != None and own_telemetry["location"]["longtitude"] != None:
retain_own = True
if not own_address in self.map_markers:
marker = self.map_create_marker(own_address, own_telemetry, own_appearance)
if marker != None:
self.map_markers[own_address] = marker
self.map_screen.ids.map_layout.map.add_marker(marker)
changes = True
else:
marker = self.map_markers[own_address]
o = own_telemetry["location"]
if o["last_update"] > marker.location_time or (hasattr(self, "own_appearance_changed") and self.own_appearance_changed):
marker.location_time = o["last_update"]
marker.lat = o["latitude"]
marker.lon = o["longtitude"]
marker.icon.icon = own_appearance[0]
marker.icon.icon_color = own_appearance[1]
marker.icon.md_bg_color = own_appearance[2]
self.own_appearance_changed = False
changes = True
stale_markers = []
for marker in self.map_markers:
if not marker in telemetry_entries:
if marker == own_address:
if not retain_own:
stale_markers.append(marker)
else:
stale_markers.append(marker)
for marker in stale_markers:
RNS.log("Removing stale marker: "+str(marker), RNS.LOG_DEBUG)
try:
to_remove = self.map_markers[marker]
self.map_screen.ids.map_layout.map.remove_marker(to_remove)
self.map_markers.pop(marker)
changes = True
except Exception as e:
RNS.log("Error while removing map marker: "+str(e), RNS.LOG_ERROR)
except Exception as e:
RNS.log("Error while updating own map marker: "+str(e), RNS.LOG_ERROR)
for telemetry_source in telemetry_entries:
try:
skip = False
if telemetry_source == own_address:
skip = True
elif telemetry_source in self.map_markers:
marker = self.map_markers[telemetry_source]
newest_timestamp = telemetry_entries[telemetry_source][0][0]
if newest_timestamp <= marker.location_time:
skip = True
latest_viewable = None
if not skip:
for telemetry_entry in telemetry_entries[telemetry_source]:
telemetry_timestamp = telemetry_entry[0]
telemetry_data = telemetry_entry[1]
t = Telemeter.from_packed(telemetry_data)
if t != None:
telemetry = t.read_all()
if "location" in telemetry and telemetry["location"] != None and telemetry["location"]["latitude"] != None and telemetry["location"]["longtitude"] != None:
latest_viewable = telemetry
break
if latest_viewable != None:
l = latest_viewable["location"]
if not telemetry_source in self.map_markers:
marker = self.map_create_marker(telemetry_source, latest_viewable, self.sideband.peer_appearance(telemetry_source))
if marker != None:
self.map_markers[telemetry_source] = marker
self.map_screen.ids.map_layout.map.add_marker(marker)
changes = True
else:
marker = self.map_markers[telemetry_source]
marker.location_time = latest_viewable["time"]["utc"]
marker.lat = l["latitude"]
marker.lon = l["longtitude"]
appearance = self.sideband.peer_appearance(telemetry_source)
marker.icon.icon = appearance[0]
marker.icon.icon_color = appearance[1]
marker.icon.md_bg_color = appearance[2]
changes = True
except Exception as e:
RNS.log("Error while updating map entry for "+RNS.prettyhexrep(telemetry_source)+": "+str(e), RNS.LOG_ERROR)
self.last_map_update = time.time()
if changes:
self.map.trigger_update(True)
### Guide screen
######################################
def close_guide_action(self, sender=None):
self.open_conversations(direction="right")
def guide_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
self.root.ids.screen_manager.current = "guide_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def guide_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("guide_screen"):
self.guide_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.guide_init()
def o(dt):
self.guide_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def guide_init(self):
if not self.root.ids.screen_manager.has_screen("guide_screen"):
self.guide_screen = Builder.load_string(layout_guide_screen)
self.guide_screen.app = self
self.root.ids.screen_manager.add_widget(self.guide_screen)
def link_exec(sender=None, event=None):
def lj():
webbrowser.open("https://unsigned.io/donate")
threading.Thread(target=lj, daemon=True).start()
guide_text1 = """
[size=18dp][b]Introduction[/b][/size][size=5dp]\n \n[/size]Welcome to [i]Sideband[/i], an LXMF client for Android, Linux and macOS. With Sideband, you can communicate with other people or LXMF-compatible systems over Reticulum networks using LoRa, Packet Radio, WiFi, I2P, or anything else Reticulum supports.
This short guide will give you a basic introduction to the concepts that underpin Sideband and LXMF (which is the protocol that Sideband uses to communicate). If you are not already familiar with LXMF and Reticulum, it is probably a good idea to read this guide, since Sideband is very different from other messaging apps."""
guide_text2 = """
[size=18dp][b]Communication Without Subjection[/b][/size][size=5dp]\n \n[/size]Sideband is completely free, permission-less, anonymous and infrastructure-less. Sideband uses the peer-to-peer and distributed messaging system LXMF. There is no sign-up, no service providers, no "end-user license agreements", no data theft and no surveillance. You own the system.
This also means that Sideband operates differently than what you might be used to. It does not need a connection to a server on the Internet to function, and you do not have an account anywhere."""
guide_text3 = """
[size=18dp][b]Operating Principles[/b][/size][size=5dp]\n \n[/size]When Sideband is started on your device for the first time, it randomly generates a set of cryptographic keys. These keys are then used to create an LXMF address for your use. Any other endpoint in [i]any[/i] Reticulum network will be able to send data to this address, as long as there is [i]some sort of physical connection[/i] between your device and the remote endpoint. You can also move around to other Reticulum networks with this address, even ones that were never connected to the network the address was created on, or that didn't exist when the address was created. The address is yours to keep and control for as long (or short) a time you need it, and you can always delete it and create a new one."""
guide_text4 = """
[size=18dp][b]Becoming Reachable[/b][/size][size=5dp]\n \n[/size]To establish reachability for any Reticulum address on a network, an [i]announce[/i] must be sent. Sideband does not do this automatically by default, but can be configured to do so every time the program starts. To send an announce manually, press the [i]Announce[/i] button in the [i]Conversations[/i] section of the program. When you send an announce, you make your LXMF address reachable for real-time messaging to the entire network you are connected to. Even in very large networks, you can expect global reachability for your address to be established in under a minute.
If you don't move to other places in the network, and keep connected through the same hubs or gateways, it is generally not necessary to send an announce more often than once every week. If you change your entry point to the network, you may want to send an announce, or you may just want to stay quiet."""
guide_text5 = """
[size=18dp][b]Relax & Disconnect[/b][/size][size=5dp]\n \n[/size]If you are not connected to the network, it is still possible for other people to message you, as long as one or more [i]Propagation Nodes[/i] exist on the network. These nodes pick up and hold encrypted in-transit messages for offline users. Messages are always encrypted before leaving the originators device, and nobody else than the intended recipient can decrypt messages in transit.
The Propagation Nodes also distribute copies of messages between each other, such that even the failure of almost every node in the network will still allow users to sync their waiting messages. If all Propagation Nodes disappear or are destroyed, users can still communicate directly. Reticulum and LXMF will degrade gracefully all the way down to single users communicating directly via long-range data radios. Anyone can start up new propagation nodes and integrate them into existing networks without permission or coordination. Even a small and cheap device like a Rasperry Pi can handle messages for millions of users. LXMF networks are designed to be quite resilient, as long as there are people using them."""
guide_text6 = """
[size=18dp][b]Packets Find A Way[/b][/size][size=5dp]\n \n[/size]Connections in Reticulum networks can be wired or wireless, span many intermediary hops, run over fast links or ultra-low bandwidth radio, tunnel over the Invisible Internet (I2P), private networks, satellite connections, serial lines or anything else that Reticulum can carry data over. In most cases it will not be possible to know what path data takes in a Reticulum network, and no transmitted packets carries any identifying characteristics, apart from a destination address. There is no source addresses in Reticulum. As long as you do not reveal any connecting details between your person and your LXMF address, you can remain anonymous. Sending messages to others does not reveal [i]your[/i] address to anyone else than the intended recipient."""
guide_text7 = """
[size=18dp][b]Be Yourself, Be Unknown, Stay Free[/b][/size][size=5dp]\n \n[/size]Even with the above characteristics in mind, you [b]must remember[/b] that LXMF and Reticulum is not a technology that can guarantee anonymising connections that are already de-anonymised! If you use Sideband to connect to TCP Reticulum hubs over the clear Internet, from a network that can be tied to your personal identity, an adversary may learn that you are generating LXMF traffic. If you want to avoid this, it is recommended to use I2P to connect to Reticulum hubs on the Internet. Or only connecting from within pure Reticulum networks, that take one or more hops to reach connections that span the Internet. This is a complex topic, with many more nuances than can be covered here. You are encouraged to ask on the various Reticulum discussion forums if you are in doubt.
If you use Reticulum and LXMF on hardware that does not carry any identifiers tied to you, it is possible to establish a completely free and anonymous communication system with Reticulum and LXMF clients."""
guide_text8 = """
[size=18dp][b]Keyboard Shortcuts[/b][/size][size=5dp]\n \n[/size] - Ctrl+Q or Ctrl-W Shut down Sideband
- Ctrl-D or Ctrl-S Send message
- Ctrl-R Show Conversations
- Ctrl-L Show Announce Stream
- Ctrl-M Show Situation Map
- Ctrl-T Show Telemetry Setup
- Ctrl-N New conversation
- Ctrl-G Show guide"""
guide_text9 = """
[size=18dp][b]Sow Seeds Of Freedom[/b][/size][size=5dp]\n \n[/size]It took me more than seven years to design and built the entire ecosystem of software and hardware that makes this possible. If this project is valuable to you, please go to [u][ref=link]https://unsigned.io/donate[/ref][/u] to support the project with a donation. Every donation directly makes the entire Reticulum project possible.
Thank you very much for using Free Communications Systems.
"""
info1 = guide_text1
info2 = guide_text2
info3 = guide_text3
info4 = guide_text4
info5 = guide_text5
info6 = guide_text6
info7 = guide_text7
info8 = guide_text8
info9 = guide_text9
if self.theme_cls.theme_style == "Dark":
info1 = "[color=#"+dark_theme_text_color+"]"+info1+"[/color]"
info2 = "[color=#"+dark_theme_text_color+"]"+info2+"[/color]"
info3 = "[color=#"+dark_theme_text_color+"]"+info3+"[/color]"
info4 = "[color=#"+dark_theme_text_color+"]"+info4+"[/color]"
info5 = "[color=#"+dark_theme_text_color+"]"+info5+"[/color]"
info6 = "[color=#"+dark_theme_text_color+"]"+info6+"[/color]"
info7 = "[color=#"+dark_theme_text_color+"]"+info7+"[/color]"
info8 = "[color=#"+dark_theme_text_color+"]"+info8+"[/color]"
info9 = "[color=#"+dark_theme_text_color+"]"+info9+"[/color]"
self.guide_screen.ids.guide_info1.text = info1
self.guide_screen.ids.guide_info2.text = info2
self.guide_screen.ids.guide_info3.text = info3
self.guide_screen.ids.guide_info4.text = info4
self.guide_screen.ids.guide_info5.text = info5
self.guide_screen.ids.guide_info6.text = info6
self.guide_screen.ids.guide_info7.text = info7
self.guide_screen.ids.guide_info8.text = info8
self.guide_screen.ids.guide_info9.text = info9
self.guide_screen.ids.guide_info9.bind(on_ref_press=link_exec)
self.guide_screen.ids.guide_scrollview.effect_cls = ScrollEffect
#################################################
# Unimplemented Screens #
#################################################
def broadcasts_action(self, sender=None, direction="left"):
if self.root.ids.screen_manager.has_screen("broadcasts_screen"):
self.broadcasts_open(direction=direction)
else:
self.loader_action(direction=direction)
def final(dt):
self.broadcasts_init()
def o(dt):
self.broadcasts_open(no_transition=True)
Clock.schedule_once(o, ll_ot)
Clock.schedule_once(final, ll_ft)
def broadcasts_open(self, sender=None, direction="left", no_transition=False):
if no_transition:
self.root.ids.screen_manager.transition = self.no_transition
else:
self.root.ids.screen_manager.transition = self.slide_transition
self.root.ids.screen_manager.transition.direction = direction
info = "The [b]Local Broadcasts[/b] feature will allow you to send and listen for local broadcast transmissions on connected radio, LoRa and WiFi interfaces.\n\n[b]Local Broadcasts[/b] makes it easy to establish public information exchange with anyone in direct radio range, or even with large areas far away using the [i]Remote Broadcast Repeater[/i] feature.\n\nThese features are not yet implemented in Sideband.\n\nWant it faster? Go to [u][ref=link]https://unsigned.io/donate[/ref][/u] to support the project."
if self.theme_cls.theme_style == "Dark":
info = "[color=#"+dark_theme_text_color+"]"+info+"[/color]"
self.broadcasts_screen.ids.broadcasts_info.text = info
self.root.ids.screen_manager.current = "broadcasts_screen"
self.root.ids.nav_drawer.set_state("closed")
self.sideband.setstate("app.displaying", self.root.ids.screen_manager.current)
if no_transition:
self.root.ids.screen_manager.transition = self.slide_transition
def broadcasts_init(self):
if not self.root.ids.screen_manager.has_screen("broadcasts_screen"):
def link_exec(sender=None, event=None):
def lj():
webbrowser.open("https://unsigned.io/donate")
threading.Thread(target=lj, daemon=True).start()
self.broadcasts_screen = Builder.load_string(layout_broadcasts_screen)
self.broadcasts_screen.app = self
self.root.ids.screen_manager.add_widget(self.broadcasts_screen)
self.broadcasts_screen.ids.broadcasts_scrollview.effect_cls = ScrollEffect
self.broadcasts_screen.ids.broadcasts_info.bind(on_ref_press=link_exec)
class CustomOneLineIconListItem(OneLineIconListItem):
icon = StringProperty()
class MDMapIconButton(MDIconButton):
pass
if not args.daemon:
from kivy.base import ExceptionManager, ExceptionHandler
class SidebandExceptionHandler(ExceptionHandler):
def handle_exception(self, e):
etype = type(e)
if etype != SystemExit:
import traceback
exception_info = "".join(traceback.TracebackException.from_exception(e).format())
RNS.log(f"An unhandled {str(type(e))} exception occurred: {str(e)}", RNS.LOG_ERROR)
RNS.log(exception_info, RNS.LOG_ERROR)
return ExceptionManager.PASS
else:
return ExceptionManager.RAISE
def run():
if args.daemon:
RNS.log("Starting Sideband in daemon mode")
sideband = SidebandCore(None, is_client=False, verbose=(args.verbose or __debug_build__))
sideband.start()
while True:
time.sleep(5)
else:
ExceptionManager.add_handler(SidebandExceptionHandler())
SidebandApp().run()
if __name__ == "__main__":
run()
Reference in New Issue View Git Blame Copy Permalink