48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
# Really Simple BBS
|
|
|
|
Really Simple BBS (rsbbs) implements a message board for packet radio, suitable for use with ax25d. It roughly adopts the command conventions established by popular packet radio BBSes, (`B`, `J`, `K`, `L`, `R`, `S`, `H`, etc.).
|
|
|
|
## Installation
|
|
|
|
1. Clone the repo to a reasonable location.
|
|
2. Copy config.yaml.sample to config.yaml and update it.
|
|
|
|
## Usage
|
|
|
|
### With ax25d
|
|
|
|
Assuming you have `ax25d` working on your system, add something like the following to your `ax25d.conf` file, pointing to the rsbbs binary:
|
|
|
|
```
|
|
[KI5QKX-10 via vhf0]
|
|
default * * * * * * * root /opt/local/rsbbs/main.py rsbbs -s %S
|
|
```
|
|
|
|
### Directly
|
|
|
|
You can also run it directly:
|
|
```
|
|
cd /path/to/rsbbs
|
|
python3 main.py -s URCALL
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
usage: main.py [-h] [-d] -s CALLING_STATION [-f CONFIG_FILE] [-v]
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-d, --debug Enable debugging output to stdout
|
|
-s CALLING_STATION, --calling-station CALLING_STATION
|
|
The callsign of the calling station
|
|
-f CONFIG_FILE, --config-file CONFIG_FILE
|
|
specify path to config.yaml file
|
|
-v, --version show program's version number and exit
|
|
```
|
|
|
|
## Operation
|
|
|
|
Checkout the [sample transcript](sample_transcript.txt) for a look at how it works.
|
|
|