4 # This file allows full customization of the user interface.
6 # The standard client looks for this file in:
8 # 2. /usr/local/lib/citadel.rc
9 # 3. <compiled BBSDIR>/citadel.rc
10 # 4. <current directory>/citadel.rc
12 # Set ENCRYPT to yes to force SSL/TLS encryption when connecting to a
13 # Citadel/UX server, even if the server is on the same machine as the
14 # client. Set it to no to disable SSL/TLS encryption. The default is to
15 # enable encryption for remote systems and to disable encryption for
16 # systems on the same machine as the client.
19 # Set EDITOR to the name of an external editor to be used for entering
20 # messages. If you want the external editor to be used by default, be sure
21 # to reflect this in the command set below.
25 # If you define PRINTCMD, it will be a pipe through which messages are
26 # printed when the user hits the <P>rint key after a message.
30 # If you define EXPCMD, it will be a pipe through which any incoming
31 # express messages will be printed.
32 #expcmd=xmessage -title "Express Message" -center -buttons OK -file -
34 # If LOCAL_SCREEN_DIMENSIONS is set to 1, then the screen dimensions will
35 # be requested from the underlying operating system instead of asking the
36 # user. This works when the user has his/her own copy of the client, it
37 # works for xterms, it sometimes works for telnet sessions, but it doesn't
38 # work for dialup connections. Generally you should set this to 1 for a
39 # private copy of the client or 0 for a shared copy of the client.
41 local_screen_dimensions=1
43 # ANSI_COLOR should be set to on/off/auto/user to control the use of
44 # color on the screen. If it is set to "auto" then an autodetect will be
45 # attempted. If it is set to "user" then it's a user-configurable option.
49 # If DISPLAY_MESSAGE_NUMBERS is set to 1, then messages will be displayed
50 # with their message numbers in the header. This is ugly but some
51 # people seem to like it anyway...
53 display_message_numbers=0
55 # The FORCE_MAIL_PROMPTS directive causes mail rooms to always display a
56 # prompt after each message, even if the user has prompts turned off.
60 # USE_FLOORS determines whether the user sees floors, or a flat room space.
61 # Set it to YES to always use floors, NO to never use floors, or DEFAULT
62 # to use the setting in the user's configuration (which is normally the case).
66 # BEEP should be set to 1 if you wish the terminal to beep when an express
67 # message (page) comes in, otherwise set it to 0.
71 # ALLOW_ATTACHMENTS should be set to 1 if you wish the user to be able to
72 # attach files to messages and/or save attachments to disk while reading
73 # messages. (DANGER: do NOT enable this for "safe" public clients!)
78 # If you set REMEMBER_PASSWORDS to 1, the Citadel client will offer to
79 # remember your user name and password for every Citadel server you access,
80 # automatically logging in with them on subsequent visits.
81 # (DANGER: do NOT enable this for "safe" public clients!)
85 # Optionally, you can force the same username and password everywhere. This
86 # obviously isn't as robust as the password manager.
88 #username=My User Name
91 # If URLCMD is defined, users can hit 'U' after reading a message which
92 # contains embedded URL's, and the command will be executed. Usually this
93 # will be used to remote-control a web browser. (Do not enable this command
94 # for 'safe' public clients.)
96 #urlcmd=netscape -remote "openURL(%s)"
99 # COMMAND SET CONFIGURATION
101 # All lines starting with "cmd=" are considered to be commands. This allows
102 # mapping of keytstrokes to various functions of the client.
104 # Format of each line:
105 # cmd_num,access,keystrokes
107 # Keep a copy of the original version of this file around as a reference
108 # for the command numbers. They are not documented anywhere else.
110 # Access is: 0 (all users), 1 (aides or room aides), 2 (aides only).
111 # Please be aware that it is futile to attempt to gain unauthorized access to
112 # the administrative functions of the system by changing all the access levels
113 # to 0. If you do this, you'll simply be able to enter a lot of commands that
114 # will fail at the server ... so don't bother trying. :-)
116 # The actual key to be pressed should be prefaced with an & (ampersand)
117 # character. Ampersands are interesting and useful characters and you should
118 # use them as much as possible. Commands requiring more than one keystroke
119 # should be entered as multiple fields.
121 # If the last keystroke string ends with a : (colon), then the command
122 # will finish by allowing the user to enter a string.
124 # In keystroke names, the string ^r will be replaced by the name of the
125 # current room. The string ^c will be replaced by a comma.
127 # Commands may contain no more than five keystrokes.
129 # Note that the following characters are illegal in commands:
130 # , (comma) : (colon) ^ (caret) & (ampersand)
138 # If you want to use an external editor by default, set <E>nter message
139 # to command #46 (external editor) instead of #4 (built-in editor).
140 cmd=4,0,&Enter message
144 cmd=7,0,&Zap (forget) room
146 cmd=9,0,&Last five msgs
147 cmd=10,0,read &Forward
148 cmd=11,0,read &Reverse
151 cmd=14,0,read &Directory
154 cmd=17,0,&Who is online
155 cmd=47,0,&Abandon ^r^c goto...
156 cmd=50,0,toggle e&Xpert mode
157 cmd=49,0,read &Info file
159 cmd=19,0,&.,list &Zapped rooms
160 cmd=52,0,&.,&Skip ^r^c goto:
161 cmd=56,0,&Page a user
165 # We implement both <.G>oto and <J>ump commands which do the same thing, in
166 # order to please a wider audience of users. Remove one if you want to.
172 cmd=22,1,&.,&Aide,&Kill this room
173 cmd=23,1,&.,&Aide,&Edit this room
174 cmd=24,1,&.,&Aide,&Who knows room
175 cmd=25,2,&.,&Aide,edit &User
176 cmd=26,2,&.,&Aide,&Validate new users
177 cmd=48,1,&.,&Aide,enter &Info file
178 cmd=27,1,&.,&Aide,&Room,&Invite user
179 cmd=28,1,&.,&Aide,&Room,&Kick out user
180 cmd=51,1,&.,&Aide,&File,&Delete
181 cmd=53,1,&.,&Aide,&File,&Send over net
182 cmd=54,1,&.,&Aide,&File,&Move
183 cmd=70,2,&.,&Aide,&Message edit:
184 cmd=78,1,&.,&Aide,&Post
185 cmd=80,2,&.,&Aide,&System configuration,&General
186 cmd=82,2,&.,&Aide,&System configuration,&Internet
187 cmd=83,2,&.,&Aide,&System configuration,check &Message base
188 cmd=88,2,&.,&Aide,&System configuration,&Network
189 cmd=85,2,&.,&Aide,&Terminate server,&Now
190 cmd=86,2,&.,&Aide,&Terminate server,&Scheduled
191 cmd=87,1,&.,&Aide,mailing &List management
192 cmd=89,1,&.,&Aide,&Network room sharing
194 cmd=29,0,&.,&Terminate,and &Quit
195 cmd=30,0,&.,&Terminate,and &Stay online
197 # The 'read user listing' command accepts two different formats. The one with
198 # the trailing colon allows the user to enter a few characters to search for
199 # users with a partial match.
201 cmd=32,0,&.,&Read,&User listing
202 cmd=32,0,&.,&Read,&User listing:
204 cmd=33,0,&.,&Read,&Textfile formatted
206 # Command 55 allows the user to save a downloaded file directly to the
207 # computer running the client software. It is appropriate for a copy of
208 # this client running on the user's own computer. It is NOT appropriate for
209 # public copies of the client that people will be dialing into.
211 #cmd=55,0,&.,&Read,&File
213 # Commands 34, 43, and 45 are appropriate for public copies of the client for
214 # dialup use. They transfer downloaded files to a temporary file and then
215 # send them along to a dialup user using the popular protocols.
217 cmd=34,0,&.,&Read,file using &Xmodem
218 cmd=43,0,&.,&Read,file using &Ymodem
219 cmd=45,0,&.,&Read,file using &Zmodem
220 cmd=31,0,&.,&Read,&File unformatted
222 cmd=13,0,&.,&Read,&New messages
223 cmd=12,0,&.,&Read,&Old msgs reverse
224 cmd=71,0,&.,read &Last:
225 cmd=9,0,&.,&Read,&Last five msgs
226 cmd=14,0,&.,&Read,&Directory
227 cmd=49,0,&.,&Read,&Info file
228 cmd=35,0,&.,&Enter,&Password
229 cmd=36,0,&.,&Enter,&ASCII message
230 cmd=37,0,&.,&Enter,&Configuration
231 cmd=38,0,&.,&Enter,a new &Room
232 cmd=39,0,&.,&Enter,&Textfile
233 cmd=77,0,&.,&Enter,&Username
234 cmd=40,0,&.,&Enter,file using &Xmodem
235 cmd=42,0,&.,&Enter,file using &Ymodem
236 cmd=44,0,&.,&Enter,file using &Zmodem
238 # Command 57 is the local-file-upload command for users with their own
239 # copy of the clientware. Commands 72-74 are for image uploads.
241 #cmd=57,0,&.,&Enter,&File
242 #cmd=72,0,&.,&Enter,&Image,user &Picture
243 #cmd=73,0,&.,&Enter,&Image,&Room banner
244 #cmd=74,0,&.,&Enter,&Image,&Floor label
246 cmd=41,0,&.,&Enter,re&Gistration
247 cmd=4,0,&.,&Enter,&Message
248 cmd=46,0,&.,&Enter,message with &Editor
250 cmd=59,0,&;,&Configure floor mode
251 cmd=60,0,&;,&Goto floor:
252 cmd=61,0,&;,&Skip to floor:
253 cmd=62,0,&;,&Zap (forget) floor
254 cmd=63,2,&;,&Aide,&Create floor
255 cmd=64,2,&;,&Aide,&Edit floor
256 cmd=65,2,&;,&Aide,&Kill floor
257 cmd=68,0,&;,&Known rooms
258 cmd=66,0,&.,&Enter,&Bio
259 cmd=67,0,&.,&Read,&Bio
261 cmd=79,0,&.,&Wholist,&Long
262 cmd=75,0,&.,&Wholist,&Roomname
263 cmd=76,0,&.,&Wholist,&Hostname
266 # Command 69 allows the user to enter a server command directly. It is
267 # primarily for testing and not intended for general use. Usually there
268 # is no need to enable it.
269 cmd=69,0,&@Server command:
271 # end of command set configuration