Skip to content
D-ModemPublic

About

A bulletin board system in Go for telnet, SSH, TN3270 and modem callers

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

D-Modem/bbs: A bulletin board for every caller

bbs

bbs is a bulletin board system in Go for telnet, SSH, TN3270 and modem callers.

One telnet port serves all types of terminal. A TN3270 client (x3270, c3270, wc3270, Vista, PCOMM) gets full 3270 screens with PF keys, through go3270. All other clients get a text BBS, with ANSI colour if the terminal has it. Modem callers connect through the D-Modem suite. They connect through app_dmodem directly from Asterisk, or through modemmenu after its login.

D-Modem BBS
Node 2, modem at 26400 bit/s

Name (or NEW): alice
Password: **********

Welcome, alice.

Main menu
  [M] Message areas         [E] E-mail (1 new)
  [W] Who's online          [U] User list
  [P] Your profile          [I] System info
  [C] Chat                  [S] Page the sysop
  [G] Goodbye

bbs has these functions:

  • Message areas, private mail, chat, paging and doors (DOS doors in dosemu2, or Linux programs).
  • File areas with X/Y/ZMODEM, Kermit, IND$FILE and FTP.
  • E-mail: IMAP, POP3 and SMTP, to and from the internet, directly or through a smarthost.
  • Networks: FidoNet and other FTNs, QWK, NNTP newsgroups, IRC (also a link into an IRC network as a TS6 or P10 hub server), AIM and ICQ, MSN Messenger, Yahoo! Messenger, and MRC.
  • Terminals: ANSI, VT, PETSCII, RIPscrip, sixel and 3270 graphics. Telnet, SSH and web callers can also select the line speed of a modem (300 to 115200 bit/s).
  • On the web: a forum, image boards, a web terminal and an HTTP API.
  • Time: bbs follows NTP, NTS and PTP servers, and it serves all three protocols.
  • Certificates: the ACME client of bbs gets and renews certificates from Let's Encrypt, ZeroSSL and other providers, for all TLS servers.
  • News, weather and quotes: news feeds as read-only areas, the local weather of each caller (NWS, Open-Meteo, USGS earthquakes), and stock quotes from IEX.
  • Databases: SQLite, PostgreSQL, MySQL or MariaDB.

The full list is on the wiki's home page.

Quick start

You must have Go 1.26 or later. Then use these commands:

make                                    # or: go build ./cmd/bbs
bbs -config /etc/bbs/bbs.conf config    # the configuration screens (begun from the sample)
bbs -config /etc/bbs/bbs.conf check     # the configuration, its warnings
bbs -config /etc/bbs/bbs.conf init      # the database, with two areas
bbs -config /etc/bbs/bbs.conf user add sysop -sysop
bbs -config /etc/bbs/bbs.conf serve

bbs.conf.sample has all the options. bbs.service.sample runs bbs under systemd.

Documentation

The documentation is also a website, d-modem.github.io/bbs. The website has reference pages that the build makes from the code.

The documentation is in the wiki. Start with Building, Running and Configuration. The wiki pages are in docs/wiki. Edit them there. The Wiki workflow publishes them. The list of future work is in TODO.md.

The D-Modem suite

Repository What it is
D-Modem The open V.92 softmodem: dmodemd, libdmodem and the Asterisk, FreeSWITCH and ARI modules
app The D-Modem app for Android and iOS: a dial-up modem on a SIP call
hardware pico-serial: RP2040 serial adapters and phone-line USB sticks
menu modemmenu: the login and the menu that dial-up callers see first
bbs A bulletin board for telnet, SSH, TN3270 and modem callers
go3270 A Go library for 3270 terminal servers, used by bbs
brand Logos, colours, type and the naming guide

Licence

AGPL-3.0-only (LICENSE), or a commercial licence from the D-Modem Authors (COMMERCIAL-LICENSE.md). Contributions come with a contributor agreement (CONTRIBUTING.md).

About

A bulletin board system in Go for telnet, SSH, TN3270 and modem callers

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages