From d7393d9219c7a1ea57a241490ad4878a088286d3 Mon Sep 17 00:00:00 2001 From: Mark Qvist Date: Sat, 29 Jun 2024 22:11:51 +0200 Subject: [PATCH] Updated readme --- README.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index b092ec4..e4d1632 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ Sideband is completely free, end-to-end encrypted, permission-less, anonymous an 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. Please read the Guide section included in the program, to get an understanding of how Sideband differs from other messaging systems. -## Functionality & Features +# Functionality & Features Sideband provides many useful and interesting functions, such as: @@ -29,6 +29,8 @@ Sideband is fully compatible with other LXMF clients, such as [MeshChat](https:/ # Installation +Sideband can run on most computing devices, but installation methods vary by device type and operating system. For installation instructions, please find the relevant section below. + ## On Android For your Android devices, you can install Sideband through F-Droid, by adding the [Between the Borders Repo](https://reticulum.betweentheborders.com/fdroid/repo/), or you can download an [APK on the latest release](https://github.com/markqvist/Sideband/releases/latest) page. Both sources are signed with the same release keys, and can be used interchangably. @@ -140,6 +142,8 @@ sideband A DMG file containing a macOS app bundle is available on the [latest release](https://github.com/markqvist/Sideband/releases/latest) page. +Please note that audio messaging functionality isn't supported on macOS yet. Please support the development if you'd like to see this feature added faster. + Alternatively, you can install Sideband with ``pip3`` on macOS: ```bash @@ -162,6 +166,8 @@ If you have not already installed Python and `pip3` on your macOS system, [downl Even though there is currently not an automated installer, or packaged `.exe` file for Sideband on Windows, you can still install it through `pip`. If you don't already have Python installed, [download and install](https://www.python.org/downloads/) the latest version of Python. +Please note that audio messaging functionality isn't supported on Windows yet. Please support the development if you'd like to see this feature added faster. + **Important!** When asked by the installer, make sure to add the Python program to your PATH environment variables. If you don't do this, you will not be able to use the `pip` installer, or run the `sideband` command. When Python has been installed, you can open a command prompt and install sideband via `pip`: @@ -174,7 +180,7 @@ The Sideband application can now be launched by running the command `sideband` i When running Sideband for the first time, a default Reticulum configuration file will be created, if you don't already have one. If you don't have any existing Reticulum connectivity available locally, you may want to edit the file, located at `C:\Users\USERNAME\.reticulum\config` and manually add an interface that provides connectivity to a wider network. If you just want to connect over the Internet, you can add one of the public hubs on the [Reticulum Testnet](https://reticulum.network/connect.html). -## Example Paper Message +# Paper Messaging Example You can try out the paper messaging functionality by using the following QR-code. It is a paper message sent to the LXMF address `6b3362bd2c1dbf87b66a85f79a8d8c75`. To be able to decrypt and read the message, you will need to import the following base32-encoded Reticulum Identity into the app: @@ -190,7 +196,7 @@ You can also find the entire message in