Installation

How to obtain klearnnotes2

You should look for the latest version of KLearnNotes2 at http://klearnnotes2.sourceforge.net/.

Requirements

First of all: for now KLearnNotes2 is a Linux/Unix program (it might work on Mac OS X). It does NOT work on Microsoft Windows. :(

To install KLearnNotes2 you have to download and compile the .tar.gz source or install one of binary packages appropriate to your Linux distribution. For binary packages you need:

  • qt libraries with multi thread support >= 3.0 (usually called qt3-mt, but it depends on a distribution)

  • kdelibs >= 3.0

To compile binaries from the sources you need "devel" version of above libraries too.

Midi sound output:

  • if you have OSS based system and a sound card with a midi sequencer kln2 sound output should work for you with default settings; for sound cards without wavetables quality of the sound may be poor, though

  • if you have ALSA based system, or quality of your sound card is not the best, you may use timidity; install timidity and patches before or after installing kln2

  • ALSA and aRts support through tse3 libraries is being prepared; actually current ALSA/tse3 and OSS/tse3 is reported to work on some systems, on others it doesn't - apparently we are still missing something :(. Please consider this feature very experimental. If you want to use this option, install tse3 library before (!) compiling KLearnNotes2.

Note, that neither timidity nor tse3 is required to compile kln2. If you don't have these the extra features will simply be disabled.

Compilation and Installation

Compiling klearnnotes2 is very easy. The following should do it:


% ./configure
% make
% make install

Note: on some RedHats default install dir is /usr/local/kde. But KDE help-viewer doesn't look there! :( If you successfully install this program, but you don't have access to the help files (F1) try: ./configure --prefix=/usr/ .

This will be default behavior for rpms anyway.

That should do it! Should you run into any problems, please report them to the author

Note: release 1.2 contains some features which are not completely prepared yet. We didn't want to confuse anybody by showing not-fully-functional parts and therefore this part of the code is turned off as a default. But if you want to see those features, add a --enable-cvsfeatures option to ./configure. This enables piano keyboard exercises. This should not be in any way dangerous - it's just, that we didn't want to hear complains about things that are not meant to work yet. :)