FAQ.html

   1 <HTML><HEAD><TITLE>
   2 XBoard and WinBoard: Frequently Asked Questions</TITLE></HEAD>
   3 <BODY>
   4 <H1>XBoard and WinBoard: Frequently Asked Questions</H1>
   5
   6 This document answers some frequently asked questions about the
   7 graphical chess interfaces XBoard and WinBoard.
   8 A hyperlinked version of this FAQ is available on
   9 the Web through the page
  10 <A HREF=
  11 "http://www.tim-mann.org/chess.html"
  12 >http://www.tim-mann.org/chess.html</A>.
  13
  14 <HR>
  15 <H2>Outline</H2>
  16
  17 <UL>
  18 <LI><A HREF="#[A0]">[A] Introduction and hot topics</A></LI>
  19 <LI><A HREF="#[B0]">[B] XBoard and WinBoard</A></LI>
  20 <LI><A HREF="#[C0]">[C] XBoard and WinBoard, bugs and problems</A></LI>
  21 <LI><A HREF="#[D0]">[D] Crafty and other topics</A></LI>
  22 </UL>
  23
  24 <HR>
  25 <H2>Detailed contents</H2>
  26
  27 <UL>
  28 <LI><A NAME="[A0]" HREF="#[A]">[A] Introduction and hot topics</A></LI>
  29 <UL>
  30 <LI><a href="#[A.1]">[A.1] What are XBoard and WinBoard?</a></li>
  31 <LI><A HREF="#[A.2]">[A.2] Where can I get chess information and chess
  32   software?</A></LI>
  33 <LI><A HREF="#[A.3]">[A.3] What are the current version numbers for
  34   XBoard and WinBoard?</A></LI>
  35 <LI><A HREF="#[A.4]">[A.4] Who is working on this project?</A></LI>
  36 <LI><A HREF="#[A.5]">[A.5] How do I report bugs, offer help, etc.?</A></LI>
  37 </UL>
  38
  39 <LI><A NAME="[B0]" HREF="#[B]">[B] XBoard and WinBoard</A></LI>
  40 <UL>
  41 <LI><A HREF="#[B.1]">[B.1] What is XBoard?</A></LI>
  42 <LI><A HREF="#[B.2]">[B.2] Is there an XBoard for Microsoft Windows?  What is
  43   WinBoard?  How do I install WinBoard?</A></LI>
  44 <LI><A HREF="#[B.3]">[B.3] Is there an XBoard for the Amiga?  What is
  45   AmyBoard?</A></LI>
  46 <LI><A HREF="#[B.4]">[B.4] Is there an XBoard for the Macintosh?</A></LI>
  47 <LI><A HREF="#[B.5]">[B.5] Does XBoard run on VMS?</A></LI>
  48 <LI><A HREF="#[B.6]">[B.6] What is cmail?</A></LI>
  49 <LI><A HREF="#[B.7]">[B.7] How do I build XBoard?  Do I have to have
  50   gcc?</A></LI>
  51 <LI><A HREF="#[B.8]">[B.8] Can I use XBoard or WinBoard to play a game
  52   of chess with another human?</A></LI>
  53 <LI><A HREF="#[B.9]">[B.9] Will WinBoard run on Windows 3.1?
  54   How about Windows CE (also known as Pocket PC)?</A></LI>
  55 <LI><A HREF="#[B.10]">[B.10] How do I use XBoard or WinBoard as an external
  56   viewer for PGN files with my Web browser?</A></LI>
  57 <LI><A HREF="#[B.11]">[B.11] How do I use WinBoard as an external viewer for
  58   PGN files with the MS Windows File Manager or Explorer?</A></LI>
  59 <LI><A HREF="#[B.12]">[B.12] How do I use ICC timestamp or FICS timeseal
  60   with XBoard?</A></LI>
  61 <LI><A HREF="#[B.13]">[B.13] How do I use ICC timestamp or FICS timeseal
  62   with WinBoard?</A></LI>
  63 <LI><A HREF="#[B.14]">[B.14] How do I play bughouse with XBoard or WinBoard?
  64 </A></LI>
  65 <li><a href="#[B.16]">[B.16]
  66   What is Zippy?  How can I interface a chess program to the Internet
  67   Chess Servers?</a></li>
  68 <li><a href="#[B.17]">[B.17]
  69   How can I interface my own chess program to XBoard or WinBoard?</a></li>
  70 <li><a href="#[B.18]">[B.18]
  71   How can I recompile WinBoard from source?</a></li>
  72 <li><a href="#[B.19]">[B.19]
  73   How can I use XBoard or WinBoard to talk
  74   to an Internet Chess Server through a firewall or proxy?</a></li>
  75 <li><a href="#[B.20]">[B.20]
  76   How can I use XBoard or WinBoard on chess.net with accuclock?</a></li>
  77 <li><a href="#[B.21]">[B.21]
  78   Can I get Zippy to do one or more ICS commands automatically at the
  79   start or end of each game?</a></li>
  80 <li><a href="#[B.22]">[B.22]
  81   How do I print from WinBoard?</a></li>
  82 <li><a href="#[B.23]">[B.23]
  83   Can I get Zippy to automatically reconnect to ICS when its connection
  84   breaks?</a></li>
  85 <li><a href="#[B.24]">[B.24]
  86   The chess engines are too strong and always beat me.  How can I adjust
  87   the difficulty level to make them weaker?</a></li>
  88
  89 </UL>
  90
  91 <LI><A NAME="[C0]" HREF="#[C]">[C] XBoard and WinBoard, bugs and
  92   problems</A></LI>
  93 <UL>
  94 <LI><A HREF="#[C.1]">[C.1] I can't build XBoard because the
  95   X11/Xaw/... include files are not found.</A></LI>
  96 <LI><A HREF="#[C.2]">[C.2] Configuring or building XBoard fails due to
  97   missing header files, missing libraries, or undefined symbols.</a></li>
  98 <LI><A HREF="#[C.3]">[C.3] I have problems using WinBoard on ICS with a modem.
  99   I'm not running SLIP or PPP, but just dialing in to an ordinary login account
 100 ("shell account").</A></LI>
 101 <LI><A HREF="#[C.4]">[C.4]
 102   I have problems using WinBoard on ICS with Windows 95 and SLIP
 103   or PPP.  When trying to start up, it gets the error "Address family
 104   not supported by protocol family" (or some equally strange message).
 105 </A></LI>
 106 <LI><A HREF="#[C.5]">[C.5] When I try to run WinBoard, I get the message
 107   "Failed to start chess program gnuchess on localhost: NO LANGFILE (file
 108   gnuchess.lan not found)".</A></LI>
 109 <LI><A HREF="#[C.6]">[C.6] I want to use XBoard or WinBoard as an Internet
 110   Chess Server interface, but the ICS Client option is grayed out on the
 111   menu.</A></LI>
 112 <LI><A HREF="#[C.7]">[C.7] How do I give command-line options to
 113   a Windows program like WinBoard?</A></LI>
 114 <LI><A HREF="#[C.9]">[C.9]
 115   When I exit from WinBoard after using it to play against a chess
 116   program on my machine, the chess program keeps running in the background.
 117 </A></LI>
 118 <li><a href="#[C.12]">[C.12]
 119   Why do my ICS
 120   opponents often get extra time after they make their moves?
 121   Why do I sometimes lose time off my clock after I make my move?
 122 </a></li>
 123 <li><a href="#[C.13]">[C.13]
 124   I can't run WinBoard unless I delete the WinBoard.ini file each time!
 125 </a></li>
 126 <li><a href="#[C.15]">[C.15]
 127   I get errors compiling XBoard's parser.c.
 128 </a></li>
 129 <li><a href="#[C.16]">[C.16]
 130   I get an error building WinBoard from source because "flex" is not found.
 131 </a></li>
 132 <li><a href="#[C.17]">[C.17]
 133   XBoard hangs shortly after connecting to an ICS when used with dxterm,
 134   cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.
 135 </a></li>
 136 <li><a href="#[C.18]">[C.18]
 137   The WinBoard pieces show up in the wrong colors, appear distorted,
 138   or are not visible at all.
 139 </a></li>
 140 <LI><A HREF="#[C.19]">[C.19] XBoard or WinBoard tells me
 141 "Error: first chess program (...) exited unexpectedly".</A></LI>
 142 <li><a href="#[C.20]">[C.20]
 143   XBoard tells me "Warning: Cannot allocate colormap entry".
 144 </a></li>
 145 <li><a href="#[C.21]">[C.21]
 146   When I log in to freechess.org, the Enter key doesn't work, and I
 147   have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't
 148   work either, so I'm stuck.
 149 </a></li>
 150 <li><a href="#[C.22]">[C.22]
 151   XBoard says, "Failed to start first chess program gnuchessx
 152   on localhost: gnuchessx: No such file or directory."
 153 </a></li>
 154 </UL>
 155
 156 <LI><A NAME="[D0]" HREF="#[D]">[D] Crafty and other topics</A></LI>
 157 <UL>
 158 <LI><A HREF="#[D.1]">[D.1] What is XChess?</A></LI>
 159 <LI><A HREF="#[D.2]">[D.2] What is Winsock Chess?</A></LI>
 160 <LI><A HREF="#[D.3]">[D.3] What is Crafty?</A></LI>
 161 <LI><A HREF="#[D.4]">[D.4] How do I use Crafty with XBoard?</A></LI>
 162 <LI><A HREF="#[D.5]">[D.5] How do I use Crafty with WinBoard?</A></LI>
 163 <LI><A HREF="#[D.6]">[D.6] How do I use GNU Chess 5 with XBoard?</A></LI>
 164 </UL>
 165 </UL>
 166
 167 <HR>
 168 <H2><A NAME="[A]">[A] Introduction and hot topics</A></H2>
 169 <HR>
 170 <H3><A NAME="[A.1]">[A.1] What are XBoard and WinBoard?</A></H3>
 171
 172 XBoard and WinBoard are graphical user interfaces for chess.
 173 XBoard runs with the X Window System on Unix systems (including
 174 GNU/Linux); see topic
 175 <A HREF="#[B.1]">[B.1]</A>.
 176 WinBoard runs on true 32-bit Microsoft Windows operating
 177 systems, such as Windows 95, 98, NT,
 178 2000, ME, XP, and should continue to work
 179 on future 32-bit Windows systems.  It does
 180 not work on Windows CE (also known as Pocket PC), nor does it work on
 181 16-bit Windows systems such as Windows 3.1.  See topic
 182 <A HREF="#[B.2]">[B.2]</A>.
 183
 184 <HR>
 185 <H3><A NAME="[A.2]">[A.2] Where can I get chess information and chess
 186 software?</A></H3>
 187
 188 As a shortcut to most things mentioned in this FAQ, try my Chess Web page,
 189 <A HREF=
 190 "http://www.tim-mann.org/chess.html"
 191 >http://www.tim-mann.org/chess.html</A>.
 192 My Web page is the best place to get the latest versions of XBoard and WinBoard
 193 and the most up-to-date version of this FAQ.
 194
 195 <p>If you have other questions about XBoard/WinBoard that aren't answered
 196 in this FAQ, you can try Aaron Tay's WinBoard and Chess Engines FAQ, at
 197 <a href="http://www.chesskit.com/aarontay/Winboard/Winboard.html"
 198 >http://www.chesskit.com/aarontay/Winboard/Winboard.html</a>.
 199
 200 <P>For general news and information about chess, try the newsgroup hierarchy
 201 rec.games.chess.*, especially the groups rec.games.chess.misc and
 202 rec.games.chess.computer.  Both of the latter groups have very informative
 203 FAQs maintained by Steve Pribut; look for them on the newsgroups or at
 204 <A HREF=
 205 "http://www.clark.net/pub/pribut/chess.html"
 206 >http://www.clark.net/pub/pribut/chess.html</A>.
 207
 208 <P>Like other GNU software, you can get XBoard, and
 209 WinBoard by anonymous FTP from
 210 <A HREF=
 211 "ftp://ftp.gnu.org/pub/gnu/"
 212 >ftp://ftp.gnu.org/pub/gnu/</A>
 213 and its many mirror sites.  Look in the subdirectories xboard, and winboard.
 214 The .tar.gz suffix on the files there indicates they were packed with tar
 215 and compressed with gzip.  The .exe or .zip suffixes indicate files that
 216 were packed and compressed with zip.
 217
 218 <P>For other chess software, try the Internet Chess Library.  Use anonymous FTP
 219 to connect to ftp.freechess.org, or go to the Web page
 220 <A HREF=
 221 "http://www.freechess.org/"
 222 >http://www.freechess.org/</A>.
 223 You can get chess software, game
 224 collections, the FAQ file for rec.games.chess, and other chess-related
 225 material there, in the directory pub/chess.  The FTP server can
 226 automatically decompress files for you as you download them, useful if you
 227 don't have gzip.
 228
 229 <P>Here is a sample anonymous ftp session.  Some of the ftp server's responses
 230 are abbreviated, but all the commands you must type are included.
 231
 232 <p><PRE>
 233     % ftp ftp.gnu.org
 234     Connected to ftp.gnu.org
 235     Name: anonymous
 236     Password: your-email-address@your-site
 237     ftp&gt; binary
 238     200 Type set to I.
 239     ftp&gt; cd /pub/gnu/xboard
 240     ftp&gt; dir
 241     -rw-r--r-- 1 14910 wheel  393119 May 20 00:25 xboard-4.2.6.tar.gz
 242     ftp&gt; get xboard-4.2.6.tar.gz
 243     150 BINARY connection for xboard-4.2.6.tar.gz (393119 bytes).
 244     226 Transfer complete.
 245     ftp&gt; quit
 246 </PRE>
 247
 248 <HR>
 249 <H3><A NAME="[A.3]">[A.3] What are the current version numbers for
 250 XBoard and WinBoard?</A></H3>
 251
 252 At this writing, the current version numbers are:
 253
 254 <UL>
 255 <LI>XBoard 4.2.6</LI>
 256 <LI>WinBoard 4.2.6</LI>
 257 </UL>
 258
 259 <HR>
 260 <H3><A NAME="[A.4]">[A.4] Who is working on this project?</A></H3>
 261
 262 Tim Mann maintains this FAQ and is the lead developer on XBoard and
 263 WinBoard, but he has little time to work on the project.  Many others
 264 occasionally contribute suggestions and snippets of code, for which we
 265 are grateful.
 266
 267 <HR>
 268 <H3><A NAME="[A.5]">[A.5] How do I report bugs, offer help, etc.?</A></H3>
 269
 270 <P>At present, bug reports, suggestions, and offers to help on XBoard
 271 or WinBoard should be sent directly to tim@tim-mann.org (Tim Mann).
 272 Beginner questions and discussion about the program may get faster
 273 answers on the WinBoard Forum at <a
 274 href="http://f11.parsimony.net/forum16635/"
 275 >http://f11.parsimony.net/forum16635/</a>.  If you are developing a
 276 chess engine that works with XBoard or WinBoard (or an alternative
 277 GUI that works with such engines), see the Chess Engines mailing
 278 list, hosted at
 279 <a href="http://groups.yahoo.com/group/chess-engines"
 280 >http://groups.yahoo.com/group/chess-engines</a>.
 281
 282 <P>Any time you want to report a possible bug in XBoard or WinBoard,
 283 we need to know exactly what you did, and exactly what error (or
 284 other) messages you got.
 285
 286 <P>If you are using Unix, run the "script" program, run XBoard with
 287 the -debug flag (if you get as far as running it), do whatever is
 288 necessary to reproduce the problem, type "exit" to the shell, and mail
 289 us the resulting typescript file.  We also need to know what
 290 hardware/operating system combination you are using.  The command
 291 "uname -a" will usually tell you this; include its output in your
 292 typescript.
 293
 294 <P>If you are using MS Windows, run WinBoard with the -debug flag, and
 295 send us a copy of the WinBoard.debug file.  If you aren't sure how to
 296 add command-line flags to WinBoard, you can hit Ctrl+Alt+F12 to create
 297 a WinBoard.debug file after WinBoard starts, but that is not as good,
 298 because a few messages that would have been printed at the start are
 299 lost.
 300
 301 <p>Either way, please send us the exact text of the commands you typed
 302 and the output you got, not just your recollection of approximately
 303 what they were.  The messages may seem meaningless to you, but they
 304 are very meaningful to us and essential for diagnosing problems.
 305
 306 <HR>
 307 <H2><A NAME="[B]">[B] XBoard and WinBoard</A></H2>
 308 <HR>
 309 <H3><A NAME="[B.1]">[B.1] What is XBoard?</A></H3>
 310
 311 XBoard is a graphical user interface for chess.  It displays a
 312 chessboard on the screen, accepts moves made with the mouse, and loads
 313 and saves games in Portable Game Notation (PGN).  XBoard is free software.
 314 It serves as a front-end for many different chess services, including:
 315
 316 <p><strong>Chess engines</strong> that will run on your machine and
 317 play a game against you or help you analyze, such as GNU Chess and
 318 Crafty (topic <A HREF="#[D.3]">[D.3]</A> below).
 319
 320 <p><strong>Chess servers</strong> on the Internet, where you can
 321 connect to play chess with people from all over the world, watch other
 322 users play, or just hang out and chat.
 323
 324 <p><strong>Correspondence chess</strong> played by electronic
 325 mail. The cmail program (topic <A HREF="#[B.6]">[B.6]</A> below)
 326 automates the tasks of parsing email from your opponent, playing his
 327 moves out on your board, and mailing your reply move after you've
 328 chosen it.
 329
 330 <p><strong>The Web</strong> and your own saved games. You can use
 331 XBoard as a helper application to view PGN games in your
 332 Web browser, or to load and save your own PGN files.
 333
 334 <P>XBoard runs under Unix or Unix-compatible systems.  It requires the
 335 X Window System, version X11R4 or later.  There are also ports of
 336 XBoard to 32-bit Microsoft Windows and to
 337 the Amiga.  See topics <A HREF="#[B.2]">[B.2]</A> and <A
 338 HREF="#[B.3]">[B.3]</A> respectively.
 339
 340 <HR>
 341 <H3><A NAME="[B.2]">[B.2] Is there an XBoard for Microsoft Windows?  What is WinBoard?  How do I install WinBoard?</A></H3>
 342
 343 WinBoard is a port of XBoard to 32-bit Microsoft Windows systems, such
 344 as Windows 95, 98, NT, 2000, ME, and XP.  It uses the same back end
 345 chess code as XBoard, but the front end graphics code is a complete
 346 rewrite.  WinBoard is free software.
 347
 348 <P>The WinBoard distribution includes a port of GNU Chess to Win32.
 349 The GNU Chess port is distributed in executable form, with instructions for
 350 rebuilding it from the standard GNU Chess sources (available separately).  You
 351 should have at least 16 to 24 MB of memory to run GNU Chess with WinBoard.
 352
 353 <P>The WinBoard distribution also includes the ICC timestamp and FICS
 354 timeseal programs (topic <A HREF="#[B.12]">[B.12]</A>).
 355
 356 <P>cmail (topic <A HREF="#[B.6]">[B.6]</A>) has not been ported to
 357 Windows.  All the other XBoard functions are included in WinBoard.
 358 The International Email Chess Group web site at <a
 359 href="http://www.iecg.org/" >http://www.iecg.org/</a> recommends
 360 ECTool (<a href="http://www.ectool.nu/" >http://www.ectool.nu/</a>)
 361 for playing correspondence chess under Windows.
 362
 363 <p>You install WinBoard as follows. Download the WinBoard package to
 364 your PC (see topic <A HREF="#[A.2]">[A.2]</A>).  It will be a file
 365 with a name like winboard-4_0_0.exe.  Double-click on this file
 366 in the Explorer or File Manager to run it. Follow the on-screen
 367 prompts.
 368
 369 <HR>
 370 <H3><A NAME="[B.3]">[B.3] Is there an XBoard for the Amiga?  What is AmyBoard?</A></H3>
 371
 372 AmyBoard is a port of XBoard to the Amiga, by Jochen Wiedmann.
 373 The distribution includes a port of GNU Chess.
 374 AmyBoard is free software.
 375
 376 <p>The current version of AmyBoard is 330.5 (based on XBoard 3.3.0).
 377 No one is currently maintaining it.
 378
 379 <P>System requirements:
 380
 381 <UL>
 382 <LI>An Amiga (obviously :-), running OS 2.04 or later, 2Mb RAM or more.</LI>
 383 <LI>MUI 2.0 or later.</LI>
 384 <LI>Workbench or another screen with no less than 640x400 pixels (adjustable
 385   with the MUI-Prefs); this restriction is just because we don't have
 386   bitmaps with less than 40x40 pixels per square. If someone contributes
 387   bitmaps with 20x20 or 20x25, they will work with any Hires mode.</LI>
 388 </UL>
 389 <P>
 390 If you would like to use an ICS, you need an Internet connection via either
 391
 392 <UL>
 393 <LI>a telnet-like program, or</LI>
 394 <LI>a terminal program reading from stdin and writing to stdout.</LI>
 395 </UL>
 396 <P>
 397 AmyBoard is available in the Internet Chess Library (topic <A HREF="#[A.2]">[A.2]</A>).
 398
 399 <HR>
 400 <H3><A NAME="[B.4]">[B.4] Is there an XBoard for the Macintosh?</A></H3>
 401
 402 Because MacOS X has a Unix base, XBoard will compile and run on it.
 403 You do need an X11 (X Window System) server and client libraries.
 404 These do not come with Mac OS, but both free and commercial versions
 405 are available.  Once you install the X11 package, XBoard is reported
 406 to compile and run without changes.
 407
 408 There is no version of XBoard or WinBoard that runs with the native
 409 (non-X11) Mac graphical interface, and none that runs on MacOS 9 or
 410 earlier.
 411
 412 <HR>
 413 <H3><A NAME="[B.5]">[B.5] Does XBoard run on VMS?</A></H3>
 414
 415 No.  This port would probably be a lot easier than the Win32 and Amiga
 416 ports were, because VMS has the X Window system (under the name
 417 DECwindows) and is now POSIX compliant.  However, I don't know enough
 418 about VMS to do the port myself, and I don't have time.  If you do,
 419 give it a try!  Send mail to me, tim@tim-mann.org (Tim Mann), if you're
 420 working on this.
 421
 422 <HR>
 423 <H3><A NAME="[B.6]">[B.6] What is cmail?</A></H3>
 424
 425 cmail is a program that helps you play and keep track of electronic mail
 426 correspondence chess games using XBoard.  It is distributed with XBoard and
 427 has its own manual page.  cmail is free software.  It was written by
 428 Even Welsh.  cmail has not been ported to Windows; sorry.
 429
 430 <HR>
 431 <H3><A NAME="[B.7]">[B.7] How do I build XBoard?  Do I need gcc?</A></H3>
 432
 433 The first step to building XBoard is to get the distribution file.  See topic
 434 <A HREF="#[A.2]">[A.2]</A> for places you can ftp the software from.
 435
 436 <P>Next, decide what directory tree you are going to install XBoard
 437 in.  The default is /usr/local, but you probably don't have write
 438 access to that directory unless you are a system administrator.  If
 439 you do, type the following to install it there:
 440
 441 <p><PRE>
 442     gzip -cd xboard-*.tar.gz | tar -xvf -
 443     cd xboard-*/
 444     configure
 445     make
 446     su
 447     make install
 448 </PRE>
 449
 450 If you want to install xboard in your personal home directory ($HOME/bin),
 451 type this:
 452
 453 <p><PRE>
 454     gzip -cd xboard-*.tar.gz | tar -xvf -
 455     cd xboard-*/
 456     configure --prefix=$HOME
 457     make
 458     make install
 459 </PRE>
 460
 461 <P>If the first step above fails because you don't have gzip, see
 462 topic <A HREF="#[A.2]">[A.2]</A>, and ask a local Unix expert if you
 463 need more help.  If you have any problems with the last two steps,
 464 read the READ_ME and INSTALL files in the xboard-*/ directory.  You
 465 will also find this FAQ there.
 466
 467 <P>You don't need to have gcc to build XBoard.  Almost any Unix C
 468 compiler should do.
 469
 470 <HR>
 471 <H3><A NAME="[B.8]">[B.8] Can I use XBoard or WinBoard to play a game
 472   of chess with another human?</A></H3>
 473
 474 The only way for two humans on different machines to play chess in
 475 real time using XBoard/WinBoard is to use an Internet Chess Server
 476 as an intermediary.  That is, each player runs his own copy of XBoard
 477 or WinBoard, both of them log into an ICS, and they play a game there.
 478 Two copies of XBoard/WinBoard cannot communicate with each other
 479 directly.
 480
 481 <P>Instructions on how to get started with Internet chess are included
 482 with the XBoard and WinBoard distributions.  The network addresses
 483 included in the distribution may not always be current.  The oldest
 484 and largest ICS is the Internet Chess Club at chessclub.com, which now
 485 has a fee for registered use, but still allows free unregistered use.
 486 There are also many newer sites with no fees, using the Free Internet
 487 Chess Server implementation (FICS).  The most active FICS site is
 488 freechess.org.  On these and most other chess servers,
 489 the port number to use is 5000.
 490
 491 <P>If you don't have network connectivity to any ICS site, you
 492 can run your own server using a version of the FICS code, but this
 493 is not easy.  See <a href="http://www.tim-mann.org/ics.html#ownics"
 494 >http://www.tim-mann.org/ics.html#ownics</a> for advice and pointers.
 495
 496 <P>The cmail program included with XBoard lets you play email postal games with
 497 another human; see topic <A HREF="#[B.6]">[B.6]</A>.
 498
 499 <P>Two humans can play chess on the same machine using one copy of
 500 XBoard/WinBoard in
 501 Edit Game mode, but the clocks don't run in this mode, so it's of limited
 502 usefulness.
 503
 504 <P>See also topic <A HREF="#[D.2]">[D.2]</A>, Winsock Chess.
 505
 506 <HR>
 507 <H3><A NAME="[B.9]">[B.9] Will WinBoard run on Windows 3.1?
 508   How about Windows CE (also known as Pocket PC)?
 509 </A></H3>
 510
 511 WinBoard does not run on Windows 3.1, Windows for Workgroups 3.11, etc.,
 512 not even with the Win32s compatibility package.  The main problem is
 513 that Win32s does not have threads or real concurrent processes.  A
 514 port of WinBoard to Windows 3.1 is possible in theory, but it would be
 515 difficult and messy, and no one is going to do it.
 516
 517 <p>WinBoard does not run on Windows CE (also
 518 known as Pocket PC).  I don't know what would be required to port it.
 519
 520 <P>WinBoard does run well on full 32-bit versions of Windows, such as
 521 Windows 95, 98, NT, 2000, ME, and XP, and should continue to work
 522 on future 32-bit Windows systems.
 523
 524 <HR>
 525 <H3><A NAME="[B.10]">[B.10] How do I use XBoard or WinBoard as an external viewer for PGN files
 526   with my Web browser?</A></H3>
 527
 528 1) On Unix systems:
 529 <P>
 530 - Add the following line to the file .mime.types in your home directory.
 531 (Create the file if it doesn't exist already.)
 532 <PRE>
 533     application/x-chess-pgn    pgn
 534 </PRE>
 535 <P>
 536 - Add the following line to the file .mailcap in your home directory.
 537 (Create the file if it doesn't exist already.)
 538 <PRE>
 539     application/x-chess-pgn; xboard -ncp -lgf %s
 540 </PRE>
 541 <P>
 542 - Exit from your Web browser and restart it.
 543
 544 <P>2) On MS Windows systems:
 545
 546 <P>The exact procedure depends on which Web browser you are using.
 547 The current version of WinBoard automatically configures itself as
 548 your PGN viewer for local files, Netscape 4.x and later, and Internet
 549 Explorer.  This automatic setup probably works for all other current Web
 550 browsers, too.
 551
 552 <HR>
 553 <H3><A NAME="[B.11]">[B.11] How do I use WinBoard as an external viewer
 554   for PGN files with the MS Windows File Manager or Explorer?</A></H3>
 555
 556 WinBoard sets this up automatically when you install it, except on old
 557 versions of Windows NT (prior to 4.0).  On Windows NT 3.51 or earlier,
 558 go to the File Manager, click on the File menu, select Associate,
 559 enter "pgn" as the extension, and use the Browse button to find your
 560 copy of WinBoard and set up the association.
 561
 562 <HR>
 563 <H3><A NAME="[B.12]">[B.12] How do I use ICC timestamp or FICS timeseal
 564 with XBoard?</A></H3>
 565
 566 First, get the appropriate version of timestamp or timeseal for your
 567 machine from ftp.chessclub.com or ftp.freechess.org.
 568 Second, be sure that you can connect using XBoard <I>without</I>
 569 timestamp/timeseal.  Third, be sure that you can connect using
 570 timestamp/timeseal without XBoard.  See the help files on ICC and FICS
 571 or ask people online if you have problems.
 572
 573 <P>If you are in a completely ordinary situation, where your machine
 574 is directly on the Internet and you can connect to ICC or FICS
 575 without timestamp/timeseal using
 576 just the command "xboard -ics" or "xboard -ics -icshost freechess.org",
 577 change that command to one of the following:
 578
 579 <p><PRE>
 580     xboard -ics -icshost 204.178.125.65 -icshelper timestamp
 581
 582     xboard -ics -icshost 164.58.253.13 -icshelper timeseal
 583 </PRE>
 584
 585 <p>If you have a firewall between your machine and the ICS, see topic
 586 <A HREF="#[B.19]">[B.19]</A>.
 587
 588 <P>If you normally have to use the "/icscomm" command line option on
 589 xboard to log into a second machine, and then telnet to ICC or FICS
 590 from there, you are going to have to run the Unix version of timestamp
 591 or timeseal on the second machine.  (If the second machine is not
 592 running Unix, you are out of luck.)  Get the appropriate version of
 593 timestamp or timeseal onto the shell machine via FTP; see the help
 594 files on ICC and FICS for instructions.  Then simply run it when you
 595 would normally run telnet.  In this configuration you are not
 596 protected against lag between your PC and the shell machine, or for
 597 lag caused by heavy load on the shell machine itself from other users.
 598
 599 <P>For further information on timestamp and timeseal, see the help
 600 files on ICC and FICS.
 601
 602 <HR>
 603 <H3><A NAME="[B.13]">[B.13] How do I use ICC timestamp or FICS timeseal
 604 with WinBoard?</A></H3>
 605
 606 <P>If you select an ICS from either the WinBoard Startup dialog or the
 607 Windows Start submenu that WinBoard installs, WinBoard automatically
 608 runs timestamp or timeseal if the ICS you chose is known to support it.
 609
 610 <P>If you are constructing a WinBoard command line by hand, add the
 611 option "/icshelper timestamp" or "/icshelper timeseal" to the WinBoard
 612 command line to use timestamp or timeseal.  Both timestamp.exe and
 613 timeseal.exe are included in the WinBoard distribution.  They both
 614 function identically to the Unix versions, as documented in "help
 615 timestamp" on ICC and "help timeseal" on FICS.
 616
 617 <p>If you have a firewall between your machine and the ICS, see topic
 618 <A HREF="#[B.19]">[B.19]</A>.
 619
 620 <P>If you normally have to use the "/icscomm" command line option on
 621 WinBoard to log into a shell account, and then telnet to ICC or FICS
 622 from there, you are going to have to run the Unix version of timestamp
 623 or timeseal on the shell machine.  (If the shell account is not on a
 624 Unix machine, you are out of luck.)  Get the appropriate version of
 625 timestamp or timeseal onto the shell machine via FTP; see the help
 626 files on ICC and FICS for instructions.  Then simply run it when you
 627 would normally run telnet.  In this configuration you are not protected
 628 against lag between your PC and the shell machine, or for lag caused by
 629 heavy load on the shell machine itself from other users.
 630
 631 <P>For further information on timestamp and timeseal, see the help
 632 files on ICC and FICS.
 633
 634 <HR>
 635 <H3><A NAME="[B.14]">[B.14] How do I play bughouse with XBoard or WinBoard?
 636 </A></H3>
 637
 638 XBoard and WinBoard have simple but effective bughouse support.
 639 Offboard piece holdings are shown in the board window's banner, and
 640 you drop offboard pieces using the right mouse button.  Press it over
 641 the destination square to pop up a menu of pieces.
 642
 643 <P>XBoard and WinBoard can display only one board at a time, but you
 644 can observe your partner's game by running a second copy of the
 645 program and logging in as a guest.  (Unfortunately, this is not
 646 possible if you are using the /icscomm option.)  To observe your
 647 partner's games automatically, use the "follow" or "pfollow" ICS
 648 command; see the ICS online help for details.
 649
 650 <HR>
 651 <h3><a name="[B.16]">[B.16] What is Zippy?  How can I interface a
 652 chess program to the Internet Chess Servers?</a></h3>
 653
 654 Zippy is an interface that lets a compatible chess engine (such as GNU
 655 Chess or Crafty) act as a computer
 656 player on an Internet Chess Server.  Zippy is included in both the
 657 XBoard and WinBoard distributions.  It is implemented as a small
 658 amount of additional code within XBoard or WinBoard.
 659 For documentation, see the file
 660 zippy.README, included in both distributions or available
 661 from my chess Web page,
 662 <A HREF=
 663 "http://www.tim-mann.org/chess.html"
 664 >http://www.tim-mann/chess.html</A>.
 665 The version of zippy.README on my Web page is often more up-to-date
 666 than those in the XBoard/WinBoard distributions.
 667 You'll also find a "biography" of Zippy and pointers to the original
 668 Zippy the Pinhead comic strips on my Web page.
 669 Please read zippy.README carefully before you ask me any questions about Zippy.
 670
 671 <p>Using a computer to choose your moves on a chess server is
 672 considered cheating unless your account is on the computer (C) list.
 673 Read "help computer" on your favorite server for details on their
 674 policy.  Most of the servers have plenty of computers running now, so they
 675 will not be excited about having you run a new one unless you have
 676 written your own chess engine.  They don't really need yet another
 677 Crafty or GNU Chess clone.
 678
 679 <HR>
 680 <h3><a name="[B.17]">[B.17] How can I interface my own chess program
 681 to XBoard or WinBoard?</a></h3>
 682
 683 This is a non-trivial task.  XBoard and WinBoard were not designed
 684 with a clean interface for talking to chess programs; they were
 685 written to work with an existing version of GNU Chess that expects to
 686 be talking to a person.  Your program has to emulate GNU Chess's
 687 rather idiosyncratic command structure to work with XBoard and
 688 WinBoard.  We are gradually cleaning up, improving, and documenting
 689 the interface as newer versions of XBoard and WinBoard come out,
 690 however.
 691
 692 <p>For documentation, see the file engine-intf.html, included in both
 693 distributions or available from my chess Web page, <A HREF=
 694 "http://www.tim-mann.org/chess.html"
 695 >http://www.tim-mann.org/chess.html</A>.
 696 The version of engine-intf.html on my Web page is often more up-to-date
 697 than those in the XBoard/WinBoard distributions.
 698
 699 <HR>
 700 <h3><a name="[B.18]">[B.18] How can I recompile WinBoard from source?</a></h3>
 701
 702 The source code for WinBoard is available from the author's Web page,
 703 <A HREF=
 704 "http://www.tim-mann.org/chess.html"
 705 >http://www.tim-mann.org/chess.html</A>.
 706
 707 <p>WinBoard is currently developed using Microsoft Visual C++ 5.0.
 708 You can build the program from the MSVC++ GUI by opening the project
 709 file (winboard.dsp) and telling MSVC++ to build the project.  You can
 710 also build it from the the command line by using the nmake program
 711 supplied with MSVC++.
 712
 713 <p>To build WinBoard with the free Cygwin tools, available from <a
 714 href= "http://www.cygwin.com/" >http://www.cygwin.com/</a>), use the
 715 command "make -f cygwin.mak".  WinBoard 4.2.5 was successfully
 716 compiled with the net release of Cygwin as downloaded on 20-March-2001
 717 (cygwin1.dll 1.1.8, gcc 2.95.2-6, binutils 20001221-1, flex 2.5.4-1),
 718 but exhibits a command-line parsing bug; see item 511 in the ToDo file
 719 that comes with WinBoard.  WinBoard 4.1.0 does not compile with
 720 Cygwin.  WinBoard 4.0.7 is known to compile with Cygwin BL20.1.
 721
 722 <p>To build WinBoard with Borland C++ 4.5, use "borland.mak", supplied
 723 with the WinBoard sources, as the Makefile.  Support for Borland C++
 724 was contributed by Don Fong and has not been tested by the author of WinBoard.
 725
 726 <p>WinBoard is a Win32 application, so you definitely need a compiler
 727 and tool set that supports Win32.  In particular, older versions of
 728 DJGPP can build only 32-bit MSDOS programs; that is, programs that use
 729 a DOS extender to get a 32-bit address space and do not make any
 730 Windows calls.  The latest versions of DJGPP are said to be able to
 731 build Win32 programs when used with the proper extension package(s),
 732 but this is not known to work with WinBoard.  Use Cygwin instead.
 733
 734 <p>See also topic <A HREF="#[C.16]">[C.16]</A>.
 735
 736 <HR>
 737 <H3><A NAME="[B.19]">[B.19]
 738 How can I use XBoard or WinBoard to talk
 739 to an Internet Chess Server through a firewall or proxy?
 740 </A></H3>
 741
 742 <p>There is no single answer to this question, because there are many
 743 different kinds of firewalls in use.  They work in various different
 744 ways and have various different security policies.  This answer can
 745 only provide hints.
 746
 747 <p>Note that you can't access Internet Chess Servers through a Web proxy,
 748 because they are not a Web service.  You talk to them through a raw
 749 TCP connection, not an HTTP connection.  If you can only access the
 750 Web through a proxy, there may be a firewall that stops you from
 751 making direct TCP connections, but there may also be a way through it.
 752 Read on for hints, and contact your local system administrator if you
 753 need more information about your local configuration.
 754
 755 <p>A helpful user mailed me the following explanation of how to use
 756 WinBoard with WinGate:
 757 <blockquote>
 758 "I have managed to setup WinBoard though my WinGate proxy.  I have the
 759 Office version.  What I needed to do was to setup the TCP/IP
 760 connection to add the User/Host name and my provider service name for
 761 the DNS, but I had to leave the HOST IP address blank.  I have not
 762 played with all the variations, so it may be just that I have the DNS
 763 lookup enabled."
 764 </blockquote>
 765 I hope this helps, though I don't find it very clear.  I don't have
 766 a copy of WinGate myself and can't help if you have questions about it.
 767
 768 <p>If you are using some other non-SOCKS firewall, read the FIREWALLS section
 769 in your XBoard or WinBoard documentation (man page, info document, or
 770 Help file).  If you can telnet to a chess server in some way, then you
 771 can almost certainly connect to it with xboard/WinBoard, though in
 772 some cases you may not be able to run timestamp or timeseal.  The
 773 timestamp and timeseal protocols require a clean, 8-bit wide TCP
 774 connection from your machine to the ICS, which some firewalls do not
 775 provide.
 776
 777 <p>If you have a SOCKS firewall and are using <strong>XBoard</strong>,
 778 you should be able to SOCKSify xboard and use it.  See <a
 779 href="http://www.socks.nec.com/">http://www.socks.nec.com/</a> for
 780 information about SOCKS and socksification.  However, if you do this,
 781 you can't use timestamp or timeseal; what you really need is a
 782 socksified version of timestamp or timeseal.  This is hard because the
 783 source code for timestamp and timeseal is proprietary; the folks
 784 running the chess servers don't give it out because that would make it
 785 too easy to cheat.  On some versions of Unix, you may be able to
 786 socksify a program that you don't have the source code to by running
 787 it with an appropriate dynamic library; see <a
 788 href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.  For
 789 others, you might be able to get a pre-built socksified version from
 790 the chess server administrators.  For timeseal versions, see <a
 791 href="ftp://ftp.freechess.org/pub/chess/timeseal/"
 792 >ftp://ftp.freechess.org/pub/chess/timeseal/</a>.  For timestamp
 793 versions, the directory would be <a
 794 href="ftp://ftp.chessclub.com/pub/icc/timestamp/"
 795 >ftp://ftp.chessclub.com/pub/icc/timestamp/</a>, but at this writing
 796 there don't seem to be any socksified timestamps there.  Once you have
 797 a socksified timestamp or timeseal, simply run it with a normal,
 798 non-socksified xboard in place of the standard timestamp or timeseal.
 799
 800 <p>If you have a SOCKS firewall and you are using
 801 <strong>WinBoard</strong>, we now know how to make this configuration
 802 work, complete with timestamp or timeseal!
 803
 804 <p>Start by getting SocksCap32.  This software is freely available
 805 from <a href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.
 806 Install it on your machine, read the documentation, and learn to use
 807 it.  You may find it useful with many other programs besides WinBoard.
 808
 809 <p>Next, <strong>don't</strong> socksify WinBoard.  Socksifying
 810 WinBoard itself doesn't let you use it with timestamp or timeseal.
 811 For some reason I don't understand -- something strange that
 812 SocksCap32 does -- the socksified WinBoard runs but does nothing, and
 813 timestamp/timeseal runs all by itself in its own window.
 814
 815 <p>Instead, use the following workaround.  Follow the instructions
 816 exactly; don't try to skip steps or simplify things.
 817
 818 <p>First, make SocksCap32 application profiles for timestamp and
 819 timeseal.  Use the following command lines in the SocksCap32
 820 profiles. Name the first profile "timestamp" and the second
 821 "timeseal".
 822
 823 <p><pre>
 824     "c:\program files\winboard\timestamp.exe" chessclub.com 5000 -p 5000
 825     "c:\program files\winboard\timeseal.exe" freechess.org 5000 -p 5000
 826 </pre>
 827
 828 <p>Second, run timestamp or timeseal by itself, socksified, using its
 829 profile.  This will open an unneeded, black window that will not
 830 respond to typing.  Minimize it to the task bar and ignore it. It will
 831 go away when you exit from WinBoard.
 832
 833 <p>Next, run WinBoard using the following command line.  Make a shortcut
 834 or type this command into an MS-DOS Prompt box.  Don't run WinBoard
 835 itself socksified, just run it directly.
 836
 837 <p><pre>
 838     "c:\program files\winboard.exe" /ics /icshost=localhost /icsport=5000
 839 </pre>
 840
 841 <p>After you get this working, you can try getting the timestamp window to
 842 auto-minimize by starting it from a shortcut instead of from the
 843 SocksCap32 control window. As it says in the SocksCap32 help file, put
 844 the following in the Target field of a shortcut's Properties page:
 845
 846 <p><pre>
 847     "c:\program files\sockscap32\sc32.exe" timestamp
 848 </pre>
 849
 850 Then select "Run: Minimized" on the same page.  Do the same for timeseal.
 851
 852 <p>Another method that can work is to use a .bat file to start both
 853 timestamp and WinBoard.  It would look something like this:
 854
 855 <p><pre>
 856     REM --
 857     REM -- icc.bat
 858     REM -- Start timestamp under SocksCap32 and use WinBoard to connect to it.
 859     REM -- The string "timestamp" refers to a SocksCap32 profile for timestamp.
 860     REM --  Do not change it to the filename of the timestamp program!
 861     REM --
 862     start /minimized "c:\program files\sockscap32\sc32.exe" timestamp
 863     cd "c:\program files\winboard"
 864     winboard /ics /icshost=localhost /icsport=5000
 865 </pre>
 866
 867 <p>This workaround has a problem if you want to run two copies of
 868 WinBoard at once, talking to the same chess server twice (for
 869 bughouse) or to two different chess servers. If you need to do that,
 870 you will need to run a separate copy of timestamp with <i>a different
 871 port number</i> for each connection.  You'll need to make a second set of
 872 profile entries with a different value after the -p flag (say, 5001)
 873 and you'll need to change the WinBoard command line /icsport=5000 for
 874 the second WinBoard to match.
 875
 876 <HR>
 877 <H3><A NAME="[B.20]">[B.20]
 878 How can I use XBoard or WinBoard on chess.net with accuclock?
 879 </A></H3>
 880
 881 <p>I believe chess.net provides a Win32 command-line version of
 882 accuclock that will work with WinBoard.  Please see the documentation
 883 on the chess.net server itself; don't ask the author of WinBoard.
 884
 885 <p>I don't know whether chess.net provides versions of accuclock for
 886 Unix at this time.  Ask them.
 887
 888 <hr>
 889 <h3><a name="[B.21]">[B.21]
 890   Can I get Zippy to do one or more ICS commands automatically at the
 891   start or end of each game?</a></h3>
 892
 893 <p>By default, Zippy automatically sends the command "gameend" to ICS
 894 at the end of each game.  You can alias this command (using the ICS
 895 "alias" feature) to anything you want.  On ICC, you can use the
 896 "multi" feature to alias gameend to several commands, but other
 897 servers don't have that feature.  Zippy doesn't send anything at the
 898 start of the game by default.
 899
 900 <p>You can get Zippy to send one or more commands of your choosing, at
 901 the start and/or end of each game, by using the -zippyGameStart and
 902 -zippyGameEnd command line options, newly added in version 4.0.3.
 903 Both xboard and WinBoard have (somewhat obscure) ways of getting
 904 newlines into this option to send several commands.  Here is an
 905 example of one way to do it for each.
 906
 907 <p><pre>
 908     xboard -ics -zp -xrm '*zippyGameStart: say hi\nsay prepare to die\n'
 909
 910     WinBoard /ics /zp /zippyGameEnd='say thanks\nseek 5 0\nseek 2 12\n'
 911 </pre>
 912
 913 <hr>
 914 <h3><a name="[B.22]">[B.22]
 915   How do I print from WinBoard?
 916 </a></h3>
 917
 918 WinBoard does not have built-in printing functionality.
 919 If you want to print a picture of the board, press Alt+PrintScrn, run the
 920 standard Windows application Paintbrush, select Paste, and print from there.
 921 If you want to print a list of moves, save your game as a PGN file,
 922 then open the PGN file with Notepad or any other plain text editor and
 923 print it from there.
 924
 925 <hr>
 926 <h3><a name="[B.23]">[B.23]
 927   Can I get Zippy to automatically reconnect to ICS when its connection
 928   breaks?</a></h3>
 929
 930 <p>There isn't a perfect solution to this problem yet, but a pretty
 931 good one is to write a shell script (for xboard) or .bat script (for
 932 WinBoard) that automatically restarts the program whenever it exits.
 933 Use the -xexit flag so that you don't get a popup dialog that must be
 934 dismissed with the OK button before the program will exit.  The gap in
 935 this solution is that your connection to ICS can sometimes get into a
 936 state where the program does not notice that the connection is broken
 937 until the next time it tries to send a command.  Perhaps some future
 938 version of xboard/WinBoard will have an option to send a harmless
 939 command every five minutes or so.
 940
 941 <p>Anyway, here is a sample Windows .bat file that restarts WinBoard each
 942 time it exits.  Thanks to Jason Williamson.  It assumes that you have put
 943 your computer account's name and password in a file named logon.ini.
 944
 945 <pre>
 946 REM --
 947 REM -- wbrecon.bat
 948 REM -- Start WinBoard in Zippy mode, and restart it each time it exits.
 949 REM -- Add or change parameters as needed for your application.
 950 REM --
 951 :loop
 952 start /w winboard /zp /ics /icslogon logon.ini /xexit /xautoraise
 953 REM -- The next line is to have a short delay setup for 139 seconds.
 954 REM -- Leave it out if it doesn't work on the version of Windows you use.
 955 TYPE NUL | CHOICE.COM /N /CY /TY,99 &gt;NUL
 956 goto loop
 957 </pre>
 958
 959 <p>Here is a Unix shell script to do the same thing for xboard.
 960 It's a bit more elaborate.  It is based on the script I use for the
 961 original Zippy.  It logs all ICS output to a file named zippy.out,
 962 and it lets you type commands to Zippy by running "cat &gt; zippy.fifo".
 963
 964 <pre>
 965 #! /bin/sh
 966 host="204.178.125.65 -icsport 5000 -telnet -telnetProgram timestamp"
 967 #host="164.58.253.13 -icsport 5000 -telnet -telnetProgram timeseal"
 968 out=zippy.out
 969 fifo=zippy.fifo
 970 ZIPPYPASSWORD='something'
 971 export ZIPPYPASSWORD
 972 ZIPPYPASSWORD2='orother'
 973 export ZIPPYPASSWORD2
 974 ZIPPYLINES=`pwd`/all.lines
 975 export ZIPPYLINES
 976 ZIPPYGAMEEND='say Yow, that was FUN!
 977 gameend'
 978 export ZIPPYGAMEEND
 979 zippylogon=`pwd`/logon.ini
 980 DISPLAY=`hostname`:0.0
 981 export DISPLAY
 982 mv -f $out ${out}.old
 983 rm -f $fifo
 984 mkfifo $fifo
 985 pid=$$
 986 ( while [ true ] ; do cat -u $fifo ; done ) | \
 987       ( while [ true ] ; do
 988           xboard -iconic -ics -icshost $host \
 989                  -zt -zp -xbell -xanimate \
 990                  -xautosave -xquiet -fcp "gnuchessx -h" \
 991                  -icslogon $zippylogon -xexit -autoflag -xautoraise $*
 992           sleep 600
 993         done ) &gt; $out 2&gt;&amp;1 &amp;
 994 </pre>
 995
 996 <hr>
 997 <h3><a name="[B.24]">[B.24]
 998   The chess engines are too strong and always beat me.  How can I adjust
 999   the difficulty level to make them weaker?</a></h3>
1000
1001 <p>The simplest way to get that effect is to make sure the
1002 XBoard/WinBoard Auto Flag option is off, set a very fast time control
1003 so that the chess engine can't think for long, but take as much time
1004 over your own moves as you want. Also feel free to use Retract Move if
1005 you make a blunder.
1006
1007 <p>Many chess coaches will let you switch sides after
1008 they get a stronger position so that you can get experience playing
1009 positions where you are winning.  You can try this with XBoard/WinBoard
1010 by using the Machine White or Machine Black menu command to make the
1011 machine take over your position.
1012
1013 <p>The -depth command-line option to XBoard/WinBoard can also be used to
1014 weaken the engine (see the man page or Help file).  It's a bit of a
1015 nuisance to set command line options in Windows, but see topic <A
1016 HREF="#[C.7]">[C.7]</A> for instructions.
1017
1018 <p>Other ways of weakening engines are engine-specific.  Many of them
1019 let you adjust various parameters, and if you choose bad settings, the
1020 engine will play more poorly.  Consult whatever documentation came with
1021 the engine you are using.
1022
1023 <HR><H2><A NAME="[C]">[C] XBoard and WinBoard, bugs and problems</A></H2>
1024
1025 <HR><H3><A NAME="[C.1]">[C.1] I can't build XBoard
1026 because the X11/Xaw/...  include files are not found.</A></H3>
1027
1028 These are the header files for the Athena Widgets library, which XBoard uses
1029 heavily.  Some versions of Unix don't supply these files, but they are part of
1030 the standard X distribution, freely available from MIT.
1031
1032 <P>For general information on getting missing X sources, see the FAQ on
1033 comp.windows.x.  Note that you may be missing only the header files, or you
1034 may be missing the libraries themselves too.
1035
1036 <P>HP-UX users are missing only the header files.  You can get them by
1037 anonymous FTP as follows.  (But first check with your system
1038 administrator to see if someone else at your site has already done
1039 this.)  Get the archive file /hpux9/X11R5/Core/Xaw-5.00.tar.gz (Xaw
1040 header files) via anonymous FTP from the site hpux.csc.liv.ac.uk
1041 (138.253.42.172), or one of the other official sites---Germany:
1042 hpux.ask.uni-karlsruhe.de (129.13.200.57), US: hpux.cae.wisc.edu
1043 (144.92.4.15), France: hpux.cict.fr (192.70.79.53) or Netherlands:
1044 hpux.ced.tudelft.nl (130.161.140.100). Unpack the archive using gzip
1045 and follow the instructions in its README and/or HPUX.Install files.
1046 Thanks to Richard Lloyd for this information.
1047
1048 <P>If you have the Xaw header files installed in a different place
1049 than the other X11 headers, you may need to configure XBoard with an
1050 extra flag to help it find them.  For example, if yours are in
1051 /foo/bar/X11/Xaw, try this:
1052
1053 <p><PRE>
1054     rm config.cache
1055     (setenv CFLAGS -I/foo/bar ; configure)
1056 </PRE>
1057 <P>
1058 Also see topic <A HREF="#[C.2]">[C.2]</A>.
1059
1060 <HR>
1061 <H3><A NAME="[C.2]">[C.2] Configuring or building XBoard fails due to
1062 missing header files, missing libraries, or undefined symbols.
1063 </A></H3>
1064
1065 Perhaps you have the X server and client programs installed on your
1066 machine, but not the X header files and link-time libraries.  If so,
1067 you can run existing X programs, but you cannot compile a new X
1068 program from source code.  In this case the XBoard configure script
1069 will fail and will tell you to look at this question in the FAQ.  Many
1070 GNU/Linux distributions put the headers and libraries in a separate
1071 package, which you might not have installed.  If you are using RedHat,
1072 install the XFree86-devel package.  If you are using some other
1073 kind of Unix, ask your system administrator where to find the X header
1074 files and link-time libraries.  If this is not your problem, read on.
1075
1076 <p>The configure script for XBoard looks for X libraries and header
1077 files in some common places.  Sometimes it fails: If yours are
1078 installed in an odd place, it may not find them at all.  If you have
1079 more than one version of X installed on your system, it may find the
1080 "wrong" one, or occasionally it may find libraries from one version
1081 and incompatible header files from another.  You can work around these
1082 problems by telling the configure script where the files are.  For
1083 example:
1084
1085 <p><PRE>
1086     configure --x-includes=/odd/place/include \
1087               --x-libraries=/odd/place/lib
1088 </PRE>
1089
1090 <P>The directory named in the argument to --x-includes must have a
1091 subdirectory "X11" that contains the actual .h files.  That is, if
1092 your X.h file has full pathname /odd/place/X11R6/include/X11/X.h, then
1093 you must give the argument --x-includes=/odd/place/X11R6/include.
1094
1095 <P>Some linkers have bugs that cause bogus error messages when you try
1096 to link X programs.  The configure script includes a workaround for a
1097 bug of this kind that exists in some SunOS 4.x.x installations.  See
1098 the FAQ on comp.windows.x for more information about problems of this
1099 kind.
1100
1101 <P>If all else fails, check whether anyone else at your site has been able to
1102 compile any X programs on your system.  Your X installation might be buggy.
1103 If so, the system administrator at your site might know how to fix or work
1104 around the problem.
1105
1106 <P>Also see topic <A HREF="#[C.1]">[C.1]</A>.
1107
1108 <HR><H3><A NAME="[C.3]">[C.3] I have problems using WinBoard on ICS
1109 with a modem.  I'm not running SLIP or PPP, but just dialing in to an
1110 ordinary login account ("shell account").</A></H3>
1111
1112 Here are solutions to some common problems in this area.
1113
1114 <P>Some people want to connect to ICS through HyperTerminal or some other
1115 terminal program first, then run WinBoard.  This is not how it works.
1116 WinBoard wants to talk directly with your modem, acting as a terminal program
1117 itself.  Start out with the modem "on hook" (not making a call).
1118
1119 <P>Run WinBoard with a command line like this (adding more options if desired):
1120
1121 <p><PRE>
1122     WinBoard /ics /icscom com1
1123 </PRE>
1124
1125 Use com2, com3, or com4 in place of com1 if your modem is connected to one of
1126 those ports.
1127
1128 <P>After you start WinBoard, you may need to change some of the options in the
1129 Communications dialog (on the Options menu).  The dialog has the usual options
1130 for talking to modems: bits per second, bits per byte, parity, number of stop
1131 bits.  You will probably want to use Save Settings Now when you're done.
1132
1133 <P>Next, type dialing commands to your modem in the text window that WinBoard
1134 creates.  You may need to turn off Local Line Editing on the Options menu
1135 while you are typing commands to your modem.  Turn it back on when you're
1136 done.  See the WinBoard Help file for instructions if you see your typing
1137 echoed an extra time after you hit Enter.
1138
1139 <HR>
1140 <H3><A NAME="[C.4]">[C.4]
1141 I have problems using WinBoard on ICS with Windows 95 and SLIP
1142 or PPP.  When trying to start up, it gets the error "Address family
1143 not supported by protocol family" (or some equally strange message).
1144 </A></H3>
1145
1146 WinBoard is a 32-bit application, but some Winsock (TCP/IP) implementations
1147 support only 16-bit applications.  You get a strange looking error message
1148 if you try to use a 32-bit application because
1149 there is no standard Winsock error code number
1150 for "32-bit application not supported."
1151
1152 <P>Microsoft TCP/IP works with both 16-bit and
1153 32-bit applications, supports SLIP, PPP, Ethernet, etc., and is included
1154 with Windows 95 and later Windows systems.
1155 If possible, I recommend that you uninstall
1156 whatever Winsock you are using and install Microsoft TCP/IP instead.
1157 For more information, see
1158 <A HREF=
1159 "http://walden.mo.net/~rymabry/95winfaq.html"
1160 >http://walden.mo.net/~rymabry/95winfaq.html (the Win95-L FAQ)</A>.
1161
1162 <P>Trumpet Winsock 2.1 (and earlier) supports only 16-bit
1163 applications, and hence does not work with WinBoard.  But there is a
1164 beta-test release available that does support 32-bit applications.
1165 I have not tried it with WinBoard, but it
1166 should work.  See Trumpet's Web page
1167 <A HREF=
1168 "http://www.trumpet.com.au/wsk/winsock.htm"
1169 >http://www.trumpet.com.au/wsk/winsock.htm</A>
1170 for more information.
1171
1172 <P>The 16-bit versions of America On-Line's software do not support
1173 32-bit Winsock applications.  Get the 32-bit version.  At one time the
1174 32-bit version was called "AOL for Windows 95," but I imagine that has
1175 changed.  Hopefully the current versions are all 32-bit.
1176
1177 <P>A few versions of Winsock may have bugs that prevent
1178 Windows timestamp/timeseal from working with them.  I'm not sure if
1179 such bugs exist in any versions that actually have 32-bit support,
1180 so this point might be moot.  Again, Microsoft TCP/IP is known to work.
1181
1182 <HR><H3><A NAME="[C.5]">[C.5] When I try to run WinBoard, I get the
1183 message "Failed to start chess program gnuchess on localhost: NO
1184 LANGFILE (file gnuchess.lan not found)".</A></H3>
1185
1186 <p>This message means that WinBoard is trying to run GNU Chess, but
1187 GNU Chess cannot find a file that it needs, named gnuchess.lan.
1188 If you see it, you've probably customized WinBoard's /fcp, /fd, /scp,
1189 and/or /sd options and made a mistake in the process.  Review what
1190 you did, and see the WinBoard help file.
1191
1192 <HR>
1193 <H3><A NAME="[C.6]">[C.6] I want to use XBoard or WinBoard as an Internet
1194 Chess Server interface, but the ICS Client option is grayed out on the
1195 menu.</A></H3>
1196
1197 XBoard and WinBoard have three major modes that can't be changed from the
1198 menus: local chess engine mode,
1199 ICS mode, and standalone mode.
1200
1201 <p>With XBoard, you have to set the mode using command-line options.
1202 Local chess engine mode is the default, -ics selects ICS mode, and
1203 -ncp ("no chess program") selects standalone mode.
1204
1205 <p>With WinBoard, if you don't set the mode using command-line
1206 options, you get a dialog box asking which mode you want.  To bypass
1207 the dialog box, use -cp ("chess program") for local chess engine mode,
1208 or -ics or -ncp as with XBoard.  Also see topic <A HREF="#[C.7]">[C.7]</A>.
1209
1210 <HR>
1211 <H3><A NAME="[C.7]">[C.7] How do I give command-line options to
1212 a Windows program like WinBoard?</A></H3>
1213
1214 <P>There are many ways; pick your favorite:
1215
1216 <P><UL>
1217 <LI>Type the command line into an MS-DOS Prompt box.  Example:
1218 "WinBoard -ics".
1219
1220 <LI>Make a Windows shortcut for WinBoard.  You can do this by
1221 right-dragging WinBoard.exe to the desktop and selecting "Create
1222 Shortcut(s) Here" from the menu that appears.  Right-click on the
1223 shortcut, select Properties, and click the Shortcut tab.  The
1224 command-line text box is labelled "Target" instead of "Command line"
1225 just to confuse you.  Edit the text in this box, adding the command
1226 line options to the end.</LI>
1227
1228 <LI>Choose Run from the Start menu, or File / Run from the Program
1229 Manager or File Manager, and type the command line into the dialog you
1230 get.  You may have to give WinBoard's full drivespec and filename if
1231 it is not in a directory on your search path.</LI>
1232
1233 <LI>Make a Program Manager icon for WinBoard.  You can do this by
1234 dragging WinBoard.exe from the File Manager into the Program Manager,
1235 or by using File / New in the Program Manager.  Select the icon and
1236 choose File / Properties.  Edit the Command Line text box to add the
1237 command-line options to the end.</LI>
1238 </UL>
1239
1240 <HR>
1241 <H3><A NAME="[C.9]">[C.9]
1242 When I exit from WinBoard after using it to play against a chess
1243 program on my machine, the chess program keeps running in the background.
1244 </A></H3>
1245
1246 <p>If you are using Crafty, be certain to get the version compiled for
1247 Win32 (wcrafty.exe), not the version compiled for MS-DOS (crafty.exe).
1248 Also, be sure you have the current version of WinBoard.  WinBoard
1249 3.4.1 and earlier had a bug that caused this problem to occur with all
1250 chess engines.
1251
1252 <p>This problem is reported to still happen occasionally, for unknown
1253 reasons.  You can generally stop the rogue Crafty by pressing
1254 Ctrl+Alt+Del, selecting the Crafty process from the menu, and pressing
1255 the End Task button.
1256
1257 <hr>
1258 <h3><a name="[C.12]">[C.12]
1259 Why do my ICS
1260 opponents often get extra time after they make their moves?
1261 Why do I sometimes lose time off my clock after I make my move?
1262 </a></h3>
1263
1264 If you are playing with the ICS incremental clock, both you and your
1265 opponent get a set amount of extra time after each move.
1266
1267 <p>If your or your opponent has netlag, your opponent might appear to
1268 get extra time, especially if your opponent is using timestamp or
1269 timeseal.  The ICS charges each player who is using timestamp or
1270 timeseal only for the time between when the player received his
1271 opponent's move and the time he sent his own move.  Thus delays in
1272 network transmission do not count against either player.  But WinBoard
1273 counts down the display of your opponent's clock on your screen under
1274 the assumption that there is no netlag.  When his move comes in, if
1275 there was netlag, the ICS may not have really charged him for that
1276 much time, and WinBoard corrects the clock to what the ICS says it
1277 should read.
1278
1279 <p>If you are not using timestamp or timeseal, you may appear to lose
1280 time off your clock at some point after you make your move.  In this
1281 case, the ICS charges you for the time between when it sent you your
1282 opponent's move and the time it received your move.  Thus delays in
1283 network transmission count against you.  WinBoard stops counting down
1284 the display of your clock on your screen (and starts your opponent's)
1285 when you make your move.  When the ICS echoes your move back to you, it
1286 may have charged you for more time than that, and WinBoard corrects
1287 the clocks to what the ICS says they should read.
1288
1289 <p>See "help lag" and "help timestamp" or "help timeseal" on your ICS for
1290 more detailed information.
1291
1292 <hr>
1293 <h3><a name="[C.13]">[C.13]
1294 I can't run WinBoard unless I delete the WinBoard.ini file each time!
1295 </a></h3>
1296
1297 <p>Most people don't have this problem, but two or three people using
1298 Windows NT 4.0 with Service Pack 3 or 4 have reported it.  I have no
1299 idea what causes this problem.  Contrary to what was reported in a
1300 previous version of this FAQ, reinstalling the service pack after
1301 installing WinBoard does not seem to solve the problem.
1302
1303 <hr>
1304 <h3><a name="[C.15]">[C.15]
1305 I get errors compiling XBoard's parser.c.
1306 </a></h3>
1307
1308 <p>The file parser.c is automatically generated from parser.l.  The
1309 copy included with XBoard 4.0.2 was generated by lex on Tru64 Unix and
1310 has problems compiling and linking on current GNU/Linux versions.  The
1311 copy included with XBoard 4.0.3 was generated by flex on a GNU/Linux
1312 machine, but it too won't necessarily work on other versions of Unix.
1313 If you have this problem, you can fix it by deleting parser.c and
1314 letting the Makefile re-create it from parser.l.  This will work if
1315 you have either lex or flex on your system.  Flex is available in all
1316 GNU/Linux distributions and can be obtained at no charge from the Free
1317 Software Foundation, www.fsf.org.
1318
1319 <hr>
1320 <h3><a name="[C.16]">[C.16]
1321 I get an error building WinBoard from source because "flex" is not found.
1322 </a></h3>
1323
1324 <p>The file parser.c is automatically generated from parser.l.  The
1325 Makefile included with the WinBoard source kit has a rule for
1326 generating parser.c using the program "flex", which will fail if you
1327 don't have flex.  However, the source kit also includes a ready-made
1328 copy of parser.c, so you don't really need flex unless you have made
1329 changes to parser.l.  Check that you still have a copy of parser.c; if
1330 you don't, unpack the WinBoard source zip file again to get one.
1331 Either set the last-modified time of parser.c to be later than that of
1332 parser.l, delete parser.l, or comment out the Makefile rule for
1333 building parser.c from parser.l, and then try building WinBoard again.
1334
1335 <p>If you do want to change parser.l and rebuild parser.c, you can get
1336 flex as part of the free Cygwin kit from
1337 <a href="http://sourceware.cygnus.com/cygwin/"
1338 >http://sourceware.cygnus.com/cygwin/</a>.  You can
1339 probably also get flex for Windows by itself from various other places
1340 around the Internet.  It is free software distributed by the Free
1341 Software Foundation, www.fsf.org.
1342
1343 <hr>
1344 <h3><a name="[C.17]">[C.17]
1345   XBoard hangs shortly after connecting to an ICS when used with dxterm,
1346  cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.
1347 </a></h3>
1348
1349 <p>After connecting to a chess server, XBoard 4.0.2 and later sends an
1350 escape sequence to its terminal that is meant to display your handle
1351 and the ICS host name (for example, "user@chessclub.com") in the
1352 terminal's banner and icon.  It seems that several of the alternative
1353 X terminal programs have a bug that makes them hang when sent this
1354 escape sequence.
1355
1356 <p>You can work
1357 around the problem by using xterm, nxterm, rxvt, aterm, xiterm, or
1358 gnome-terminal, all of which seem to work fine.  In fact, current
1359 versions of kterm and konsole seem to work fine too, so if you are
1360 having problems with one of them, be sure you are not running an
1361 outdated version.
1362
1363 <p>Alternatively, you can disable this feature by commenting out the
1364 body of DisplayIcsInteractionTitle in xboard.c and recompling xboard.
1365
1366 <hr>
1367 <h3><a name="[C.18]">[C.18]
1368   The WinBoard pieces show up in the wrong colors, appear distorted,
1369   or are not visible at all.
1370 </a></h3>
1371
1372 <p>This can happen if you have a bug in your Windows display driver.
1373 Check with the manufacturer of your display card, the manufacturer of
1374 your computer, or Microsoft to see if there is an updated driver
1375 available.  You can usually download updated drivers from the Web.
1376
1377 <p>If you can't find an updated driver, you can try running Windows
1378 using a different number of colors and/or disabling some of the
1379 hardware acceleration features on your display card.  To change the
1380 number of colors, go to Windows Start / Settings / Control Panel /
1381 Display / Settings / Color Palette.  To disable hardware acceleration
1382 features, go to Windows Start / Settings / Control Panel / Display /
1383 Settings / Advanced Properties / Performance / Hardware Acceleration.
1384
1385 <p>It's also possible that Windows has the right driver for your
1386 hardware already but you are not using it.  It may help to reinstall
1387 your driver.  Go to Windows Start / Settings / Control Panel / System
1388 and delete your display card (maybe even your monitor too), then
1389 reboot.  Windows should automatically re-detect your card and monitor
1390 and re-install the drivers; if it doesn't, run Start / Settings /
1391 Control Panel / Add New Hardware to force it to.
1392
1393 <p>If all else fails, try Monochrome mode.  On WinBoard's menus, go
1394 to Options / Color and check Monochrome.  WinBoard will display in black
1395 and white.
1396
1397 <HR>
1398 <H3><A NAME="[C.19]">[C.19] XBoard or WinBoard tells me "Error: first chess
1399   program (...) exited unexpectedly".</A></H3>
1400
1401 <p>This message means that your chess engine crashed, probably due to
1402 a bug in the engine, or because you have it configured incorrectly.
1403 You can try running XBoard or WinBoard again with the "-debug" flag on
1404 the command line.  This will print out all the messages received from
1405 the chess engine.  (With WinBoard, the messages go into a file called
1406 WinBoard.debug; with XBoard, they go to the xterm that you started
1407 XBoard from.)
1408
1409 <P>If you are using GNU Chess and you see this problem as soon as it
1410 starts up, most likely GNU Chess is exiting with an error message.  If
1411 you see the message "NO LANGFILE", it means that you did not install
1412 GNU Chess correctly, and it is unable to find the file gnuchess.lang.
1413 Make sure that you defined LIBDIR in the gnuchess Makefile, and that
1414 gnuchess.lang is in that directory.  If gnuchess.lang is not there,
1415 you probably didn't type "make install" in the gnuchess src directory;
1416 you must do this to install gnuchess.lang (and the gnuchess book).  If
1417 you defined LIBDIR to something that is not an absolute pathname (that
1418 is, to something that does not start with a "/"), GNU Chess will work
1419 only if you run it from the GNU Chess "src" directory where you built
1420 it.
1421
1422 <hr><h3><a name="[C.20]">[C.20]
1423   XBoard tells me "Warning: Cannot allocate colormap entry".
1424 </a></h3>
1425
1426 <p>You are running your X server with 8-bit color depth, and you are running
1427 some program that has used up all 256 of your colors.  Netscape tends
1428 to do this, or maybe you have a background image that uses up all of
1429 your colors.
1430
1431 <p>If you have a modern machine, you probably have enough display
1432 memory to run your X server with 16-, 24-, or 32-bit color depth.  If
1433 you're using "startx" to start the X server, try giving the command as
1434 "<tt>startx -- -bpp 24</tt>" (or 16, or 32).  Further details on
1435 configuring your X server are beyond the scope of this FAQ.
1436
1437 <p>If you must run in 8-bit mode, try the following:
1438 Avoid background images that use up all your colors.  If you
1439 run Netscape, try starting it up with the <tt>-install</tt> command-line
1440 option; this gives Netscape its own private colormap that X will
1441 switch to when Netscape has the keyboard focus.  If all else fails,
1442 another option is to run xboard in monochrome (black and white) mode
1443 by giving it the <tt>-mono</tt> command-line option.
1444
1445 <hr><h3><a name="[C.21]">[C.21]
1446   When I log in to freechess.org, the Enter key doesn't work, and I
1447   have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't
1448   work either, so I'm stuck.
1449 </a></h3>
1450
1451 <p>This is a pretty rare problem.  It should only arise if you have to
1452 reach freechess.org by telnetting (or connecting with WinBoard
1453 /icsport=23) from a Windows PC to a Unix box, and then telnetting from
1454 there to freechess.org.  The Enter key should always work when
1455 connecting directly from your PC to freechess.org.
1456
1457 <p>The best way to get around the problem is to run timeseal on the
1458 intermediate Unix box instead of telnet.  Get the appropriate version
1459 of timeseal for your box from ftp.freechess.org and follow the
1460 directions in the help files on FICS.
1461
1462 <p>If you can't run timeseal for some reason, there are some things
1463 you can do to make telnet stay in line mode instead of going to
1464 character mode.  Then the Enter key will work.  First, try "telnet
1465 freechess.org 5000" instead of "telnet freechess.org."
1466 If that still doesn't work, then when the Enter key stops working,
1467 type the following.  Here <tt>&lt;</tt> and <tt>&gt;</tt> surround the
1468 names of keys.
1469
1470 <p><pre>
1471     &lt;Ctrl+S&gt;&lt;Ctrl+]&gt;mode line&lt;Enter&gt;
1472 </pre>
1473
1474 <hr><h3><a name="[C.22]">[C.22]
1475   XBoard says, "Failed to start first chess program gnuchessx
1476   on localhost: gnuchessx: No such file or directory."
1477 </a></h3>
1478
1479 <p>XBoard is looking for GNU Chess 4.0.  If you didn't want to use
1480 XBoard with GNU Chess, please see topic <A HREF="#[C.6]">[C.6]</A>.
1481 If you did want to use GNU Chess 4.0, be sure you have it installed and
1482 that it is on your $PATH.  If you wanted to use GNU Chess 5 instead,
1483 see topic <A HREF="#[D.6]">[D.6]</A>.
1484
1485 <HR>
1486 <H2><A NAME="[D]">[D] Crafty and other topics</A></H2>
1487 <HR>
1488 <H3><A NAME="[D.1]">[D.1] What is XChess?</A></H3>
1489
1490 XChess is an older chessboard program that is no longer supported.  XChess was
1491 written for X version 10, and you may or may not be able to build and run it
1492 on an X11 system.
1493
1494 <P>XChess has only one significant feature that is not present in XBoard: Two
1495 humans can play chess using XChess on different machines, without using the
1496 Internet Chess Server as an intermediary.  This feature is of interest only if
1497 you don't have network connectivity to the Internet Chess Server.
1498
1499 <P>Note: There actually have been several different programs called "XChess" in
1500 circulation at various times.  The above describes one that was associated
1501 with GNU Chess.
1502
1503 <HR>
1504 <H3><A NAME="[D.2]">[D.2] What is Winsock Chess?</A></H3>
1505
1506 Winsock Chess is a program that lets two people play chess across a
1507 network.  It runs only under Microsoft Windows.  Some of the code in
1508 Winsock Chess is derived from GNU Chess, but it is not maintained by
1509 the GNU Chess team.  You can get a copy from the Internet Chess
1510 Library; see topic <A HREF="#[A.2]">[A.2]</A>.  For more information,
1511 contact its author, Donald Munro, ccahdm@beluga.upe.ac.za.
1512
1513 <HR>
1514 <H3><A NAME="[D.3]">[D.3] What is Crafty?</A></H3>
1515
1516 Crafty is a freely-available chess program written by Bob Hyatt.
1517 Bob is the main author of the well-known chess program Cray
1518 Blitz.  Crafty is a very strong program, its code is available, commented
1519 and fairly readable, and its author is actively working on improvements.
1520
1521 <p>You can download Crafty from <a
1522 href="ftp://ftp.cis.uab.edu/pub/hyatt/"
1523 >ftp://ftp.cis.uab.edu/pub/hyatt/</a>.  Start by getting the <a
1524 href="ftp://ftp.cis.uab.edu/pub/hyatt/read.me" >read.me</a> file and
1525 reading it.  Among other things, this file contains instructions on
1526 how to install Crafty as a command-line application on your machine.
1527
1528 <p>There is a Crafty mailing list.
1529 To subscribe, send email to majordomo@cis.uab.edu, with
1530 "subscribe crafty-list" in the body.
1531
1532 <HR>
1533 <H3><A NAME="[D.4]">[D.4] How do I use Crafty with XBoard?</A></H3>
1534
1535 <p>First, you need to get Crafty and install it as a command-line
1536 application on your machine.  See topic <A HREF="#[D.3]">[D.3]</A>.
1537
1538 <p>To use Crafty with XBoard, give the -fcp
1539 parameter like this:
1540
1541 <p><PRE>
1542     xboard -fcp "./crafty" -fd <I>crafty_directory</I>
1543 </PRE>
1544
1545 Here <I>crafty_directory</I> is the directory where you installed Crafty.
1546 You can add more xboard options at the end of the command line.
1547
1548 <p>Crafty 15.14 or later is required to work properly with XBoard
1549 4.0.0 or later.  We generally recommend using the latest versions of
1550 both XBoard and Crafty.
1551
1552 <HR>
1553 <H3><A NAME="[D.5]">[D.5] How do I use Crafty with WinBoard?</A></H3>
1554
1555 <p>First, you need to get Crafty and install it as a command-line
1556 application on your machine.  See topic <A HREF="#[D.3]">[D.3]</A>.
1557 You must use the version of Crafty compiled for Win32 (wcrafty*.exe),
1558 not the version compiled for MS-DOS (crafty*.exe), and it is best to
1559 use the latest version of Crafty with the latest version of WinBoard to
1560 make sure all features are compatible and function correctly.  You can
1561 install Crafty in any directory you like.
1562
1563 <p>You also need to get WinBoard and install it in the normal way
1564 using its built-in installer.  You can do that either before or after
1565 you install Crafty.
1566
1567 <p>After both Crafty and WinBoard are installed separately, follow the
1568 directions in the WinBoard Help file (included with WinBoard) for
1569 connecting new chess engines to WinBoard.
1570
1571 <p>If you want to have Crafty act as an automated computer player on a
1572 chess server, see topic <A HREF="#[B.16]">[B.16]</A>.  Before you try
1573 to get that working, be sure you can play against Crafty locally,
1574 first without WinBoard, then with it.  Also be sure you can use
1575 WinBoard to play on the chess server yourself, without having Crafty
1576 connected to it.  You have to crawl before you can walk!
1577
1578 <HR>
1579 <H3><A NAME="[D.6]">[D.6] How do I use GNU Chess 5 with XBoard?</A></H3>
1580
1581 <p>By default, XBoard still tries to use GNU Chess 4 by running the
1582 command "gnuchessx".  That's why if you don't have GNU Chess 4, you
1583 get the error message "Failed to start first chess program gnuchessx
1584 on localhost: gnuchessx: No such file or directory."
1585
1586 <p>If you have GNU Chess 5, the command should be "gnuchess xboard"
1587 instead.  To make XBoard use this command, give the -fcp parameter
1588 like this:
1589
1590 <p><PRE>
1591     xboard -fd <I>gnuchess_directory</I> -fcp "./gnuchess xboard"
1592 </PRE>
1593
1594 Here <I>gnuchess_directory</I> is the directory where you installed
1595 GNU Chess 5 and its book.  You can add more xboard options at the
1596 end of the command line.
1597
1598 <p><HR>
1599 $Id$<br>
1600 ** End of XBoard/WinBoard FAQ **
1601 </BODY></HTML>