Skip to content

A python Telnet server for modern UTF-8 and classic cp437 network virtual terminals. In spirit of classic software such as ami/x, teleguard, renegade, iniquity.

License

signalpillar/x84

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

x/84

A python Telnet server for modern UTF-8 and classic cp437 network virtual terminals.

x/84 supplies a scripting engine for developing character-at a time telnet services, such as MUD or BBS systems. Technologies used in x/84 are derived from miniboa (Apache 2.0 Licensed) for telnet, blessed (MIT Licensed) for terminal capabilities, and sqlitedict (Public Domain) for persistent data. Recordings of sessions are stored in ttyplay-compatible format files.

Asynchronous inter-process communication between sessions is provided through an event queuing framework, for scripting of 'shared' experiences. Several examples of these are provided, such as chat.py. The default board provides several activities.

Portability is as equal to python, and has been tested on Raspberry Pi, Android, Mac, OpenBSD, Solaris, etc.

ANSI Art, such as found on ACiD dark domains DVD, is translated for reasonably accurate reproductions for both UTF-8 and IBM CP437 terminals. This allows classic DOS art to be used on modern terminals such as Terminal.app, or classic emulating terminals such as syncterm. Artwork with Sauce records are also supported.

Telnet to host address 1984.ws to preview the default board. See clients for a list of compatible clients.

Install

  1. Install python 2.6 or 2.7
  2. Install pip
  3. Ensure pip is up-to-date:

    pip install --upgrade pip
  4. Install x/84:

    pip install x84
  5. Upgrading:

    pip install --upgrade x84

Getting Started

  1. Launch the x84.engine python module:

    x84

    If the *x84 helper script fails, try using the python interpreter used by pip:

    python2.7 -m x84.engine
  2. Telnet to 127.0.0.1 6023, Assuming a bsd telnet client:

    telnet localhost 6023

Further documentation

See Documentation generated by Sphinx for both docstring API documentation and general tutorials.

Issue Tracking & Development

See the project on github for source tree and issue tracking.

About

A python Telnet server for modern UTF-8 and classic cp437 network virtual terminals. In spirit of classic software such as ami/x, teleguard, renegade, iniquity.

Resources

License

Stars

Watchers

Forks

Packages

No packages published