familyfortunes / README.txt

== Family Fortunes ==

(a.k.a. Family Feud)

A simple implementation of the LED score board for Family Fortunes, with
sound effects.  It needs a human to read questions and make judgements about
whether an answer is right or not. A simple set of keyboard controls is used
to control it.

=== Requirements ===

All that is needed is a modern web browser. Tested in:

 Firefox 4
 Chrome 10
 Opera 10

Assumes a screen size of about 1024 x 768 or bigger.

=== Use ===

* Download files:
* Extract the files into a folder somewhere
* Open up 'index.html' in a web browser.
* Put browser in full screen mode.
* Then use the following keys:

 n - next question
 p - previous question
 1 - 5  - correct answer (press again to remove toggle)
 x - wrong answer
 z - remove a wrong answer
 Space - wrong answer, without losing a life
        (if there is a wrong answer in the first deciding phase)

=== Questions ===

If you want to add more questions/answers, they are stored in the file
data.json.  (To avoid XHR restrictions on localhost, it is strictly
javascript, not json).  The format is simple:

  ["Question 1",
   ["Answer 1",
    "Answer 2",
    "Answer 3",
    "Answer 4",
    "Answer 5"],
  ["Question 2", ...

I used a program to generate this data from sources found online (link

== Licence ===

A number of files from differnt sources are bundled:

data.json - includes questions scraped from free questions here:

jquery-1.6.js - MIT/GPL licence

Sound effects - recorded from TV program, assumed "fair use".

BPDots.otf - Font from
             Creative Commons Licence

The remaining file (index.html) is original, and free to use and modify
under the MIT licence.