MacWise - Macintosh Terminal Emulation - telnet / serial for OS X - Wyse, Viewpoint, VT100, VT220

Instructions for Installing Kermit for use with MacWIse
Kermit Installation is optional)


If your host requires Kermit file transfers, then read the following instructions for installing Kermit.

Kermit Installation is optional
If your host requires Kermit file transfers, then read the following instructions for installing Kermit.

Download Kermit from Columbia University
Look under the Apple heading for the version that matches your operating system version.
Note that Mac OSX Lion requires the X86_64 version which is Intel.
The file you download will have a rather cryptic name such as
This is not an installer file. (Do not double click on the file)
Rename this file to kermit (all lower case).
Then drag the kermit file into the kermit folder.
The kermit folder is in your user library folder. ( ~User/Library/Application Support/MacWise/kermit )
To locate this folder, open any finder window and click on your home icon. Then open the Library folder and look for Application Support/MacWise/kermit.

That's it. Now, put a check mark on Kermit under the MacWise Connection Menu and the next time you log into your host, you will be connected using Kermit.

1. Columbia University no longer supports or updates kermit. The project has been moved to The Kermit Project
The latest version of kermit will be there. Most likely, you will need to compile that version from the source code using the "make" command.

Note that you need to install Xcode before you can use the make command.

It is easy to compile the source code. Just read the makefile.
It will tell you the make command to use. For instance,
make macosx

It creates a file called wermit.
Just rename it to kermit and put it in the correct location (See note 5 below)

2. You can verify that kermit is working by opening a connection to the Mac unix shell. Your prompt should say C-Kermit>

3. If the download link for Kermit changes in the future, just go to and do a search for C-Kermit

4. If you have kermit working with MacWise on one Mac and would like to transfer it to another Mac, just copy the kermit folder from the working mac to the other mac.

5. MacWise versions prior to 12.2.8 looked for the kermit app in a different location
( ~User/library/kermit )
The old location is still supported in newer versions but the new preferred location is
~User/Library/Application Support/MacWise/kermit

MacWise looks for kermit in the old location first. If it is not there, it looks for it in the new location.
If you have it in the old location, it is best to delete it and put it in the new location to avoid confusion.

Kermit is a product of Columbia University
Carnation Software does not provide support for Kermit.
You can get more info at

MacWise is a product of Carnation Software



Kermit File Transfers with MacWise

Your host computer must support Kermit file transfers to take advantage of this feature.
To enable Kermit, select Kermit from the Connection Menu in MacWise.
Follow the installation instructions for Kermit.
Close the MacWise connection and re-open it. You will automatically log in using Kermit.
MacWise supports Kermit for telnet, ssh secure shell and Mac Unix Shell connections.

Receiving Files from the Host to your Mac

The nice thing about Kermit file transfers is that files are received automatically with no operator intervention.
(No MacWise menu items to select to start the data transfer).
Just look in your kermit_transfers folder for any files transferred.
If the host sends a file to you using the Kermit file transfer protocol, the file will be transfered to
your kermit_transfers folder in your documents folder

Note: If you have been using Accuterm on a PC, these commands may already be programmed into your host, since they are Accuterm compatible commands.

Kermit file transfers will occur automatically.
If your host sends a kermit file to MacWise, Kermit will detect it and start the transfer.
The following commands are not required but are supported if you want Accuterm compatibility.


ESC STX D p o m ; CR Start Data Transfer to download a file from the host to your Mac
(p = protocol A for ascii or K for Kermit)
(o = N for no overwrite or O to overwrite the existing file.)
(m = mode, T for text and B for Binary)

1. If the protocol is A for ascii, then only mode m text transfers are allowed.
2. File names and paths specified by the host are ignored.
3. Text transfers are sent to your Documents folder in a folder named pick.
4. Kermit transfers are sent to your Documents folder in a folder named kermit_transfers.
5. Kermit file transfers will always overwrite the existing file even if you have overwrite set to N.

ESC STX S Report File Transfer Status
Status: s f i l es f bytes b CR

where f is the number of files transferred, b is the number of
bytes transferred, and s is the transfer status:

0 = transfer successful
1 = unable to open file
2 = transfer aborted by operator
3 = file already exists
4 = terminated due to timeout
5 = terminated due to corrupted data
6 = invalid packet type
7 = terminated by remote program
8 = 8 data bits required for protocol
9 = software flow control not allowed for protocol

ESC STX C X End Capture


Sending Files from Your Mac to the Host


ESC STX Up m;path CR Upload a file from your Mac to the host.
Protocol p may be A(ASCII) or K (Kermit);
Mode m may be T(text) (MacWise currently only supports text file uploads)
Path is the drive, directory and file name of the file to send to the host.

This is a BASIC program you could use to tell MacWise to upload a file from the Mac to the host

001 ESC = CHAR(27):
002 STX = CHAR(2):
003 PRINT ESC:STX:"UKT;C:\SomeFolder\MyFile.txt"
004 END


1. MacWise ignores the C: since that is a DOS drive name.

2. SomeFolder can be any folder name you choose.

3. MyFile.txt can be any name that you choose, however it must be a text file with extension .txt

4. SomeFolder must be in the User's Documents folder.

5. If the protocol is specified as A for ASCII, then Kermit will not be used and MacWise will send the file to the host as a non-error checking text file upload. If K for Kermit is specified then Kermit will do the file transfer and it will use error checking.


Kermit is a product of Columbia University

Carnation Software does not provide support for Kermit.

You can get more info at

MacWise is a product of Carnation Software