TUTKA
=====

OVERVIEW
========
   Tutka is a free (as in freedom) tracker style MIDI sequencer for
   GNU/Linux (and other systems; only GNU/Linux is supported at this
   time though). It is similar to programs like SoundTracker, ProTracker 
   and FastTracker except that it does not support samples and is meant 
   for MIDI use only. Tutka is licensed under the GNU GPL.

   In Tutka songs are made of blocks. Each block represents a period in
   time. These blocks can be played in any order to form a complete song.
   Blocks are made of tracks on which the notes are placed. All tracks of
   a block are played simultaneously. Only one note can be played on one
   track at a time. Blocks can vary in length and may have different
   number of tracks.

   Each note is played using an instrument. Each instrument can have
   properties such as name, MIDI channel, default volume, hold time and
   so on. Effects can also be applied to notes. In Tutka effects include
   things like volume, aftertouch, pitch bending, note delays, setting
   tempo and so on. MIDI controllers can also be used.

   Tutka uses a custom XML based file format for storing songs. Songs in
   OctaMED SoundStudio's MMD2 file format can also be loaded.

REQUIREMENTS
============
   Tutka is written in C using the GTK+ GUI toolkit. The current
   configure script demands version 1.2.10 but earlier versions may work.
   libxml2 is used for saving and loading the custom XML files. Again,
   the configure script demands version 2.4.16 but earlier versions may
   work. Currently Tutka sends MIDI commands to MIDI devices by writing
   them to the OSS MIDI device /dev/midi.

NOTES
=====
   The current version (0.7.0) is NOT FINISHED and is recommended only
   for testing. It may not work, it may loose your work or do other
   unintended things. The author takes no responsibility for any loss of
   data caused by Tutka. See the TODO file for a list of bugs and missing
   features that need to be fixed before Tutka can be claimed to be
   stable. There are probably many other bugs as well.

COMMANDS
========
   00 Set MIDI Command value (not implemented yet) (MMD: 00)
   01 Slide/Set Pitch Wheel (not implemented yet) (MMD: 01/02/03)
   02 End block, set row (set row not implemented yet) (MMD: 0F00/1D)
   03 Set playseqpos (MMD: 0B)
   04 Stop (MMD command not converted yet) (MMD: 0FFE)
   05 Set MIDI Command (not implemented yet) (MMD: 05)
   0B Note Delay (MMD: 1F)
   0C Velocity/Aftertouch/Note off (aftertouch not implemented yet) (MMD: 0C/0A/0FFF)
   0D Channel Pressure (not implemented yet) (MMD: 0D)
   0E Set TPL (MMD: 09)
   0F Set Tempo (MMD: 0F)

COPYRIGHT
=========
   Copyright 2002 Vesa Halttunen

   Tutka is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   Tutka is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with Tutka; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
