WYZTracker is a tool developed by Augusto Ruiz, from Retroworks, that can be used to compose music for WYZ's Player.
WYZTracker requires OpenAL. Windows Installer is here.
New player features:
Download here!
Keys reference here!!
This is the window that will appear when you first run the application:
You can see at the top the Menu Bar, then the Tool Bar, and below you can see from left to right:
Well, that's true. Actually, the first thing you see when the application starts for the first time is something like this:
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.
Now, let's see what we can do with the menu bar:
The File Menu looks like this:
And what you can do is the following:
New
: Create a new song. Be warned, WYZTracker only handles one file at a time, so the current one will be closed.Open
: Open an existing song.Save
: Saves the current song. If it wasn't saved before, it will ask you for a file name.Save As...
: Saves the current song, letting you specify a new name.Export
: Generate the .mus and .asm files in order to include them in your z80 project.Export Audio...
: Generate a wav or ogg file with the current song.Exit
: Exits the application (pretty obvious, huh?)The Edit menu looks like this:
And what you can do is the following:
Undo/Redo
: Not implemented yet :(Cut
: Cut the current selected fragment of the current pattern.Copy
: Copy the current selected fragment of the current pattern.Paste
: Paste the previously cut/copied fragment into the current position.Paste as echo
: Paste the previously cut/copied fragment into the current position, but if there is a note already in place, don't overwrite it. It will apply a decrement in volume specified by the toolbar item "Echo decrement".Select All
: Not implemented yet :(The Instruments menu looks like this:
And what you can do is the following:
Import
: Lets you import a set of instruments from a .ins file, or from a .wyz file. Just select the file type in the window that appears, and the file you want to import. It will add the instrument to the current ones. Be careful with the instrument IDs!Export
: Lets you export the current set of instruments into a .ins file.The Tools menu looks like this:
And what you can do is the following:
Options
: Will show you the options screen.Frequency table editor
: Will show you the frequency table editor.Arpeggio editor
: Will show you the arpeggio editor.The Help menu looks like this:
And what you can do is the following:
Online Help
: Will take you right here!About
: Will show you a nice about screen.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:
Base Octave
: The octave that will be used for new notes added with the virtual piano in the Pattern Editor. Can also be incremented pressing F2, and decremented pressing F3.Auto Increment
: The number of spaces the cursor will advance when adding a new note with the virtual piano in the pattern editor. It can be set to zero if we want to advance the cursor manually. Can also be incremented pressing F4, and decremented pressing F5.Highlight
: Set the interval that will be highlighted in the Pattern Editor.Stereo
: Set the output stereo mode for the current song (only valid for listening or audio export, will not affect the MUS export).Echo decrement
: Determines how many levels will the volume decrease when pasting notes as echo.By the way, all buttons have a tooltip that will be shown if you let your mouse for a while over the button.
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:
The song properties editor will let you set the song general properties, such as the song title, tempo, number of channels...
The data you can input here is:
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.
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 ;)
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.
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.
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.
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.
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.
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.
You can use a MIDI Piano. Be sure to plug it in BEFORE you start WYZTracker.
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:
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.
Note | Lower octave | Lower octave # | Higher octave | Higher octave # |
---|---|---|---|---|
C | Z | Q | ||
C# | S | 2 | ||
D | X | W | ||
D# | D | 3 | ||
E | C | E | ||
F | V | R | ||
F# | G | 5 | ||
G | B | T | ||
G# | H | 6 | ||
A | N | Y | ||
A# | J | 7 | ||
B | M | U |
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
This is the place where you can edit, add, or remove instruments for the current song. It looks like this:
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...".
An instrument is defined by:
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:
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.
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...".
An effect is defined by:
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:
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.
This is the screen where you can select:
This is the editor where notes frecuencies can be customized. You can select:
This editor will let you easily specify one channel of a pattern, with some composer visual aids.
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:
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.
Note | Lower octave | Lower octave # | Higher octave | Higher octave # |
---|---|---|---|---|
C | Z | Q | ||
C# | S | 2 | ||
D | X | W | ||
D# | D | 3 | ||
E | C | E | ||
F | V | R | ||
F# | G | 5 | ||
G | B | T | ||
G# | H | 6 | ||
A | N | Y | ||
A# | J | 7 | ||
B | M | U |