[Introduction]
LittleGPTracker (a.k.a piggy tracker) is a sample based tracker for the GP GP32, GPH GP2X, and Microsoft Windows. It implements the user interface of littlesounddj, a very famous tracker for the Gameboy platform. It currently supports 8 monophonic 8Bit/16Bit/44.1Khz stereo channels as well as 16 channel midi output. Piggy is currently under development and the latest versions of the program (along with unstable ghetto builds) can be found at the wiki.

official web site: 
http://www.10pm.org/nostromo/lgpt/

piggy wiki: 
http://mp3death.us/lgpt/

mailing list: 
http://groups.yahoo.com/group/littlegptracker/

livejournal:  
http://www.livejournal.com/community/littlegptracker/





[Controls]
ARROWS (or references to LEFT, RIGHT, UP, DOWN) refer to the joystick.

A, B, SELECT, & START starring as themselves.

RT = right trigger (shoulder button).

LT = left trigger (shoulder button).

===== Basic Editing & Navigation =====

  * ARROWs: In screen navigation
  * A: Insert chain/phrase/note
  * A,A: Insert next unused chain/phrase
  * LT+(B,A): Clone
  * B+A: Cut current position
  * A+ARROWS: Update current cursor value
  * B+ARROWS: Page up/down in song screen Moves to next/previous phrase in chain in phrase screen
  * RT+ARROWS: Switch screens

===== Selections =====

  * B: Starts selection mode
  * ARROWS: Extends selection
  * B again: copy selection to buffer, or
  * LT+A: cut current selection
  * LT+A: paste the clipboard content at current location
  

===== Playback =====

  * B+LT/B+RT : In song screen toggle between live & song mode
  
song mode:
  * START: In song screen, starts / stop the song In phrase,chain starts / stop playing the current chain/phrase
    * if there is a blank spot in a row lgpt doesn't search up the column for a chain to to play.
  * RT+START: In phrase/chain starts playing the full song from current position
		
live mode:
  * START: Queues the selected chain The queued chain will play when the chain which is currently playing finishes. If no chain is already playing on a channel, the next chain which finnishes on any channel will start the queued one. Queued phrases are shown with a blinking '>'.
    * Pressing START a second time will queue the position in immediate mode ... i.e the position will start as soon as the current playing phrase is finished.  If a chain is in immediate queue the sign '>' blinks faster.
  * RT+START: Queues the current channel to stop as soon as the currently playing chain is finished. Pressing R+START a second time will toggle immediate queue where the channel stops as soon as the current playing phrase is finished. 
  * If queuing is enabled in the chain/phrase screen, the current edited chain will be queued

===== Muting =====

  * RT+B: Toggles mute/unmute of cursor channel
    * if RT is released before B, channel stays mutes
    * if B is released before RT, channel goes back to original state
  * RT+A: Solo cursor channel
    * if RT is released before A, channel stays solo'ed
    * if A is released before RT, all channel go back to original state
  * LT+RT: restore full playback on all channels
  * RT+A,RT+B can be used in conjunction with selections. If a selection is present the toggle mute/solo action is done on all channels present in the selection  
  
  
  
  
  
  
  
[Commands]
===== ARPG abcd =====
**cycle through relative pitches a, b, c, and d (starting with original pitch, then up a semitones, b semitones and so forth). The cycle loops if there's only zero's past a given post**

Examples:

ARPG 3000:  loops between original pitch and +3 semitones

ARPG 4050:  loops between original pitch, +4 semitones, +0 semitones, + 5 semitones

  * speed of arpeggiator is constant and can not be changed

===== FLTR aabb =====
**lowpass filter, set absolute frequency value for cutoff aa & resonance bb**

  * FLTR 00FF is un-adultered sound

===== HOP ---a =====
**play position will jump to the next phrase in a chain, jumping directly at position a in the phrase.**

  * hop is instant: instrument triggers and commands on the same row will be run.
  * no effect on instruments

===== KILL --aa =====
**instrument will stop playing after aa ticks.**

===== LEGA aabb =====
**performs an exponential pitch slide from previous note value to pitch bb at speed aa.**

  * 00 is the fastest speed for aa (instant, useless)
  * bb values are relative: 00-7F are up, 80-FF are down, expressed in semi-tones
  * if LEGA is put on a row where a note is present and the pitch offset is 0 (e.g. ''C4 I3 LEGA 1000'') the slide will occur automatically from previous note to the current one at the given speed.
  * If an instrument is not triggered on the same row as LEGA, the command will re-trigger the previous instrument (unless the previous instrument is still playing).
  * LEGA does exponential pitch change (i;e. it goes at same speed through all octaves) while PITCH is linear

===== LPOF aaaa =====
** LooP OFset: Shift both the loop start & loop end values aaaa digits **

  * LPOF 0001 adds one to both values, LFOF FFFF removes one
  * reset everytime you start a new note (same as volume, pitch)
  * LPOF is absolute
  * you can't trigger a note with the LPOF, it has to be executed after a sample is playing
  * every time you trigger a sample LPOF is set back to the instrument parameters

===== MDCC aabb =====
Sends a MIDI controller. aa is the controller number and bb is its value. It will be sent on the MIDI channel of the currently running instrument.

===== PLOF aabb =====
**PLayOFfset virtually cuts any sample in 256 chunks. jump absolutely to chunk aa or relatively move forward/back bb chunks.**

===== PTCH aabb =====
  * PTCH is also time for the first two byte nibble
  * PITCH is linear pitch change

===== RTRG aabb =====
**retrigger the sound by looping the from current play position over a certain amount of ticks.**

  * bb is the number of ticks used for the looping.
  * aa is an additional value that allows to move the loop forward of aa ticks each time the loop has been done.

RTRG 0001: loop one tick from current play position

RTRG 0102: loop of two ticks but move the loop one tick every loop

RTRG 0101: does not do anything because after looping one tick, you move forward one tick and therefore go back to the current position :)

===== VOLM aabb =====
**starting from the instrument's volume setting, aproach volume bb at speed aa. 00 is the lowest volume and 00 is the fastest speed (instant).**

  * to achive sounds that grow in volume, make an instrument with volume 0 and then apply the VOLM command
  

  
  
  
[About]
copyright 2005 - 2006 Marc Resibois. This software can't be sold by any third party under any cricumstances.

Contains lopazz filter code courtesy of Beausoleil Samson-Guillemette of the northern dragons

Manual/Wiki by starpause, see http://www.mp3death.us/lgpt/