]> code.delx.au - virtualtones/blob - README.md
README update
[virtualtones] / README.md
1 # VirtualTones
2
3 MIDI keyboard interface.
4
5 ## About
6
7 This program was written by James Bunton <jamesbunton@delx.net.au>
8 It is licensed under the terms of the GNU GPL version 2
9 (see COPYING.txt for more details)
10
11 This program was written for Julieanne.. :-)
12 Hope you like your Christmas present!
13
14 If you have any feature requests, bug reports, etc, send them to me.
15 Thanks and enjoy..
16
17
18 ## Update
19
20 This was originally written back in in 2003 for Qt 2.3. I've recently
21 updated it to work with modern Linux.
22
23
24
25 ## Instructions
26
27 If you are using Windows 95 or later, you need a MIDI device set up.
28 If running `VirtualTones.exe` does not work, go to
29 Start->Control Panel->Multimedia and select a synthesiser.
30
31
32 If you are using Linux, make sure you have a sequencer set up.
33 Timidity++ is a good one, start it up in ALSA client mode:
34
35 ```
36 timidity -iA -Os -c /etc/timidity++/timidity-freepats.cfg
37 ```
38
39
40
41 ## Compiling
42
43 ```
44 cd virtualtones
45 qmake
46 make
47 ```
48
49
50 ## Todo
51
52 * 'Clean' the MIDI files so that notes are saved as with the exact
53 lengths of crotchets, quavers, etc. This means opening the file in a
54 notation editor, such as Finale or Rosegarden would give better
55 results.
56
57
58
59 ## Bugs
60
61 * It is impossible to push certain combinations of keys.
62 (A problem with the OS, or keyboard hardware?)
63
64 * Contrabass interface is a bit weird, but works mostly ok
65
66 * Sizes of pixmaps is off