#####                    __####
   ### ## ##   ####    ## ## -####
  ####  -#    ##_##   ###_   ####
 ####- ##    ##  ##  ##  ##  ###
####__                    #####__by C. k. yaP-##

Thank you for downloading YAK, A powerful 1-2-3 composer. If you have
any questions, e-mail me at yapchenkuang@outlook.com, subject: YAK.

June 2023, version 0.9.3b
  * stability modifications to playback and track scrubbing, [SHIFT]
    after single R / L -click
  * modifications to file open / save / backup

June 2023, version 0.9.2b
  * fixed bug (memory leak), crash on-Modify
  
June 2023, version 0.9.1b
  * removed dependence on pygame and numpy
  * removed MIDI playback / export
  * removed progress indicator
  * removed A-B-C view
  * added .WAV playback / export
  * added tempo control
  * added sample bank control
  * improved file backup
  * fixed stuck playback button
  * fixed .exe often requires Task Manager to exit
  * bug, context play sometimes crashes on-Modify. Save [Ctrl-S] often.

__________________
__InstallatioN____


YAK can run on various platforms as it was built with Python. Install the
official Python3 interpreter (and pip) for your OS, then do:

    pip install pydub
    pip install pyaudio

Also, search for / install tkinter via pip or your package manager.

A Windows x86 yak.exe made with Nuitka is also available at FreeLunch.my.
It is unsigned and will raise a false alarm from the antivirus.

__________________
__UsagE___________


Notes CDEFGAB are written as 1234567. There are no sharps or flats. Zeros: 
0, are silent notes and may be used as rests, placeholders or syncopation.  

Key signatures are written as m2 (minor 2), M1 (Major 1) etc. and may be 
inserted anywhere on a line.

Note durations are indicated by dashes after a number such as 1, 3-- or 
3---, 0----0.

There is a maximum 4 tracks. Track groups are separated by a blank newLine. 
See the sample file for more details. Writing almost anything, anywhere in 
.yk2 files is okay.

Playback by double-clicking the right or left mouse button in a barLine. 
Selecting Play from the Tool menu plays the whole song. SHIFT plays back
at double speed.

A mode line placed before the tracks allows sound, dynamics switching. Its
format is:
		
    SAMPLE_FOLDER-1-2-3-4-ppp-n

ppp is the inter-group-track-note volume-tempo coefficent similar to Unix 
file permissions and n, the tempo in milliseconds. 1,2,3,4 are the sample
banks. Each sample is named:

    b1_b1.wav ... b12_b2.wav

where b1 is a C note of 12 semitones, and _b1 is the instrument 1-4. b0.wav
is a silent sample which must be present.

Before playback, a .wav file of the song will be exported to the same folder.

__________________
__LicensinG_______


YAK is free to use; modify and distribute, free or paid, commercial or open 
source. If you like, you may mention my site FreeLunch.my