Short:        BBS terminal for classic boards
Uploader:     n3@clutchbbs.com (n3)
Author:       n3
Type:         comm/bbs
Version:      0.19
Architecture: ppc-morphos >= 3.0.0


ABOUT
=====

MTerm is a MorphOS-native BBS terminal application for connecting to
classic ANSI, Amiga, and C64-style bulletin board systems.

It provides a fast, simple terminal experience with a built-in phonebook,
ANSI, Amiga, and PETSCII display handling, ZMODEM transfers, multiple
display sizes, and MorphOS-friendly window and screen behaviour.


FEATURES
========

 * MorphOS-native BBS terminal client
 * ANSI, Amiga, C64 Support
 * Built-in phonebook for storing and launching BBS connections
 * ZMODEM upload and download support


REQUIREMENTS
============

 * MorphOS 3.x
 * Network connection
 * BBS address or phonebook entry


INSTALLATION
============

Extract the MTerm archive to your preferred location.

Run MTerm from Ambient, Shell, or your chosen launcher.


USAGE
=====

 * Start MTerm
 * Open or create a phonebook entry for the BBS you want to call
 * Connect to the selected BBS
 * Use CP437, Topaz (Amiga), or C64 mode for BBS entries where appropriate
 * Press <A>+Enter to cycle display size:
      normal -> medium -> fullscreen -> normal


SHORTCUTS
==================

 UP/DOWN          Select
 ENTER            Connect
 <A>-Enter        Cycle display size:              
 <A>-H            Hang-Up
 <A>-X            Quit
 <A>-A            Add a BBS Entry
 <A>-E            Edit the selected phonebook entry
 <A>-S            Sort BBS Entries
 <A>-D            Delete BBS Entry
 <A>-B            Buffer
 <A>-L            Send Login Credentials
 <A>-I            Import SyncTERM phone directory (syncterm.lst)
 <A>-P            Define Download/Upload Paths
 <A>-V            Paste from clipboard
 <A>-E            Phonebook while in an active session
 <A>-T            Toggle Title Bar while in active session
 <A>-Z            Help Menu
 <A>-S            Scale C64-40 (Fullscreen C64 Session) 
 CTRL-C           Run/Stop (C64 Session)


Startup Arguments
==================

  mterm                              Start phone book menu
  mterm host [port]                  Direct connect
  mterm -f | --fullscreen            Start in custom-screen fullscreen mode
  mterm -m | --medium                Start in medium windowed mode
  mterm -w | --windowed              Force normal windowed mode
  mterm -p phonebook                 Use alternate phone book file
  mterm -h                           Show help
  <A>-Enter cycles normal window     Scaled medium window -> fullscreen.


HISTORY
=======

0.19

   - New bitmap fonts
   - Commodore PETSCII rendering repairs
   - Added third-party font license/notice documentation
   - General fixes and display compatibility updates
   - Window title bar added  
   - Scroll wheel added to buffer window
   - Copy text now in orange
   - Performed general code cleanup
   - Added local beep functionality when a BBS triggers a beep  
   - Displayed current time in the main menu 
   - Title bar includes elapsed connected time  
   - Added option to define the startup mode for MTerm
   - GUI Tweaks
   - Menu tweaks and fixes
   - Copy / Paste in menus added  
   - Key mapping fixes
   - `<A>-X` shortcut now functions properly during active sessions  
   - `<A>-T` now toggles Title Bar during active sessions  

0.18
	- Added a notes section in the bbs entry
	- Added the ability to enter into phonebook during active session using <A>-E
	- Updated menus
	- Buffer and Active Phonebook Editing follows window positions
	- Updated copy/paste functions to work within phonebook

0.17
    - Fixed unable to connect popup
    - Window Mode Fixes
    - Updated BBS entry editing
    - Added shortcut "CMD-S" to save in bbs entry
    - Adjusted phonebook to have more room for bbs name
    - Added Sorting options for both BBS Name or Software
    - Added Favourite options for BBS Entries. Favourites are indicated by "*"
0.16
	- C64 fixes and updates
    - Display issue fixes
    - Added copy/paste functions
      (Copy from buffer, paste in connected window RMB)
    - Glyph corrections
    - Readme updates

0.15
	- Added in-session phonebook access with <A>+E
	- Phonebook opens while a BBS session remains connected
	- UI Enhancements
	- Temporary and backup of phonebook protection in case of 
	  corruption

0.14
   - Added CMD+Enter display cycling:
       normal -> medium -> fullscreen -> normal
   - Medium mode scales the terminal grid for easier reading
   - Improved fullscreen and medium-window behaviour

0.13
	- UI Enhancements
	- Bug fixes

0.12
   - Standardized disconnect handling
   - Remote closes and socket errors now show the centered
     "Disconnected" popup
   - Removed extra connection-ended messages after disconnect

0.11
   - Improved ANSI / terminal display behaviour
   - Improved BBS compatibility
   - Cleaned up terminal state handling between sessions

0.10
   - Initial MorphOS BBS terminal release


COPYRIGHT AND LICENSE
=====================

MTerm is provided as-is, without warranty of any kind.

Always keep backups of important files before uploading, downloading,
editing phonebook entries, or testing new builds.

MTerm is Copyright (c) 2026 n3 <clutchbbs.com>.

MTerm is freeware. The MTerm executable and MTerm-authored files may be
freely redistributed as part of the original archive.

This distribution may also include third-party runtime font files in the
Fonts/ directory. Those font files are separate runtime data files and are
not embedded in the MTerm executable. They remain under their own copyright
and license terms.


CONTACT
=======

Bug reports, suggestions and compatibility notes are welcome.

Support: telnet://clutchbbs.com / n3@clutchbbs.com