As the title says, CGTerm is an open source, platform independent terminal program for C/G telnet BBS:s. It's supposed to compile and run on any POSIX compliant OS with the SDL library installed.
First, download and install the SDL library if it's not included with your OS.
Edit the supplied Makefile
as needed, then run make
, and make install
.
cgterm [-d delay] [-f] [-k keyboard.kbd] [-o logfile] [-r seconds]
[-s] [-z zoom] [host [port]]
CGTerm looks for options in the following order: first it uses
anything specified on the command line, then it tries to read options
from a file called .cgtermrc
in your home directory, and if that fails
it tries to read from the system configuration file. The available
options are:
Config Key | Switch | Action |
---|---|---|
senddelay | -d | Delay between sent characters in milliseconds (default: 0) |
fullscreen | -f | Fullscreen mode |
keyboard | -k | Select keyboard configuration file (default: keyboard.kbd ) |
logfile | -o | Save window output |
zoom | -z | Window zoom factor (default: 2) |
reconnect | -r | Reconnect if disconnected within N seconds (default: 0 = off) |
host | 1st arg | Host to connect to |
port | 2nd arg | Port to connect to (default: 23) |
localecho | Enable local echo (default: no) | |
sound | -s | Enable sound playback (default: yes) |
columns | -4/-8 | 40 or 80 columns (default: 40) |
xferdir | Path to where you want to save file downloads. | |
bookmark | Add a host to the bookmark menu. Use the format alias, host, port. |
Certain program functions can be activated with hotkeys. These are bound to the Meta key (a.k.a. Command key) plus another key. You can also bring up a menu with Escape.
Key | Action |
---|---|
A | Abort loading or macro playback |
B | Open bookmarks |
C | Start/stop recording macro |
D | Connect/disconnect |
E | Toggle local echo |
F | Toggle fullscreen mode |
I | Set transfer dir or disk image |
L | Load SEQ file |
Q | Quit CGTerm |
R | Reconnect to last host |
S | Save screenshot to SEQ file |
T | Transfer files |
V | Play recorded macro |
Alt | Toggle lower/upper case font |
The scrollback buffer can be accessed with the Page Up and Page Down keys.
(If you're a Windows user, you can skip this section - it's only for Unix and Mac users).
As modern keyboards differ quite radically from the C64's, keys need
to be remapped. To make our lives even more difficult, different
countries have different keyboard layouts. The SDL library makes most
of this transparent, but not everything, so you need to supply a
keyboard configuration file. A couple of configuration files are
included with the source. If one of those works for you, simply edit
the config file and CGTerm will use it automatically. If you're not so
lucky, you'll need to create your own. The configuration file contains
two columns: a named C64 key to the left, and a keysym number to the
right. To find out the keysym number of a key, use the supplied
testkbd
program. Just hit a key and it'll print the keysym for
you. Once you've created a working configuration, please send it to me
so that I can include it in the next update.
CGTerm can receive files with the following protocols:
- Punter
- Xmodem
- Xmodem/CRC
- Xmodem-1k
and it can upload files with the following protocols:
- Xmodem
- Xmodem/CRC
- Xmodem-1k
Thanks to David Holz, Ullrich von Bassewitz, and Morphfrog for source patches. Thanks to Taper/3AD for running a BBS that makes it all worth it. Thanks also to all the beta testers.
As the title says, CGChat is an open source, platform independent client for 64CHAT. It's supposed to compile and run on any POSIX compliant OS with the SDL library installed.
First, download and install the SDL library if it's not included with your OS.
Edit the supplied Makefile
as needed, then run make
, and make install
.
cgchat [-4|-8] [-f] [-k keyboard.kbd] [-s] [-z zoom] [host [port]]
CGChat looks for options in the following order: first it uses
anything specified on the command line, then it tries to read options
from a file called .cgchatrc
in your home directory, and if that fails
it tries to read from the system configuration file. The available
options are:
Config Key | Switch | Action |
---|---|---|
fullscreen | -f | Fullscreen mode |
keyboard | -k | Select keyboard configuration file (default: keyboard.kbd ) |
zoom | -z | Window zoom factor (default: 2) |
reconnect | -r | Reconnect if disconnected within N seconds (default: 0 = off) |
host | 1st arg | Host to connect to |
port | 2nd arg | Port to connect to (default: 23) |
sound | -s | Enable sound playback (default: yes) |
columns | -4/-8 | 40 or 80 columns (default: 40) |
bookmark | Add a host to the bookmark menu. Use the format alias, host, port. |
Certain program functions can be activated with hotkeys. These are bound to the Meta key (a.k.a. Command key) plus another key. You can also bring up a menu with Escape.
Key | Action |
---|---|
A | Abort loading or macro playback |
B | Open bookmarks |
C | Start/stop recording macro |
D | Connect/disconnect |
F | Toggle fullscreen mode |
L | Load SEQ file |
Q | Quit CGTerm |
R | Reconnect to last host |
S | Save screenshot to SEQ file |
V | Play recorded macro |
Alt | Toggle lower/upper case font |
The scrollback buffer can be accessed with the Page Up and Page Down keys.
See the CGTerm documentation.
You can email me at MagerValp@cling.gu.se.
CGTerm is released under a slightly modified BSD license:
Copyright (c) 2003, Per Olofsson All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.