
  .---------------------------.
  |  NetRunner Documentation  |------------------------------------
  `---------------------------'

  ABOUT NETRUNNER
  ===============

  NetRunner is a telnet client originally developed in the late 90s in
  sync with the release of Windows XP.  It was intended to be a console
  telnet client which stayed true to ANSI-BBS emulation and the old skool
  feel of DOS terminals.

  The art/UI was designed by Grymmjack, the programming done by g00r00

  Some additional artwork since the original release has been done by
  Jack Phlash and g00r00.


  2.0 BETA VERSION
  ================

  This version of NetRunner is a proof of concept, to assist with
  development of a SDL ANSI graphics engine capable of ANSI-BBS and
  other types of ANSI-similar specifications.

  As of this beta, things seem to be relatively functional and bug
  free, and it is now the recommended version of NetRunner to use.

  The VT102 and non-80x25 screen sizes are still missing, but many
  other features have been added such as a mouse streamlined UI,
  SDL2 ansi engine to give authenticate DOS font and colors.  Amiga
  font and automatic font switching, solid Zmodem with a batch
  upload queue, XTERM mouse support and support for XTERM function
  keys (both used by Mystic BBS) and probably more that I am
  forgetting.

  Please see netrunner.ini for default startup video options.

  Feedback/ideas are welcomed! :)


  SDL 2.0 / LIBSDL2
  =================

  This version of NetRunner currently requires SDL232.dll oe SDL264.dll in
  Windows depending on bit level, or libSDL2 to be installed on Linux.

  The website for SDL2 is: https://www.libsdl.org/
  
  If you use Ubuntu you can probably install SDL2 using the following command:
  
    sudo apt-get install libsdl2-dev 

  Depending on your version of Ubuntu this may install a really old version
  of SDL though but with latest Ubuntu 18 you should be fine.
  
	
  SSH SUPPORT
  ===========

  In order to use SSH, you must have Cryptlib installed.  The Windows
  version will come already shipped with the .DLL file (just like with
  SDL2) but in Linux you will need to install it if it is not already
  installed.

  More information on how to install Cryptlib under Linux can be found
  on the Mystic BBS Wiki: http://wiki.mysticbbs.com/doku.php?id=cryptlib

  If Cryptlib is not installed, NetRunner will continue to work, however
  only Telnet and RLOGIN connections will be available.
  
  Note that Cryptlib does not allow for the terminal size and type to be
  set when connecting via SSH, so in the future I will have to develop a
  forked version of Cryptlib for use with NetRunner.


  USING NETRUNNER
  ===============

  NetRunner requires no installation and remains a compact terminal, with
  very little bloat.

  Startup video options are found in netrunner.ini and can be edited
  to increase/decrease performance and increase/decrease the quality of
  the terminal text.  The INI file itself will contain documentation for
  the options found within.

  The UI is fully mouse enabled, including cut and paste to the operating
  system clipboard.  In most places in NetRunner you can right click to get
  a pop up menu of options.  Or you can use any of the various ALT hotkeys.
  See the ALT-Z help screen for more information.  To upload files you must
  queue them first as NetRunner supports automatic batch uploads.  In order
  to do that you can use the queue editor (Alt+Q) or you can just drag and
  drop a file into the NetRunner window at any time (you don't need the
  queue editor open) to add it to the upload queue.

  After the splash screen you will presented with the terminal screen.  Use
  the HELP option listed on the status bar at the bottom to get a list of
  available options.  For example, ALT-Z for help or ALT-O for configuration.


  NETRUNNER COMMAND LINE OPTIONS (DEFAULT CLIENT)
  ===============================================

  NetRunner accepts a command line option to auto-connect to a host, and
  therefore can be setup as the default telnet client for your system.  For
  example, you can have it auto load when you click a telnet link on a website.

  The command line format is this:

     NetRunner.exe [address]:[port]

  If no port is provided, NetRunner will assume port 23 (the telnet standard
  port).  NetRunner will also filter out a telnet URL (telnet://) if it
  finds one.


  NETRUNNER PHONEBOOK IMPORT
  ==========================

  NetRunner can currently import both mTelnet and SyncTerm format phone books.

  The IMPORT option is available in the dialing directory.  NetRunner supports
  multiple phone books, so if you'd like to import into their own book, just
  create a new book and then import.


  NETRUNNER SCRIPT LANGUAGE
  =========================

  NetRunner provides a basic script language for logging into a BBS or
  shell automatically.  Since NetRunner also supports auto Zmodem, it can be
  used for things like automatically uploading or downloading QWK packets, for
  example (untested).

  In the phone book editor there is a "script" field for each dialing entry.
  This is where the base file name of your script is entered (each can have
  their own script).

  For example, if you enter TEST, NetRunner will attemptto execute TEST.SCR
  from the Scripts directory (configurable in NetRunner's configuration).

  The scripting language has only a few simple commands, but they should be
  enough to get basic tasks done.

    DELAY   <ms>   : Delays for a specified number of milliseconds.
    SEND    <text> : Sends text to the remove server
    WAITFOR <text> : Waits for text to be received from the server.
    QUEUE   <file> : Adds <file> to upload queue (if it exists).

  All <text> or <file> options are enclosed in quotation marks, and are double
  quoted if you wish to send a quotation mark.  The SEND command has a couple
  codes which NetRunner will replace with the appropriate values for the
  server you are connecting to:

    @CR - Sends a carrage return (ascii char #13)
    @LF - Sends a line feed character (ascii char #10)
    @UN - Sends the user name set in the dialing directory for this server
    @PW - Sends the password set in the dialing directory for this server.

  An example TEST.SCR might look like this:

    Delay 500                       <- Delays for 1/2 second
    WaitFor "name:"                 <- Wait for text "name:" to be received
    Send "@UN@CR"                   <- Send user name and ENTER
    WaitFor "password:"             <- Wait for text "password:"
    Send "@PW@CR"                   <- Send password and ENTER
    Queue "c:\netrunner\myqwk.rep"  <- Add file to upload queue

    ; at this point the script would automatically navigate to the message
    ; menu and upload the QWK packet, then logoff.


  SUPPORT
  =======

  You should be able to find the latest version at www.mysticbbs.com

  You can contact the author at mysticbbs@gmail.com.  The email is checked
  often or not often, depending on my work schedule and how much time and
  desire I have work on things. :)  If you really want to get a response the
  best place at the time of this writing to find the author is on fsxNet
  in the FSX_MYS message base.
