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

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                   2024    6048  33.5% -lh5- fbe5 May 22 07:33 MTerm.info
[Amiga]                    499    2048  24.4% -lh5- 3581 Jun  9 19:46 MTerm/Fonts/c64_lower.f8
[Amiga]                    526    2048  25.7% -lh5- aa9b Jun  9 19:46 MTerm/Fonts/c64_upper.f8
[Amiga]                   1100    2048  53.7% -lh5- 7216 Jun  9 20:38 MTerm/Fonts/cp437.f8
[Amiga]                   1309    3584  36.5% -lh5- c14e Jun  9 20:38 MTerm/Fonts/cp437.f14
[Amiga]                   1351    4096  33.0% -lh5- 4348 Jun  9 20:38 MTerm/Fonts/cp437.f16
[Amiga]                     51     784   6.5% -lh5- fb7e Jun  6 12:51 MTerm/Fonts/Topaz+1200.font
[Amiga]                   1464    2888  50.7% -lh5- 97a3 Jun  6 12:51 MTerm/Fonts/Topaz+1200/8
[Amiga]                   1493    4244  35.2% -lh5- 27ae Jun  6 12:51 MTerm/Fonts/Topaz+1200/14
[Amiga]                   1496    4696  31.9% -lh5- 4794 Jun  6 12:51 MTerm/Fonts/Topaz+1200/16
[Amiga]                   1484    3584  41.4% -lh5- f1b1 Jun  9 17:51 MTerm/Fonts/topaz_amiga.f14
[Amiga]                   1480    4096  36.1% -lh5- 43aa Jun  9 17:51 MTerm/Fonts/topaz_amiga.f16
[Amiga]                   1363    2913  46.8% -lh5- bec3 Jun  9 16:46 MTerm/Font_Licenses.txt
[Amiga]                   7432   16634  44.7% -lh5- 4ba3 May 18 01:08 MTerm/icon/mterm.info
[Amiga]                 160277  357136  44.9% -lh5- fc5e Jun 10 09:20 MTerm/MTerm
[Amiga]                   7452   16654  44.7% -lh5- 9d8e Jun  8 09:26 MTerm/MTerm.info
[Amiga]                     83      83 100.0% -lh0- 16cd Jun 10 09:33 MTerm/mterm.phonebook
[Amiga]                     73      90  81.1% -lh5- b7ae Jun  9 21:05 MTerm/mterm.prefs
[Amiga]                   2486    5772  43.1% -lh5- d100 Jun 10 08:59 MTerm/MTerm_0.19.readme
[Amiga]                     40      40 100.0% -lh0- 8d26 Jun  8 09:12 MTerm/MTerm_0.19.readme.info
[Amiga]                   2024    6048  33.5% -lh5- fbe5 May 22 07:33 MTerm/Transfers.info
[Amiga]                     23      23 100.0% -lh0- c7ec Jun  2 10:20 MTerm/Transfers/README.txt
[Amiga]                     40      40 100.0% -lh0- 8d26 May 22 07:41 MTerm/Transfers/README.txt.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        23 files  195570  445597  43.9%            Jun 10 14:25