summaryrefslogtreecommitdiffstats
path: root/kmid/README
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commite2de64d6f1beb9e492daf5b886e19933c1fa41dd (patch)
tree9047cf9e6b5c43878d5bf82660adae77ceee097a /kmid/README
downloadtdemultimedia-e2de64d6f1beb9e492daf5b886e19933c1fa41dd.tar.gz
tdemultimedia-e2de64d6f1beb9e492daf5b886e19933c1fa41dd.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdemultimedia@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kmid/README')
-rw-r--r--kmid/README123
1 files changed, 123 insertions, 0 deletions
diff --git a/kmid/README b/kmid/README
new file mode 100644
index 00000000..52c5f759
--- /dev/null
+++ b/kmid/README
@@ -0,0 +1,123 @@
+**********************************************************************
+ KKK KK MMM MMM IIIIII DDDDD
+ KKK KK MMMMMMMMMM IIII DDDDDDD
+ KKKKK MMMMMMMMMM II DDD DD
+ Console KKKKKK MMM MM MMM IIII DDDDDDD
+ KKK KKK MMM MMM IIIIII DDDDD
+
+ ConsoleKMID
+
+
+ This info is up to date if you have KMid version 1.7
+
+________________________________________________
+If you are looking for a KMid README file, then this is NOT the one you are
+looking for. Please look the online documentation, that is, the html help
+
+I've left this file only for help on the small cousin of KMid, ConsoleKMid.
+
+ - Antonio Larrosa
+------------------------------------------------
+
+Index
+-------
+ 1. What is ConsoleKMid ?
+ 2. Requirements of consoleKMid
+ 3. Compiling consoleKMid
+ 4. Installing
+ 5. Running
+ 6. How do I use a Midi Mapper ?
+ 7. Where can I download KMid and consoleKMid from ?
+ 8. To do list
+
+1. What is ConsoleKMid ?
+------------------------
+ ConsoleKMid is a small program for Unix in console mode, which uses the same
+ player engine of KMid. Of course it doesn't have the same friendly
+ interface of KMid but it works to play midi files.
+
+ If you have the rpm distribution, you will not find the consolekmid program
+ unless you have compiled it from the src.rpm distribution
+
+
+2. Requirements of consoleKMid
+-------------------------------
+
+ A UNIX machine, a soundcard and a /dev/sequencer device well installed.
+ If you have a GUS, you need a properly installed driver from the Linux
+ Ultrasound Project, AWE cards are also supported, but you will probably
+ need to compile consoleKMid in order to get an AWE card to work.
+ FM devices are also supported.
+ I have only tested KMid in Linux, but I have had sucessful reports getting
+ KMid to work on FreeBSD
+ If you sucessfully run KMid in other unices, please tell me !
+
+ Currently GUS cards make a little sound when using the oss driver, but are
+ not supported officially, I'm looking to find people with GUS cards that
+ want to help me to provide such support (either programming or testing),
+ as I think that if nobody has worried about it it's because there's no
+ need for it ;-)
+
+3. Compiling consoleKMid
+-----------------
+ Do a configure from the parent directory, then go to the player directory,
+ and do a 'make' . Simple , isn't it ?
+
+ By default it will use the external midi device, if you want to use another
+ one (fm, awe, or anything else), edit the file main.cc and change the value
+ of DEFAULT_DEVICE to the one you want, or specify the -d option as in :
+
+ consolekmid -d 1 mymidifile.mid
+
+4. Installing
+-----------------
+ No installing of consoleKMid is actually done, just copy the consoleKMid file
+ yourself to where you want (usually /usr/local/bin ). To use the fm device,
+ you should specify in fmout.cc the path to where the fm patches are installed
+ ( /etc by default)
+
+5. Running
+--------------
+ Well, it's quite easy, just type "consolekmid" and it should run :-)
+
+6. How do I use a Midi Mapper ?
+-------------------------------
+ A Midi Mapper is the feature you have been waiting for in Linux for years,
+ (at least I have been :-) it makes a non General Midi synth, appear to the
+ computer as General Midi compliant. Thus, a GM synth is emulated with a
+ nonGM.
+ Look the KMid docs for more info on creating/using a midi map.
+ If you want to use one with consolekmid, you can use the -M option,
+ use it like this example :
+
+ consolekmid -M /opt/kde/share/apps/kmid/maps/YamahaPSS790.map mymidifile
+
+ You can also edit main.cc in the player directory and change the value of
+ DEFAULT_MAP to whatever you want, so that you don't need to specify the
+ -M option each time you run consolekmid.
+
+ If you want to define a new map for your midi keyboard, I recommend you to
+ start by copying the file yamaha790.map and modifying it. And remember to
+ send it to me so that it will be included in future revisions and other
+ people can use it !
+
+7. Where can I download KMid and consoleKMid from ?
+---------------------------------------------------
+
+ KMid's homepage is at :
+ http://developer.kde.org/~larrosa/kmid.html
+
+ From there you can download latest versions as well as know the latest
+ changes and improvements of KMid and consoleKMid
+
+8. To do list
+---------------
+ GUS support is nearly done (and also SoftOSS) but still need little
+ improvements. It should mostly work now.
+ Better AWE support and use Soundfonts
+ The KMidServer and make KMid use it.
+
+-------
+30-4-2001
+Antonio Larrosa Jimenez
+larrosa@kde.org