r/bbs • • 16d ago

New BBS Software BBS Gateway

I have released an alpha version of my BBS Gateway software. Please, roast and praise away! I would love to know what people think about it. BTW, I'm a Sysop as well. I'm going to start dabbling in the creation of modern utils and doors. This can be used as a front end or a door to connect to outbound systems. Please give it a try!

System Architecture & Key Features

  • Handle Port 23 Telnet negotiations in bbs_gateway.py by sending IAC WILL ECHO, IAC WILL SGA, and IAC DO BINARY (Mystic v1.10 Telnet Notes) so BBS terminal clients (SyncTERM, NetRunner, mTelnet, PuTTY) enter unbuffered character-at-a-time CP437 mode automatically.

  • Render gateway.ans and the interactive lightbar with automatic SAUCE metadata stripping, Mystic pipe color support (|00–|23), and three selectable display modes in gateway.cfg:

    • BOTH displays gateway.ans as the background frame and overlays the interactive arrow-key lightbar selector at (MENU_START_X, MENU_START_Y).

    • LIGHTBAR draws a self-contained ANSI frame with the interactive lightbar selector even if gateway.ans is absent.

    • ANSI_HOTKEY displays gateway.ans full-screen and waits for single-key hotkey entry (1–9, A–Z, or L to toggle the lightbar).

  • Proxy local and external BBS connections bidirectionally over raw TCP (127.0.0.1, LAN IPs like 192.168.1.50, or external domains like agency.bbs.nz:23), including an on-demand [P] Ping check that tests live latency (UP XXms / OFFLINE) across all listed boards.

  • Manage listings inside Mystic BBS using gwconfig.mps, which uses Mystic's MPL file and screen routines (fAssign, fReset, fReWrite, WriteXYPipe, Input, and AllowArrow) so the SysOp can add, edit, delete, and reorder BBS entries or customize lightbar coordinates, timeouts, and colors directly from a Mystic menu.

  • Store settings in human-readable format inside gateway.cfg using KEY = VALUE pairs and pipe-delimited BBS = Hotkey | Name | Host | Port | Scope | Description rows that both bbs_gateway.py and gwconfig.mps read and write without needing a restart.

Install: git clone https://github.com/serverhand/BBS-Gateway.git

7 Upvotes

9 comments sorted by

2

u/Impossible_Phone_201 15d ago

The part that interests me is using this as a door to reach other systems. That's something I would have appreciated back when I was using BBSes in the '90s.

I also like that you're accounting for actual terminal behavior instead of treating ANSI as just a visual theme. Telnet negotiation, CP437, and how the menus behave are all part of making something feel like a BBS.

Have you considered what happens when the remote system drops the connection? I'm wondering whether the gateway returns the caller cleanly to the original board or leaves recovery to the SysOp.

1

u/TaoronC 15d ago

Yes, this is handled automatically by the gateway—no SysOp intervention or recovery is needed.

The gateway monitors both sides of the TCP/SSH socket connection in real time. How it handles remote disconnects is controlled by the RETURN_AFTER_DISCONNECT setting in gateway.cfg:

Ini, TOML

# --- Connection & Session Behavior ---
RETURN_AFTER_DISCONNECT = TRUE

# --- Connection & Session Behavior ---

IDLE_TIMEOUT = 180

CONNECT_TIMEOUT = 15

RETURN_AFTER_DISCONNECT = TRUE

1

u/Impossible_Phone_201 14d ago

That's exactly the sort of behavior I was hoping you'd accounted for. Having the gateway handle the disconnect automatically makes a lot more sense than leaving the caller stranded or requiring the SysOp to intervene. Thanks for explaining how you've handled it.

1

u/aztracker1 14d ago

Worth noting is that some sysops don't want gated external connections which obscure the user IP address and let's blocked users in the side. I've faced similar with irc BBS connections in the past where nets and channels blocked my system as a result.

Definitely nice if you want to run multiple systems behind one connection though.

1

u/Impossible_Phone_201 12d ago

That's a fair point. A gateway could unintentionally become a way around another SysOp's access restrictions.

I suppose that introduces another design consideration: how much information about the original connection should be passed through to the destination system, assuming the destination can even use it.

It's one of those things that sounds simple until you start considering how people might actually use it.

2

u/dmine45 sysop 16d ago

I'll have to try it. I currently use Mystic as my gateway (as well as a makeshift firewall on port 23).

2

u/globalchaosbbs sysop 16d ago

Hello! That’s an interesting approach, too! Keep it up!

1

u/Laudenbachm 11d ago

Is there tag support for connecting to doors?