|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 |
- __MusicQuizzer__ (_musicquizzer_) is a Python program that can help you prepare
- for any test that involves listening to excerpts of music pieces and answering
- multiple choice questions about them.
-
- # Installation
-
- ## Mac OS X
-
- Get [MacPorts](http://www.macports.org/install.php), if you don't have it.
-
- From Terminal (`/Applications/Utiliies/Terminal`), do:
-
- sudo port install python26
- sudo port install py26-game
-
- Next, download MusicQuizzer and uncompress it. Move the folder wherever you
- want (keep its contents intact!) and double-click on `mac_osx.sh` to use the
- quizzer.
-
- ## Windows
-
- MusicQuizzer is written in Python, a language that does not come with Windows
- by default. Download the latest version of Python 2.7.x
- [here](http://python.org/download/) (_not_ Python 3). Use the default settings
- during installation.
-
- Next, download and install pygame from
- [here](http://pygame.org/ftp/pygame-1.9.2a0.win32-py2.7.msi).
-
- Finally, download MusicQuizzer and extract it wherever you want. To use, simply
- double-click on the "musicquizzer" file inside (do not move or delete any of
- the other files).
-
- ## Linux (with apt-get)
-
- You should be on at least Python 2.7 (check with `python --version`), assuming
- you keep your operating system up-to-date.
-
- git clone git://github.com/earwig/music-quizzer.git
- cd music-quizzer
- sudo apt-get install python-pygame python-tk
-
- Execute `python musicquizzer.py` from your terminal when you wish to use the
- quizzer.
-
- # Usage
-
- The first time you start the program, it will download all of the 25 necessary
- (default) music pieces to the `pieces` folder. This is a ~70 MB download.
-
- MusicQuizzer will present you with an answer sheet, containing four or five
- multiple choice questions per piece (which are, of course, randomized every
- time you begin a new quiz). Press `Start Quiz` to begin listening to the
- excerpts. Each one is played for 30 seconds. You are then given five seconds of
- rest, followed by the next piece. After all excerpts have been played, you
- _cannot_ re-listen to them. Press `Submit Answers` to "hand in" your quiz and
- view the results.
-
- # Modifying
-
- The music pieces are located in `pieces/`, in `.mp3` format. The file
- `config.cfg` contains the information for each excerpt, like so:
-
- [10.mp3]
- title: Der Erlkönig
- composer: Franz Schubert
- era: Romantic
- genre: Lied
- form: Through-composed
- url: http://stuy.enschool.org/music/10_The_Erlking_Erlkonig.mp3
-
- ...and so-on. The section's header is the name of the file in `pieces/` (or
- whatever directory you have chosen), and the fields hold the information that
- MusicQuizzer will use to generate questions. The exception is the `url` field,
- which is the _direct_ URL that MusicQuizzer will use to download the piece if
- it does not have a file with that name.
-
- Feel free to rename any of the pieces, delete them, add totally new ones, or
- change their information. This program is designed to be customizable.
-
- In the config file, you can also change the length of time each excerpt is
- played for, the time between each excerpt, and other things. If an attribute is
- not defined for a certain piece, the quizzer will not ask the question in that
- excerpt, but the question will remain for other pieces.
|