Home

Awesome

WYZTracker Manual

alt text

Introduction

WYZTracker is a tool developed by Augusto Ruiz, from Retroworks, that can be used to compose music for WYZ's Player.

An important note:

WYZTracker requires OpenAL. Windows Installer is here.

New player features:

Download here!
Keys reference here!!

A first look at the application

This is the window that will appear when you first run the application:

alt text

You can see at the top the Menu Bar, then the Tool Bar, and below you can see from left to right:

I didn't see that the first time!

Well, that's true. Actually, the first thing you see when the application starts for the first time is something like this:

alt text

This screen is pretty obvious, it will check whether .wyz files are associated with WYZTracker, and if not (which will probably will be the case the first time you run the application), will kindly ask you if you want to associate the .wyz file extension to WYZTracker, so that double clicking any .wyz file will open a new instance of the tracker with the specified file.

Menu Bar

Now, let's see what we can do with the menu bar:

File Menu

The File Menu looks like this:

alt text

And what you can do is the following:

Edit Menu

The Edit menu looks like this:

alt text

And what you can do is the following:

Instruments Menu

The Instruments menu looks like this:

alt text

And what you can do is the following:

Tools Menu

The Tools menu looks like this:

alt text

And what you can do is the following:

Help Menu

The Help menu looks like this:

alt text

And what you can do is the following:

Tool Bar

The tool bar has some convenient buttons in it that will allow you to do the following:

There are also some other controls in the Tool Bar:

By the way, all buttons have a tooltip that will be shown if you let your mouse for a while over the button.

Pattern Order Editor (pattern selector)

The Pattern Order Editor will let you sort the song patterns and move them around in order to create your song structure. Also is the place where you can create a new pattern, and specify how long the current pattern will be. The current pattern that is being edited is selected in this editor too.

Here is what you can do with this editor:

alt text

Song Properties Editor

The song properties editor will let you set the song general properties, such as the song title, tempo, number of channels...

alt text

The data you can input here is:

Envelope Settings Editor

The envelope settings editor is used to set the current parameters that will be used when adding notes that are going to be played using the Sawtooth instrument.

alt text

The settings map directly to the parameters the AY uses to control the envelopes, so I highly recommend you to play with them and see how they sound combined. You can do this with a new song. Select the Sawtooth instrument in the instrument selector, and start pressing keys from the virtual piano. Change some settings and press some more... And please, try the Active frequencies setting ;)

##Instrument Selector

This is a list of the instruments defined for the current song. You can change the selected instrument, which is the one that will be used when pressing keys of the Virtual Piano. Also, right clicking an instrument will allow you to export that instrument. In order to export all of them at once, use the Menu Bar, or the export button in the tool bar below the instrument selector.

alt text

Double clicking an instrument will show you the Instrument Editor.

There is a toolbar below the selector that will allow you to create a new instrument, delete the selected one, import instruments, export instruments, show the instrument editor, and display the current instrument name.

You can change the currently selected Instrument quickly by pressing F6 and/or F7.

Effect Selector

This is a list of effects defined for the current song. Right clicking an effect will allow you to export the current effect. In order to export all of them at once, use the Menu Bar, or the export button in the tool bar below the FX selector.

alt text

Double clicking an effect will show the Effect Editor.

There is a toolbar below the selector that will allow you to create a new effect, delete the selected one, import effects, export effects, show the effect editor, and display the current effect name.

Pattern Editor

So, finally! The pattern editor is where you fill the notes that will be played for the current pattern, with which instruments, and for how long... In order to do so easily, you can use the Virtual Piano. Whenever you press a key of the virtual piano, it will add the corresponding note to the currently selected position in the pattern editor.

Working with the virtual piano

The virtual piano has two octaves. The lower octave starts with the key Z, which is a C note, and all keys in that keyboard row are the D, E, F, G notes and so on. The next row of keys is where the sharp notes lie, so there are some keys that don't have an actual note. For example, C# is the S key. The actual value of the octave is the one selected in the "Base Octave" that appears in the Tool Bar.

If the currently selected position is inside the FX channel, then the virtual piano works differently. It uses the keys 1,2,3,... for the FX, so you don't have to change the FX by selecting it when creating drum sequences.

MIDI Piano

You can use a MIDI Piano. Be sure to plug it in BEFORE you start WYZTracker.

Multiple selection

In the pattern editor you can select ranges by selecting and dragging with the left mouse button. That way you can cut, copy or apply modifiers to all notes in the selected range.

The pattern editor has a contextual menu:

alt text

All the items in this contextual menu will work on the selected range of notes. It will allow you to transpose notes, change the octave, or set the instrument to the one you specify.

Keyboard reference (for Virtual Piano)

NoteLower octaveLower octave #Higher octaveHigher octave #
CZQ
C#S2
DXW
D#D3
ECE
FVR
F#G5
GBT
G#H6
ANY
A#J7
BMU

