Skip to content
mobilevoidPublic

About

a bbs system for ham radio

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

79 Commits

Folders and files

Repository files navigation

OpenBBS

A simple Bulletin Board System implemented in Python using Flask. It provides user authentication and message posting with basic forum support.

Additional usage information is available in docs/USAGE.md.

Features

  • User signup and login
  • Forums with threads and replies
  • File attachments on posts with gzip compression (no encryption)
  • SQLite database via SQLAlchemy
  • Simple web interface using Bootstrap
  • Synchronization API and CLI tools
  • Search functionality for posts
  • Basic COM/VaraHF radio interface with optional KISS framing
  • Support for VARA Terminal's KISS serial mode via VaraKISS
  • REST API for threads/messages and lightweight offline UI
  • Local SQLite storage with sync log
  • Thread owners can grant moderator status via signed ownership tokens
  • Keyboard shortcuts for quick actions and "/" to focus the search box
  • Optional dark mode toggle for better readability

Setup

  1. Create a Python virtual environment (optional but recommended)
  2. Install dependencies:
pip install -r requirements.txt
  1. Run the application:
python run.py

Then open http://localhost:5000 in your browser.

CLI usage

The bbs.py script provides basic commands:

python bbs.py list            # list threads
python bbs.py new "Title"     # create thread
python bbs.py post <thread> "message" --author bob
python bbs.py sync pull --since 2023-01-01T00:00:00
python bbs.py sync push package.tar.zst

Notes

Radio communication supports the VaraHF modem over TCP and includes a KISS TNC compatibility layer. The VaraKISS helper lets you talk to VARA Terminal in its KISS serial mode. File attachments are gzip compressed for safe transfer and are stored unencrypted.

About

a bbs system for ham radio

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages