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.
- 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
- Create a Python virtual environment (optional but recommended)
- Install dependencies:
pip install -r requirements.txt- Run the application:
python run.pyThen open http://localhost:5000 in your browser.
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.zstRadio 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.