Home

Getting Started

Hey | 😃 👋 | thanks for checking out ANSiTerm2!

1. About
2. Installation
3. Installation via BBS

About

Why ANSiTerm2? Because there's nothing else like it!

ANSiTerm2 was created to fill a somewhat recent gap in the lack of free and useable BBS client on the latest versions of macOS. This stems from the pitfalls and issues I encountered trying to run a useable BBS client on a brand new Mac. I've detailed some of these issues below:

• SyncTERM is DOA. Due to SIP and a unmaintained code base, SyncTERM's frameworks are unsigned and filled with imminent crashes. This effectively curbs it's use on newer macOS machines.

• The standard Terminal.app and even the stock iTerm.app simply cannot handle the legacy standards of BBS systems. They can't handle the color-codes, fonts, widths, backspace, and fairly importantly; a modem client for file transfers. (I recommend you try though, just so you can experience how bad it really is)

• If I came across an client that was reported to work on macOS, it was always a paid product.

• future rambling placeholder...

Features

• Secure install and update:
  • Installation package is only served over HTTPS.
  • Installation package is verified via a SHA256 checksum.
  • Installation package is "Apple Developer" codesigned, and this costs money.
    • I am doing this to show my commitment and intentions to support it.
• Totally hackable:
  • Every aspect of ANSiTerm2 can be changed through iTerms configuration menu's
• Trigger interface:
  • explain trigger interface

Dependencies

To use ANSiTerm2, you only need two things:

1. Mac Computer (10.9+)
2. brew

Installation

Installation of the latest ANSiTerm2 is simple (and plans to be EVEN simpler in the future once it's been submitted to brew after beta testing):

brew cask install https://raw.githubusercontent.com/watbulb/ANSiTerm2/master/ansiterm2.rb

Installation via BBS archive

If you happened to come across this fantastic warez among a ArakNET board, the steps are as follows:

1. Unzip the archive
2. Run the following within the root of the extracted archive: make install_local

Upgrading

Since ANSiTerm2 is installed using brew, updates are provided automatically as they become available. If you'd still like to manually update it, issue the following:

brew cask upgrade ansiterm2

Uninstallation

brew cask uninstall ansiterm2

Note: ⚠️ This will delete all files in ~/.config/ansiterm2

Developing ANSiTerm2

Please refer to the HACKING.md guide.