ref: 2d8bd0e14d76d4884718c73c8a002dd61e4ab987
dir: /release/help.txt/
Windows: If the program can't start at all, you might need to install "Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019" which can be found here: https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads == Frequently Asked Questions (FAQ) == * Is there a way to make the window bigger? - Set VIDEOSCALE to 2X, 3x or 4X in protracker.ini. * Is there a way to run the program in fullscreen mode? - Press F11. On some keyboards/configurations you may need to press fn+F11. * Alt+F5/ALT+F5 (copy/paste) doesn't work! - Windows: you need to make sure those keybinding are disabled in 'GeForce Experience' if you have that software installed. - OS X/mac OS/Linux: You need to remove or re-bind ALT+F4/ALT+F5 to other keys in your OS settings. * Is there a quicker way to save my module? - Press CTRL+S. This hotkey is "split mode" in Amiga ProTracker, which is not included in this PT clone. * How do I change the stereo separation (panning)? - Adjust the STEREOSEPARATION setting in protracker.ini. It's a percentage value ranging from 0 to 100. 0 being mono and 100 being 100% separated like the audio output from an Amiga. Pressing SHIFT+F12 will toggle between STEREOSEPARATION and 100% (hard pan). * How do I change the Multi channel ordering? - When in idle mode (not edit/play etc), press ALT+1/2/3/4 to increase the according multi slot. CTRL+M enables multi. * Is there a more practical way to sample audio than clicking on "Sample"? - Press the right mouse button. This means that you don't have to look at the tracker to see where you are pressing, while you are getting ready to start triggering the sampling source. Pressing the right mouse button again will stop it before the buffer got filled. * Can this ProTracker clone load PT.Config files? - Yes. Put one in the same directory as the executable program, and it will load the first one it can find (PT.Config-00..99). It will override some of the settings from protracker.ini. * Will there ever be MIDI support? - No, sorry. Try a modern module tracker instead, or ProTracker on the Amiga. * Can I revert a sample after I edited it? - Press CTRL+Z while the sampler screen is open. Keep in mind that this function is extremely limited and will only revert to the last loaded sample. * [insert random question] - Try to send an email to olav.sorensen@live.no or visit #protracker at IRCnet. == Some misc. info == WARNING: Any pitch *higher* than A-3 finetune +4 (period 124, 28603.99Hz) may not play correctly on a real Amiga. It might crackle/pop because of a DMA underrun. This also applies to any pattern effect that changes the pitch. Take extra care when doing high pitches! == Missing things that will NOT be added in the future == * Split keys (kinda pointless without MIDI). CTRL+S is now used for MOD saving * MIDI support * Setup screen == Some ProTracker keybindings are used by other things in OS X! == - In OS X, go to System Preferences -> Keyboard -> Keyboard Shortcuts and disable keybindings that could interrupt with any PT keybindings. == Non-ProTracker additions == * Toggle channels by right clicking on the scopes * MOD2WAV button for rendering the current song to a .WAV file. Read more about this function in the MAINSCREEN chapter. * PAT2SMP button for rendering the current pattern (from current row) to the current sample slot. Read more about this function in the MAINSCREEN chapter. * Sample draw tool Use right mouse button to edit sample data in the sampler like in FT2 (hold SHIFT key to stop drawing in the y axis, for making steady lines) * Sample "restore" keybinding (ctrl+z when sampler screen is open) When a sample is loaded its attributes and datas are copied to a temp buffer. If you press ctrl+z, the current sample's data+attributes will be restored. Now you don't need to reload a sample when you make a change you regret! * WAV sample loader. Supports: 8-bit, 16-bit, 24-bit, 32-bit and 32-bit/64-bit floating point The WAV samples are mixed to mono and quantized to 8-bit. It also attempts to load the "SMPL" chunk to get loop points and volume from sampler WAVs and Open ModPlug Tracker and the like. * AIFF sample loader. Supports: 8-bit, 16-bit, 24-bit and 32-bit The AIFF samples are mixed to mono and quantized to 8-bit. * PAGE UP/DOWN and HOME/END works in POS-ED, DISK OP. and the pattern editor (and HOME/END works while editing strings) * Low-pass and high-pass filters in the sampler editor * Some more stuff added to make life easier, like mouse wheel support. Now follows the main parts of this help file. MAINSCREEN ---------- ## PLAY ## Will play the song from the current song position. The pointer turns yellow, just to show you what's going on. If you hold right mouse button while clicking, it will play from the current row. Useful for checking if parts of the pattern sounds right, instead of playing from the beginning all the time. ## PATTERN ## Will play the current pattern which is shown at the bottom of the screen. The pointer turns yellow here as well. If you hold right mouse button while clicking, it will play from the current row. Useful for checking if parts of the pattern sounds right, instead of playing from the beginning all the time. ## EDIT ## Will put you in edit mode. The pointer turns blue, and you can enter notes and numbers from the keyboard. Use the arrow keys to move up/down and left/right in the pattern. Entering a note or a number will cause the pattern to jump one or more slots down, dependant on the EDITSKIP setting. ## RECORD ## Will put you in edit mode, but also play the current pattern or song. You can select this in the Edit Options menu. While the pattern or song is playing, you can type in notes and numbers from the keyboard, and they will appear in the pattern as it scrolls. The notes and numbers will also be quantized to the nearest row, so that keeping a steady rhythm is no problem (if you're good with realtime beats). The pointer will turn blue here as well as in the the normal edit mode. ## STOP ## Will stop playing of songs and patterns, recording, and will turn edit mode off. Can also be used to stop all looping samples when you're jamming. ## CLEAR ## Will first ask you what you want to clear. You can clear either all, song or samples. ## EDIT OP. ## Will exchange the spectrum analyzer or quadrascope with the edit menu(s). Pressing more than one time will browse through the edit op. screens. Click the "chord" button on screen 3 to get to the fourth screen. ## DISK OP. ## Will go to the load/save dialog. While in the DISK OP., you can press shift+character to jump to the first filename entry starting with that character. ## MOD2WAV ## Renders the current song to a 16-bit 44.1kHz stereo WAV file. Amiga panning mode, channel solo/mute, BLEP and the HP/LP filters are included in the rendering. What you hear in the tracker is what you get. ## PAT2SMP ## Renders the current pattern (from current row) to the current sample slot. This tool is handy for making drum loops. - Quality mode: - HI: 28604Hz - Play the new sample at note A-3 (finetune +4) LO: 22168Hz - Play the new sample at note F-3 (finetune +1) HI has the highest possible quality, but can only fit 2.29 seconds of audio. LO is worse in quality, but can fit slightly more at 2.95 seconds. You should use this feature in sequences to fit as much rows as you need. F.ex. start from row 0 to row 23, then make another sample from row 24 to 47, then 48 to 63. This should only give you an idea of how to use it, as you might need to do it differently depending on the song BPM, HI/LO and rows needed. If the BPM is high, you could possibly fit a whole pattern in HI mode in just two samples. The solo/mute buttons are functional and handled in the PAT2SMP mixing. ## POS ED. ## This is the position editor screen found in ProTracker 2.2 or later. You can give patterns a name for organizing, but they are not saved in the module. ## SAMPLER ## Will go to the sampler screen. The small gadgets labeled ## 1, 2, 3 and 4 ## Represents the audio channels of your Ami.. I mean, non-Amiga computer. When lit, that channel is on. When not lit, the channel is muted and and the notes in that channel will not be played. If you hold the right mouse button while clicking, the channel will be solo'd. You can also use ctrl-a to toggle an audio channel, and ctrl-q to unmute all channels. ctrl+shift-a will solo the current channel. ## Tempo ## The tempo gadget on the status bar is for setting the CIA speed, if CIA timing is used. The gadget will be updated every time you set the speed using the F command (if CIA that is). To toggle between VBLANK/CIA, press ctrl+F12. This flag is not stored in the MOD file, so be careful. CIA is the standard mode, use it all the time unless you know what you're doing. DISK OP. -------- ## Path ## The paths for modules and samples. It can be up to ~260 characters long, depending on the OS. Click on it to edit the path. Right click while editing to zero out all the text - handy for changing the drive. ## Pack ## (NOT YET IMPLEMENTED) When on, ProTracker will powerpack modules/samples before saving. ## Load module ## Will set the DISK OP. to LOAD MODULE mode. It will only list loadable files (MOD/STK/M15/PP extensions). ## Save module ## Will save the module to the current disk op. path. The filename will be <songname>.mod or mod.<songname> dependant on a protracker.ini setting. ## Load sample ## Will set the DISK OP. to LOAD SAMPLE mode. It will list all files in a dir. ## Save Sample ## Will save the current sample as WAV, IFF or RAW. Select this in the "SAVE" gadget to the left. Sample loop points are stored to IFF files. SAMPLER ------- The new sampler/sample editor was included simply because we thought the one in Noisetracker 2.0 was terrible, and we needed graphing of samples and proper loop editing. It's very fast, much faster than Audiomaster, and the editing is much simpler. We also included a resampling option which we hope you'll find useful. Editing ------- When editing a sample, use the mouse to set the cursor line and to mark ranges. ## Waveform ## Will play the full sample with loops. ## Display ## Will play the part of the sample being shown on screen. ## Range ## Will play the marked range. ## Stop ## Will stop all playing of samples. ## Show range ## Will magnify the current range and display it. ## Show all ## Will display the whole sample. ## Beg ## Will put the cursor line at the beginning of the sample. Holding SHIFT while clicking will extend the marking to the beginning. ## End ## Will put the cursor line at the end of the sample. Holding SHIFT while clicking will extend the marking to the end. ## Center ## Will put the cursor line at the center of the sample. Holding SHIFT while clicking will extend the marking to the center. ## Zoom out ## Will show double the range you are displaying. ## Range all ## Will range the part of the sample being displayed on screen. ## Cut ## (or ctrl+X) Will cut the part of the sample that's marked. ## Copy ## (or ctrl+C) Will copy the marked range to the copy buffer. ## Paste ## (or ctrl+V) Will paste the copy buffer into the current sample. ## Volume "" Will take you to the volume tool box. ## Tunetone ## Will create a tuned sinus sound, which you can tune your samples after. ## Fix DC ## Will remove any eventual DC offset in the sample, which will make it centered. This function might not always work as intended, especially not on basic waveforms. ## Filters ## Will take you to the filters tool box. ## Offs (offset) ## This displays what 9xx command value to use to play the sample from where you're pointing at in the sample data. This will display no value if the position is equal to zero, since 900 means "use last 9xx value". ## Resample ## Here's a step-by-step explanation: 1. Turn on the tuning tone. 2. Use the keyboard to find what note it is. Use finetune if needed. 3. Enter the note in the "Note:" box to the right. 4. Press resample! ## Note ## This is what note to resample to. ## Disp (display) ## This is the length of the part of the sample being shown on screen. ## Loop on/off ## This is for turning sample loops on/off without having to fiddle with the repeat and replen gadgets. ## Exit ## Exits the sampler screen. The volume tool box -------------- Set the "from" and "to" volume percentages by using the sliders, or just type in any number you please (from 0 to 200) in the percentage boxes to the right. ## Normalize ## Will find the highest volume settings possible (without clipping). ## Cancel�## Will exit the volume box. ## \ ## Will set the percentages 100%-0% ## / ## Will set the percentages 0%-100% ## - ## Will set the percentages 100%-100% ## Ramp ## Will ramp (calculate) the volume! The filters tool box -------------- This tool box lets you low-pass or high-pass a sample. Cool for vocals and drumloops, or for any filtering needs. Keep in mind that this is a crude filter, the base frequency is manually set to 16574Hz, so the cutoff values really depend on the base frequency of the sample. This means that for example a 100Hz low-pass is 100Hz only if the base frequency of the sample is 16574Hz. Just test your way to the audible cutoff you want, and press UNDO if you didn't like it. ## Undo ## Restores the sample data to the previous state. Used for when you didn't like the new filtered value. Use CTRL+Z to completely restore the sample to the state of when it was loaded. ## Exit ## Will exit the volume box. ## Low-Pass ## Will low-pass the sample with the given cutoff frequency. ## Low-Pass Frequency ## Click on this to manually set a cutoff or use the up/down gadgets. ## High-Pass ## Will high-pass the sample with the given cutoff frequency. ## High-Pass Frequency ## Click on this to manually set a cutoff or use the up/down gadgets ## Normalize Sample ## Will normalize the sample after it has been filtered, before quantizing it to 8-bit. This will prevent clipping and also result in higher quality if the filtered result was low on amplitude. EDIT OP. -------- The edit op. screens were just a handy way for us to implement all the new functions we had thought of. There are four screens, and you can browse through them by pressing the edit op. gadget more than once, or select one by clicking on the numbers 1-3. Screen four is accessed by clicking the "chord" button in edit op. screen 3. To exit edit op., click on the gadget labeled "E" or press ESC. Edit op. Screen 1: ## Transposing ## What is transposing ? Transposing lets you shift the pitch of the notes up or down. E.g. Change a C-3 to a C#3. In comparison to other trackers, ProTracker lets you transpose in just about every way you can imagine. You can transpose either the current sample or all the samples in a channel or pattern. To the right of the title bar is a small box with the letter "S" or "A". S - Only the current sample will be transposed. A - All the samples from $00-$1F will be transposed. To toggle between the two, click on the edit op. title bar. If the config entry "TransDel" is enabled, all the notes transposed out of range (C-1 to B-3) will be deleted. If not, they will not be transposed. Edit op. screen 2: (Record) ## Record ## Patt - Record current pattern only. Song - When recording, PT will move through the patterns in the song, just like normal play. ## Quantize ## Will move the notes you record to every n'th row. Entering 00 will turn off the quantizing, and the notes you play will always be inserted at the row you are at. Entering 01 will quantize the notes the the nearest row according to the speed. i.e. if you play a note after the first half has been played, it will be quantized to the row below. Entering a value like 8 will quantize to every 8th row, and so on. Got that? ## Metro (metronome) ## The first number is the speed of the metronome, and the second is the channel to play it on. The sample used for metronomes is always sample 31/$1F. Load your own favourite metronome sample. To turn off the metronome, just set the speed or channel to 00. ## Multi ## When on, PT will jump to another channel after you play a note on the keyboard. This makes it possible to play two or more notes at the same time. Edit Op. screen 2: (samples) To the right of the title bar is a small box with the letter "T", "P" or "S". T - Copy & Exchange apply to current track (channel) only. P - Copy & Exchange will affect the the whole pattern. S - Copy & Exchange will apply to the real samples in memory. To toggle between the two, click on the edit op. title bar. ## Delete ## Will delete all notes with the current sample in current channel or whole pattern. ## Kill ## Will kill the current sample. That is, remove it from memory and reset all sample settings. ## EXCHGE (exchange) ## Will exchange the sample number shown in the "from" gadget with the sample number in the "to" gadget and vice versa. "T" or "P" selects track (channel) or pattern. "S" exchanges the samples. ## MOVE ## Will move the sample number shown in the "from" gadget to the sample number in the "to" gadget. Edit Op. screen 3: (Sample Editor) To the right of the title bar is a small box with the letter "H" or "C". H - Will halve the volume on many sample altering effects to avoid clipping. C - Will not halve the volume. The sample may be clipped. To toggle between the two, click on the edit op. title bar. ## Mix ## Will mix one sample with another. PT asks you which two samples to be mixed, and where to put the result. Holding the right button and pressing mix will mix the current sample with itself. You can offset the sample by setting a position in the "pos" gadget. If you set "mod" to a non-zero value, the sample will also be modulated. ## Echo ## Will create a echo effect on the current sample. Use "pos" to set the delay time of the echo. If you want more room to echo in, just turn up the length of the sample. ## Boost (treble increase) ## Will turn up the treble of the sample. Use this on hi-hats and snares! ## Filter (treble decrease) ## Will Delta-filter the sample (treble decrease). Use this on noisy basses. ## X-Fade (crossfade) ## Will crossfade the sample (mix with itself, backwards). Handy for looping samples that are hard to loop. ## Backwd (backwards) ## Will turn the sample backwards. ## Upsamp (upsample) ## Will remove every second byte of the sample, halving the length and shifting the pitch one octave up. ## Dnsamp (downsample) ## Will double every byte of the sample, doubling the length, and shifting the pitch one octave down. If you downsample samples longer than $7FFE, you will lose the end of them. ## POS ## This is just an offset in the sample, used for a lot of things. ## MOD (modulate) ## This is used for modulation. Press "MOD" to modulate the current sample. ## CB (Cut Beginning) ## Will chop the number of bytes set in the "pos" gadget off the beginning of the sample. ## Chord ## Will take you to the Sample Chord Editor screen. ## FU (Fade Up) ## Will fade the volume from 0 to 100%. Use "Pos" to select where in the sample to fade up to. ## FD (Fade Down) ## Will fade the volume from 100 to 0%. Use "Pos" to select where in the sample to fade down from. ## VOL ## With this you can change the "real" volume of the sample. Just set a percentage and press "VOL". Edit Op.3 is now intended to be used with the new sample editor. If a range is marked, some of the functions apply to the range only. If there's no range marked, the functions will affect the whole sample. You may also set "POS" by clicking on the sample and setting the cursor line. Edit Op. screen 4: (Sample Chord Editor) ## Chord ## Will make the chord, using the current sample and the notes chosen, and the chord will be put in the current sample or a free sample slot, depending on your choice (see below). ## Reset ## Will reset the notes and the length. ## Undo ## Will undo the last change (apart from multiple arrow up/down). ## Length ## Will set the length to the maximum value, depending on the length of the original sample and the notes you chose. This will of course set the ':' after the 4 length digits (see below). Holding the right mouse button will set the length to the minimum depending on the notes chosen. '.' will be shown after the 4 digits. Mixing with the minimum length will make the sample as long as the shortest sample of the four resampled notes. Looped samples will always be 65534 in length so that it's easier for you to find good sample loop points. ## Major ## Will set a major chord, depending on the basenote. ## Minor ## Will set a minor chord, depending on the basenote. ## Sus-4 ## Will set a suspended fourth chord, depending on the basenote. ## Major7 ## Will set a major seventh chord, depending on the basenote. ## Minor7 ## Will set a minor seventh chord, depending on the basenote. ## Major6 ## Will set a major sixth chord, depending on the basenote. ## Minor6 ## Will set a minor sixth chord, depending on the basenote. ## 4 notegadgets ## The upper one is the basenote. If you press a gadget, PT will wait for you to press a note. Holding the right mouse button will reset the note. ## 4 Up/Down gadgets ## Will add/sub 1 halfnote from the current note. Holding right mouse button will add/sub 1 octave. You can reset the note by adding past B-3. ## The 4 rightmost gadgets ## Works just like the edit op gadgets. 1,2,3 takes you to the corresponding edit screen, and E exits. ## The status line ## Pressing the upper line will toggle between New or Old sample: If N, then PT will search for a free sample to put the result in. If O, then PT will put the result in the current sample, overwriting it. Note #1 ------- PT puts a '!' last in the sample name to show you that this is a chord sample. The '!' is for you to see where the destination sample has gone, it has nothing to do with the program. You can take the '!' away and rename the sample to ...-major, ...-minor etc for instance. Note #2 ------- The chosen option on the status line in edit op. 3, H(alve) or C(lip) will NOT affect the chord mixing. The mixing is done in 16-bit, then normalized and quantized to 8-bit using rounding. GENERAL INFO. ------------- Making Music ------------ Any piece of music written with ProTracker is built up from patterns. Each pattern is built up from four channels, one for each of the Amiga's audio channels. A pattern is 64 lines long. The middle line is always the one you edit. If you need shorter patterns, use the pattern break (Dxx) effect command. A channel is built up like this: 32 C-3 01 C20 / \_/ |/ \_/ / / | \ Row Note Sample Effect/Command The C-3 is the note being played at row 32. 01 is the sample number, and the three last digits are the effect command, in this case, set volume to $20 (C-Command, 20-Value). ProTracker holds a table with info about the sequence in which the patterns will be played. With the "Pos" gadget you determine your position in the table. With "Pattern" you define what pattern to play at that position. "Length" defines the total size of the table. The full sequence of patterns is the song. A song is built up from up to 100 different patterns, each being played at up to 128 different positions. The small gadgets labeled "I" and "D" are Insert and Delete. With those you can insert or delete a position from your song. The length of your song will be adjusted automatically. Remember that the length of your song must always be one more than the last position, since the first position is 0. Holding down the right mouse button when pressing the Pos, Pattern and Length gadgets will speed them up a bit. Finetune -------- This is a goodie. Tune your untuned samples to match the others. Holding right mouse button while clicking will set finetune to zero. 0 436.4 hz -1 432.1 hz 1 439.0 hz -2 429.6 hz 2 441.6 hz -3 426.3 hz 3 445.1 hz -4 423.1 hz 4 447.8 hz -5 419.9 hz 5 451.5 hz -6 416.7 hz 6 455.2 hz -7 414.4 hz 7 457.0 hz -8 412.0 hz Sample ------ Clicking on the sample up/down gadgets will flicker through the samples. You can use up to 31 (hex $1F) samples in a song. Sample zero function -------------------- Pressing both mouse buttons at the same time will set the sample number to 'zero'. You can then record/edit the pattern with sample 0 to prevent ProTracker from setting the volume each time you play a new note. Length ------ The Length gadgets are simply used for setting the length of the sample. A sample can be up to 64k, 65534/$fffe long. Volume ------ Use this to set the volume the current sample will be played at. Repeat (loop start) ------ Here you set the start of the sample loop. Replen (loop length) ------ Here you set the length of the sample loop. Pressing both the left and right button on the sample gadgets will speed them up a bit. The Pattern Number Gadget ------------------------- To the middle left of the screen is a box with a number in it. The number is the current pattern number. The "Are you sure?" dialog -------------------------- In addition to the gadgets, you can use "Y" or Return for Yes, and "N" or ESC for No. Clicking the right mouse button also acts as No. The Clear dialog ---------------- In addition to the gadgets you can use "A" for All, "O" for Song, "S" for samples and "C" or ESC for Cancel. Clicking the right mouse button acts as Cancel. The Load (sample) gadget ------------------------ This gadget will set DISK OP. "load sample" mode and enter the DISK OP. The text input routine ---------------------- Now this is really simple. Clicking on a text line will enable you to edit it. Some text lines are longer than they seem, so use the arrow keys to scroll back and forth in the text. You can also use HOME/END on your keyb. The text input mode is just like an ordinary text editor. You can use backspace, delete, space, numeric pad keys and such. Pressing Return will exit text edit mode and save the changes. Pressing the right mouse button will clear the text line and exit the editing. Use ESC to just exit. Tips 'n tricks -------------- When inserting, pasting or join-pasting, hold down shift to keep the cursor from jumping to the end of the block. e.g. shift+ctrl+p Holding shift while pressing ctrl+k (kill to end of channel) will kill to start of channel instead. Use ESC or right mouse button to exit from a lot of things. Effect tips ----------- You can set the volume without playing a note. e.g. ---01000 This will set the volume for sample 1 without trigging the note. Or try trigging the sample and sliding the volume down. e.g. C-301A08 ---01A08 ---01A08 This will create a strange arpeggiato effect, like on "Cream of the earth" by Romeo Knight / RSI. Entering a new sample number without a note will swap to the new sample after the previous one was done playing. This is useful for creating a sweeping effect on chiptune styled songs, and so on. Mouse Pointer Colors -------------------- Gray - Nothing is happening. Yellow - Playing song / pattern. Green - Disk action. Blue - Edit / record. Magenta - Waiting for something (text, number or something else). Red - Something went wrong. Drumpad ------- ProTracker features a drumpad as in Noisetracker 2.0 and 2.1. Use '\' instead of period '.' to toggle modes. One or more dots will appear to the right of the TUNE/TIMING display. No dots: Normal keypad. 1 dot: Drumpad. 2 dots: Drumpad - Edit/Rec possible. Use alt+keypadkey to set note.