openCom-Companion/README.md

80 lines
3.9 KiB
Markdown
Raw Normal View History

2022-10-25 14:52:41 +02:00
Sideband <img align="right" src="https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg"/>
=========
2022-04-07 21:03:53 +02:00
Sideband is an LXMF client for Android, Linux and macOS. It allows you to communicate with other people or LXMF-compatible systems over Reticulum networks using LoRa, Packet Radio, WiFi, I2P, or anything else Reticulum supports.
2022-10-04 02:33:36 +02:00
![Screenshot](https://github.com/markqvist/Sideband/raw/main/docs/screenshots/devices_small.webp)
2022-04-07 21:03:53 +02:00
2022-10-04 00:34:21 +02:00
Sideband is completely free, end-to-end encrypted, permission-less, anonymous and infrastructure-less. Sideband uses the peer-to-peer and distributed messaging system [LXMF](https://github.com/markqvist/lxmf "LXMF"). There is no sign-up, no service providers, no "end-user license agreements", no data theft and no surveillance. You own the system.
2022-04-07 21:03:53 +02:00
2022-07-08 00:06:35 +02:00
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.
The program currently includes basic functionality for secure and independent communication, and many useful features are planned for implementation. Sideband is currently released as a beta version. Please help make all the functionality a reality by supporting the development with donations.
2022-04-07 21:03:53 +02:00
2022-10-04 02:39:55 +02:00
Sideband works well with the terminal-based LXMF client [Nomad Network](https://github.com/markqvist/nomadnet), which allows you to easily host Propagation Nodes for your LXMF network, and more.
2022-07-09 16:37:25 +02:00
2022-04-07 21:03:53 +02:00
If you want to help develop this program, get in touch.
2022-10-04 02:39:55 +02:00
## Installation
2022-07-08 00:06:35 +02:00
2022-10-07 18:08:01 +02:00
For your Android devices, download an [APK on the latest release](https://github.com/markqvist/Sideband/releases/latest) page. If you prefer to install via F-Droid, you can add the [IzzyOnDroid Repository](https://android.izzysoft.de/repo/info) to your F-Droid client, which includes Sideband.
2022-07-08 00:06:35 +02:00
2022-10-04 23:29:13 +02:00
A DMG file containing a macOS app bundle is also available on the [latest release](https://github.com/markqvist/Sideband/releases/latest) page.
2022-10-04 02:39:55 +02:00
Aditionally, you can install Sideband with ``pip`` on Linux and macOS:
2022-07-08 00:06:35 +02:00
```bash
2022-10-04 10:37:31 +02:00
# Install Sideband and dependencies on Linux
2022-07-08 00:06:35 +02:00
pip install sbapp
2022-10-04 10:37:31 +02:00
# Install Sideband and dependencies on macOS
2022-10-14 12:56:33 +02:00
pip install "sbapp[macos]"
2022-10-04 10:37:31 +02:00
2022-07-08 00:06:35 +02:00
# Run it
2022-07-08 00:09:23 +02:00
sideband
2022-07-08 00:06:35 +02:00
```
2022-07-08 17:04:41 +02:00
## Support Sideband Development
You can help support the continued development of open, free and private communications systems by donating via one of the following channels:
- Monero:
```
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
```
- Ethereum
```
0x81F7B979fEa6134bA9FD5c701b3501A2e61E897a
```
- Bitcoin
```
3CPmacGm34qYvR6XWLVEJmi2aNe3PZqUuq
```
2022-10-04 02:33:36 +02:00
- Ko-Fi: https://ko-fi.com/markqvist
2022-10-04 02:44:16 +02:00
<br/>
2022-11-17 13:46:34 +01:00
## Development Roadmap
- Adding a Nomad Net page browser
- Implementing the Local Broadcasts feature
- Adding a debug log option and viewer
- Adding a Linux .desktop file
- Message sorting mechanism
- Fix I2P status not being displayed correctly when the I2P router disappears unexpectedly
- Adding LXMF sneakernet and paper message functionality
2022-10-25 14:52:41 +02:00
## License
2022-11-01 23:33:50 +01:00
Unless otherwise noted, this work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa].
2022-10-25 14:52:41 +02:00
2022-11-01 23:33:50 +01:00
Permission is hereby granted to use Sideband in binary form, for any and all purposes, and to freely distribute binary copies of the program, so long as no payment or compensation is charged or received for such distribution or use.
<img src="https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png" align="right">
2022-10-25 14:52:41 +02:00
[cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/
[cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png
[cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg
2022-10-04 10:37:31 +02:00
*Device screenshots generated with [deviceframes](https://deviceframes.com). Thanks!*