summaryrefslogtreecommitdiff
path: root/README.md
blob: a6202087c8d3dd3297b7e607b6dab286dd72c3bd (plain)
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
# twic_script
A bash script to maintain an updated SCID database of chess games downloaded from The Week In Chess (TWIC) 

==============================



  This simple bash script helps maintaining an updated database of
  chess games for SCID, based on the famous "The Week In Chess" game
  collection made available at
   
  http://www.theweekinchess.com/
 
  Games are distributed as zipped png files, which are uploaded weekly
  on http://www.theweekinchess.com/zips/ (Should that URL change at some 
  point in the future, you will just need to update the ADDR variable 
  below)

  *SYNOPSIS*

     ./twic_script.sh --help

     ./twic_script.sh [<start_issue> [<end_issue> [<pgnfile>]]]
  
  When called with "--help" as first argument, the script outputs
  a *minimal* help.

  Otherwise, if called with a start_issue (an integer, default to the 
  first issue to be downloaded, as specified into ${IDFILE}, or to 
  the first known online issue of TWIC, number 210, if ${IDFILE} does
  not exist), it will start downloading the TWIC issues from start_issue
  up to the latest (or up to end_issue, if provided). The zips are stored 
  into ${ZIPDIR} (default to "./zips"), while the png database is 
  maintained into ${PNGFILE} (default to ${DBDIR}/twic.png), or into the 
  file provided by the user as third argument. 

  The new pgn files are concatenated at the end of ${PNGFILE}, and then the
  SCID database is rebuilt (this can take a while...).

  The script maintains a record of the last downloaded issue, into the
  file ${IDFILE} (default to ${ZIPDIR}/.last_id), so that it is sufficient
  to call it regularly (e.g., as a user cron job) with no arguments in order
  to have an updated DB of chess games. 

  *DEPENDENCIES*
  
  twic_script.sh depends on:
  
  - wget (to download the zip files)
  - unzip (well, what do you think we are using it for?)
  - pgnscid (a program provided by scid to convert a pgn file into a SCID
             .si4 game DB)

  **** IMPORTANT NOTE ****
 
  BEWARE!!! IF YOU REMOVE ${PNGFILE}, THE CORRESPONDING SCID DB FILE WILL 
  BE OVERWRITTEN BY THE FIRST RUN OF THIS SCRIPT!!!


  **** DISCLAIMER ****

  THIS SCRIPT USES AND AGGREGATES ONLY PUBLICLY AVAILABLE PGN
  FILES. THIS PROJECT IS NOT RELATED IN ANY WAY TO THE WEBSITE "TWIC -
  THE WEEK IN CHESS", WHICH IS CREATED AND MAINTAINED BY Mark
  Crowther. THE BEST WAY TO SUPPORT THIS PROJECT (WHICH DOES NOT NEED
  THAT MUCH EFFORT INDEED) IS BY SUPPORTING "THE WEEK IN CHESS"
  (http://www.theweekinchess.com) AND ITS CREATOR Mark Crowther, WHO
  HAS DONE A GREAT JOB PUTTING TOGETHER A SUPERB CHESS WEBZINE.