|
|
|
@@ -0,0 +1,84 @@ |
|
|
|
__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. |
Ben Kurtovic
vor 13 Jahren