What is Music Tracker?
What is PsyTexx?
PsyTexx user interface
Keyboard shortcuts
Compiling
PsyTexx Config File (file with an options)
PsyTexx Skins
PsyTexx Fonts
Contact info

What is Music Tracker?
Tracker is the generic term for a class of software music sequencers which, in their purest form, allow the user to arrange sound samples stepwise on a timeline across several channels. A tracker's interface is primarily numeric; notes are entered via the keyboard, whilst length, parameters, effects and so forth are entered in hexadecimal. A complete song consists of several small multi-channel patterns chained together via a master list.
Other info is here: http://en.wikipedia.org/wiki/Tracker

What is PsyTexx?
PsyTexx is the cross-platform music tracker based on the XM (FastTracker eXtended Module) format. Currently it's available for a following OS: Windows, Linux (X11 and text console) and PalmOS.
Official homepage: www.warmplace.ru

PsyTexx user interface

Keyboard shortcuts
Space - Record mode ON/OFF
F1..F7 - Select octave 1..7
Shift + F3 - Cut a channel
Shift + F4 - Copy a channel
Shift + F5 - Paste a channel
Ctrl + F3 - Cut a pattern
Ctrl + F4 - Copy a pattern
Ctrl + F5 - Paste a pattern
Tab - Go to a next channel
Shift + Tab - Go to a previous channel
Down - Go to a next line
Up - Go to a previous line
Escape - Exit to OS

Compiling
1. Change the core/core.h file for your platform.
For example, for Win32 uncomment a following lines:
#define COLOR32BITS
#define NONPALM
#define WIN
#define DIRECTX
For the PalmOS users:
2. Go to the PsyTexx_PalmOS directory.
3. Copy makefile from "ARMFiles" dir (for the native ARM-code) or from "M68KFiles" (for more slow but compatible code) to the PsyTexx_PalmOS dir.
4. Edit line with reference to the PalmOS SDK dir in the makefile: for example, SDK = /usr/sdk-5/
5. Type "make"
6. If no errors, install psytexx.prc to your device.
PalmOS compiling tools:
m68k-palmos-gcc version 2.95.3-kgpd 20010315 (release)
arm-palmos-gcc version 3.2.2 (prc-tools)
arm-elf-gcc version 3.2.1 (ecos-gnutools-v1.4)
pilrc version 3.0
For the Linux users:
2. Go to the PsyTexx_linux directory.
3. Uncomment necessary lines (for console, OpenGL or X11) in the begining of the makefile. For example:
# X11 libs:
LIB = -lpthread -lstdc++ -lX11
4. Type "make"
5. If no errors, type "./psytexx"
Linux compiling tools:
gcc version 3.3.5 (Debian 1:3.3.5-8)
valgrind version 2.2.0 (Memory debugger for x86)
For the Win32 users:
2. Check for the VisualStudio project in the PsyTexx_win32 directory.

PsyTexx Config File (file with an options)
It is the simple text file called "prop_config" (in the directory with PsyTexx) with a some lines like this:

    //#####################################
    //It is the config file for the PsyTexx
    //#####################################

    width   320
    height  320
    flip    0
    buffer  1024

    @

There are:
width, height - width and height of the window;
flip - flip screen mode for some devices; values: 0/1;
buffer - sound buffer size (in samples); buffer_size_in_bytes = buffer * (bits_per_channel / 8) * number_of_channels;
@ - end of config file (don't forget about this symbol!).

PsyTexx Skins
What is skin?
In a few words it's a some beautifull BMP-image, that will be background image in your PsyTexx. And remember, that the lower line in this image is the color palette (color gradient) for the PsyTexx user interface.
How to use?
Your skin must be called as "back.bmp". Just put it into the directory with the PsyTexx. For the PalmOS users: convert "back.bmp" to the "back.pdb" (use the file2pdb converter) and install it to Palm.

PsyTexx Fonts
What is font?
It is a BMP-image called "font.bmp".
How to use?
Just put "font.bmp" into the directory with the PsyTexx. (For the PalmOS users: convert "back.bmp" to the "back.pdb" (use the file2pdb converter) and install it to Palm) And then press a "FNT" key on the virtual keyboard for a current font changing.
By default PsyTexx has a built-in 8x8 font.

Please, send all your comments and founded errors (in this manual) to nightradio@gmail.com
And sorry for my "english"... :)