forked from MagerValp/CGTerm
-
Notifications
You must be signed in to change notification settings - Fork 0
/
cgterm.txt
164 lines (122 loc) · 5.24 KB
/
cgterm.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
CGTerm 1.6 - a platform independent C/G terminal
------------------------------------------------
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.
Installation (UNIX)
-------------------
First, download and install the SDL library if it's not included with
your OS:
http://www.libsdl.org/download-1.2.php
Edit the supplied Makefile as needed, then run make, and make install.
Usage
-----
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.
Hotkeys
-------
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.
Keyboards
---------
(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.
File Transfer
-------------
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
Acknowledgements
----------------
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.
Contact
-------
You can email me at MagerValp@cling.gu.se.
License
-------
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.