Space: Set silence to current note
Del, Backspace: Delete note
Return: Play/Stop song
Escape: Stop song.

Cursor keys: Move around
PageUp/PageDown/Home/End: Move around (faster)

F2: Decrease base octave
F3: Increase base octave
F4: Decrease auto increment
F5: Increase auto increment
F6: Select previous instrument
F7: Select next instrument
F8: Remove instrument data from current note

Instrument Editor

This is the place where you can edit, add, or remove instruments for the current song. It looks like this:

alt text

On the left you have the instrument selector. Click on any instrument to show it on the right side. Below the instrument selector, you have a small toolbar where you can:

You can export a single instrument by right-clicking on the instrument and selecting "Export Instrument...".

Defining an instrument

An instrument is defined by:

Setting the volumes and modifiers

You can set the volumes by left clicking on the odd columns of the editor, and dragging. The checkbox "Lock" can be used to restrict the change of the current value to the column the mouse was over when the drag started.

The modifiers can be:

Testing the instrument

Click the Test button, and it will remain pressed. Now, you can test the instrument by using the Keyboard the same way you would use it to input notes in the Pattern Editor. Clicking the Test button again will release the button, and the Test will be finished.

Effect editor

alt text

On the left you have the effect selector. Click on any effect to show it on the right side. Below the effect selector, you have a small toolbar where you can:

You can export a single effect by right-clicking on the effect and selecting "Export Effect...".

Defining an effect

An effect is defined by:

Setting the levels

You can set the levels by left clicking on the editor, and dragging. The checkbox "Lock" can be used to restrict the change of the current value to the column the mouse was over when the drag started. The levels are color coded:

Testing the effect

Click the Test button, and it will remain pressed. Now, you can test the effect by using the Keyboard the same way you would use it to input effects in the Pattern Editor. Clicking the Test button again will release the button, and the Test will be finished.

Options screen

alt text

This is the screen where you can select:

Frequencies table editor

alt text

This is the editor where notes frecuencies can be customized. You can select:

Arpeggio editor

This editor will let you easily specify one channel of a pattern, with some composer visual aids.

alt text

You can specify a set of parameters that control the root note and how many octaves you want to have available to create the arpeggio, and the target pattern and channel where the notes will be set.

The parameters are:

On the lower part of the editor you can see a grid where you can set notes for the arpeggio. The notes are set by clicking with the left mouse button (and are shown in red). Clicking with the right mouse button, you will delete the note if there is a note in the current column, or insert a "stop playing" note (shown in orange).

The buttons available are:

<a name="keyreference"></a>Keys reference:

Return -> Play/Stop
Escape -> Stop

F2 -> Decrease selected octave (the one to be used in next notes, not the selected note)
F3 -> Increase selected octave
F4 -> Decrease edition increment
F5 -> Increase edition increment
F6 -> Select previous instrument
F7 -> Select next instrument
F8 -> Clear instrument

Cursors/PageUp/PageDown/Home/End -> Move selection
Backspace/Delete -> Erase selection

Shift + Cursors/PageUp/PageDown -> Modify selection
Shift + [0-9A-Z] -> Set Volume to selection (sets volume modifiers so that initial volume in note - first volume in instrument - is the specified value)
Shift + Space -> Remove volume modifier

Alt + Cursor Up -> Set next FX / note (depending on selection)
Alt + Cursor Down -> Set previous FX / note (depending on selection)
Alt + Cursor Left -> Set previous octave
Alt + Cursor Right -> Set next octave

Ctrl + Cursor Up -> Increase Volume modifier in selection.
Ctrl + Cursor Down -> Decrease Volume modifier in selection.
Ctrl + PgDn -> Next Pattern
Ctrl + PgUp -> Previous Pattern
Ctrl + Shift + V -> Paste as Delay (pastes copied notes with the specified delay volume decrement already applied).
Ctrl + Shift + Cursor Up -> Increase tempo to selection
Ctrl + Shift + Cursor Down -> Decrease tempo to selection
Ctrl + Alt + [0-9A-Z] -> Select instrument / fx (depending on selection). Applies the instrument/fx to the selection.
Ctrl + Alt + R -> Set sawtooth to selection, select sawtooth (if selection in channels other than FX)

For the FX editor:

Left/Right: Move selection.
Cursor Up/Down: Modify volume to selection.
Shift + Cursor Up/Down/PgUp/PgDown: Modify envelope frequency sliders to selection.
Shift + Cursor Left/Right: Change envelope to selection
Alt + Cursor Up/Down: Modify noise sliders to selection
Ctrl + Cursor Up/Down/PgUp/PgDown: Modify frequency sliders to selection.
Virtual Piano Keys: If Test check is pressed, test the FX. Otherwise, set frequency to that of the pressed note.

Keyboard reference (Virtual Piano)

NoteLower octaveLower octave #Higher octaveHigher octave #
CZQ
C#S2
DXW
D#D3
ECE
FVR
F#G5
GBT
G#H6
ANY
A#J7
BMU