Phrase Editor - Revision history

Achenar at 22:17, 1 December 2025

2025-12-01T22:17:25Z

← Older revision		Revision as of 22:17, 1 December 2025
Line 54:		Line 54:
	[[Image:3.5_phrases-keymap.png]]		[[Image:3.5_phrases-keymap.png]]

	In Keymap mode, phrases can be played across a range of keys and are shown spanning this range above the [[Instruments#Keyboard\|keyboard]]. A phrase can be selected by left-clicking on it, making it the active phrase with a highlighted ~~colour~~ and its [[#Phrase Properties\|properties]] displayed above the keyboard. You can shrink/expand the range of an active phrase by click-dragging its left or right edge, though phrases cannot overlap each other. Click-dragging the phrase body (not the edges) will move it around.		In Keymap mode, phrases can be played across a range of keys and are shown spanning this range above the [[Instruments#Keyboard\|keyboard]]. A phrase can be selected by left-clicking on it, making it the active phrase with a highlighted color and its [[#Phrase Properties\|properties]] displayed above the keyboard. You can shrink/expand the range of an active phrase by click-dragging its left or right edge, though phrases cannot overlap each other. Click-dragging the phrase body (not the edges) will move it around.

	If you hold down "Left Shift" and left-click on another phrase, both this and the active phrase are selected, along with any phrases between them. When multiple phrases are selected, any changes made to the active phrase will also affect the others.		If you hold down "Left Shift" and left-click on another phrase, both this and the active phrase are selected, along with any phrases between them. When multiple phrases are selected, any changes made to the active phrase will also affect the others.

Achenar at 21:51, 1 December 2025

2025-12-01T21:51:38Z

← Older revision		Revision as of 21:51, 1 December 2025
Line 5:		Line 5:
	There are two methods of creating phrases. The first uses a scaled-down version of the Renoise [[Pattern Editor]], consisting of just a single track and pattern. Besides that difference though, the [[Tracker Interface]] method of working is still the same. The second method generates phrases through the [[#Phrase Scripting\|Phrase Scripting]] engine. With this you script what you want the phrase to be - in as simple or complicated a fashion as you like - and it will be automatically generated.		There are two methods of creating phrases. The first uses a scaled-down version of the Renoise [[Pattern Editor]], consisting of just a single track and pattern. Besides that difference though, the [[Tracker Interface]] method of working is still the same. The second method generates phrases through the [[#Phrase Scripting\|Phrase Scripting]] engine. With this you script what you want the phrase to be - in as simple or complicated a fashion as you like - and it will be automatically generated.

	An instrument can feature up to 120 different phrases, one for each [[#Phrase in keymap mode\|available key]]. Phrases are part of an instrument (.xrni) and so are loaded/saved along with any samples and other instrument data. Individual Phrases (.xrnz) and Scripts (.lua) can be loaded and saved as presets using [[Libraries#Specific Preset Types\|the drop-down menu located at the top right corner]].		An instrument can feature up to 120 different phrases, one for each [[#Phrase in keymap mode\|available key]]. Phrases are part of an instrument (.xrni) and so are loaded/saved along with any samples and other instrument data. Individual Phrases (.xrnz) and Scripts (.lua) can be loaded and saved as presets using [[Libraries#Specific Preset Types\|the drop-down menu located at the top-right corner]].

	[[Image:3.5_phrases.png]]		[[Image:3.5_phrases.png]]
Line 16:		Line 16:
	While the Phrase Editor is open, by default notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to enter notes and commands as normal without triggering the phrase you're working on. However, this can be changed by [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussing]] on the [[Instruments#Keyboard\|on-screen keyboard]].		While the Phrase Editor is open, by default notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to enter notes and commands as normal without triggering the phrase you're working on. However, this can be changed by [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussing]] on the [[Instruments#Keyboard\|on-screen keyboard]].

	Notes played via a MIDI device or the [[Instruments#Keyboard\|on-screen keyboard]] ''will'' trigger the phrase itself. [[Recording and Editing Notes\|Recording notes and effects]] is done by the exact same method used for the [[Pattern Editor]]. The [[Tracker Interface#Lines\|phrase length (number of lines)]] is changed by altering the value in the box at the top left corner of the phrase. A phrase can be renamed by double-clicking on its name at the top of the phrase and typing in a new one.		Notes played via a MIDI device or the [[Instruments#Keyboard\|on-screen keyboard]] ''will'' trigger the phrase itself. [[Recording and Editing Notes\|Recording notes and effects]] is done by the exact same method used for the [[Pattern Editor]]. The [[Tracker Interface#Lines\|phrase length (number of lines)]] is changed by altering the value in the box at the top-left corner of the phrase. A phrase can be renamed by double-clicking on its name at the top of the phrase and typing in a new one.

	=== Pattern Editor Effect Variations ''(Renoise only)'' ===		=== Pattern Editor Effect Variations ''(Renoise only)'' ===

Achenar at 20:59, 25 September 2025

2025-09-25T20:59:29Z

← Older revision		Revision as of 20:59, 25 September 2025
Line 96:		Line 96:
	To switch from 'Pattern Phrases' - the [[Tracker Interface]] method of working - to 'Script Phrases', just toggle the option at the top of phrase panel: [[Image:3.5_phrases-patternscript-script.png]]		To switch from 'Pattern Phrases' - the [[Tracker Interface]] method of working - to 'Script Phrases', just toggle the option at the top of phrase panel: [[Image:3.5_phrases-patternscript-script.png]]

	The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel. The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. If you find yourself wanting to increase or decrease the text size in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"'' when the left panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]].		The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel. The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. By default, the options of 'Hover Hints' and 'Autocomplete' are enabled: use the right-click menu to disable them. If you find yourself wanting to increase or decrease the text size in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"'' when the left panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]].

	[[Image:3.5_phrases-script-rightpanel.png]]		[[Image:3.5_phrases-script-rightpanel.png]]

Achenar at 15:06, 15 July 2025

2025-07-15T15:06:00Z

← Older revision		Revision as of 15:06, 15 July 2025
Line 130:		Line 130:
	[[Image:3.5_phrases-scriptproperties.png]]		[[Image:3.5_phrases-scriptproperties.png]]

	The [[#Phrase Properties\|phrase properties]] are more limited when scripting, with BPM for Redux, Autoseek for Renoise and ~~Transpose~~ for both.		The [[#Phrase Properties\|phrase properties]] are more limited when scripting, with BPM for Redux, Autoseek for Renoise and Key Tracking for both.

Achenar at 10:41, 15 July 2025

2025-07-15T10:41:24Z

← Older revision		Revision as of 10:41, 15 July 2025
Line 12:		Line 12:
	== Creating Phrases ==		== Creating Phrases ==

	If an instrument does not have an existing phrase then the [[Image:3.5_phraseeditor-createphrase.png\|text-bottom]] button will need to be pressed.		If an instrument does not have an existing phrase then the [[Image:3.5_phraseeditor-createphrase.png\|text-bottom]] button will need to be pressed ''(holding ‘Alt’ will create a [[#Phrase Scripting\|script]])''.

	While the Phrase Editor is open, by default notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to enter notes and commands as normal without triggering the phrase you're working on. However, this can be changed by [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussing]] on the [[Instruments#Keyboard\|on-screen keyboard]].		While the Phrase Editor is open, by default notes played with the computer keyboard will play the instrument as if no phrase exists, allowing you to enter notes and commands as normal without triggering the phrase you're working on. However, this can be changed by [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussing]] on the [[Instruments#Keyboard\|on-screen keyboard]].
Line 44:		Line 44:
	[[Image:3.5_phrases-controls.png]]		[[Image:3.5_phrases-controls.png]]

	With the controls at the bottom-right of the interface you can select phrases from the grid and preview them with the play and stop buttons. The +/- buttons can be used to insert a new phrase or delete the selected phrase. It's also possible to duplicate a phrase by right-clicking on it and selecting 'Duplicate' from the menu.		With the controls at the bottom-right of the interface you can select phrases from the grid and preview them with the play and stop buttons. The +/- buttons can be used to insert a new phrase ''(holding ‘Alt’ will create a [[#Phrase Scripting\|script]])'' or delete the selected phrase. It's also possible to duplicate a phrase by right-clicking on it and selecting 'Duplicate' from the menu.

	The three buttons at the bottom-right are used to either turn phrases off entirely or select the playback method. Program mode is usually a good choice, as it allows unrestricted access to the entire range of the MIDI keyboard. For convenient access to phrases in Program mode, it's recommended to assign the various programs to separate buttons on your MIDI controller. If your host supports the recording of program changes, it should be possible to capture a performance where you switch programs on-the-fly.		The three buttons at the bottom-right are used to either turn phrases off entirely or select the playback method. Program mode is usually a good choice, as it allows unrestricted access to the entire range of the MIDI keyboard. For convenient access to phrases in Program mode, it's recommended to assign the various programs to separate buttons on your MIDI controller. If your host supports the recording of program changes, it should be possible to capture a performance where you switch programs on-the-fly.

Achenar at 12:16, 10 July 2025

2025-07-10T12:16:16Z

← Older revision		Revision as of 12:16, 10 July 2025
Line 94:		Line 94:
	[[Image:3.5_phrases-script.png]]		[[Image:3.5_phrases-script.png]]

			To switch from 'Pattern Phrases' - the [[Tracker Interface]] method of working - to 'Script Phrases', just toggle the option at the top of phrase panel: [[Image:3.5_phrases-patternscript-script.png]]

	The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel. The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. If you find yourself wanting to increase or decrease the text size in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"'' when the left panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]].		The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel. The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. If you find yourself wanting to increase or decrease the text size in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"'' when the left panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]].

Achenar at 20:46, 9 July 2025

2025-07-09T20:46:55Z

← Older revision		Revision as of 20:46, 9 July 2025
Line 94:		Line 94:
	[[Image:3.5_phrases-script.png]]		[[Image:3.5_phrases-script.png]]

	The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel.
			The Phrase Scripting engine provides an alternative method of creating phrases. Script what you want the phrase to be in the left panel and it will be automatically generated in the right panel. The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. If you find yourself wanting to increase or decrease the text size in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"'' when the left panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]].

	[[Image:3.5_phrases-script-rightpanel.png]]		[[Image:3.5_phrases-script-rightpanel.png]]

	The right panel shows events generated by the script on the stated line numbers with note, volume, panning and delay values, if any are present. If you need more space to view everything, the left and right panels can be resized by click-dragging the separator between them. If you find yourself wanting to increase or decrease the size of the text in the scripting window, then this can be done with ''"Ctrl/Cmd + I"'' or ''"Ctrl/Cmd + U"''.		As with [[Tools]] and the [[Meta Devices#*Formula\|Formula]] device, the scripting language used is [https://www.lua.org Lua,] but here you’re able to keep things concise and elegant through the use of mini-notation inspired by [https://tidalcycles.org/docs/reference/mini_notation Tidal Cycles.] Clicking "Read The Docs" at the top of the scripting panel will take you to [https://renoise.github.io/pattrns/ a complete guide,] including a list of the available commands.

	As with [[Tools]] and the [[Meta Devices#*Formula\|Formula]] device, the scripting language used is [https://www.lua.org Lua], but here you’re able to keep things concise and elegant through the use of mini-notation inspired by [https://tidalcycles.org Tidal Cycles]. Clicking "Read The Docs" at the top of the scripting panel will take you to [https://renoise.github.io/pattrns/ a complete guide], including a list of the available commands.

	To quickly get started with scripting, load in some [[Libraries#Specific Preset Types\|Preset examples]] to get an idea of how things work, then try making changes to the script and see what happens to the phrase in the right panel. Creating rhythms, melodic patterns and chords is incredibly easy, while randomisation can be inserted so the phrase plays differently each time.		To quickly get started with scripting, load in some [[Libraries#Specific Preset Types\|Preset examples]] to get an idea of how things work, then try making changes to the script and see what happens to the phrase in the right panel. Creating rhythms, melodic patterns and chords is incredibly easy, while randomisation can be inserted so the phrase plays differently each time.
Line 119:		Line 118:

	* '''Edit:''' When disabled, the script editor will be hidden and replaced by the script’s main comment, if there is one.		* '''Edit:''' When disabled, the script editor will be hidden and replaced by the script’s main comment, if there is one.
	* '''Commit/Auto-Commit:''' When Auto-Commit is enabled, script changes will be automatically applied. When disabled, changes must be manually applied by clicking the Commit button or with the shortcut ''Ctrl/Cmd * Return (when the scripting panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]])''.		* '''Commit/Auto-Commit:''' When Auto-Commit is enabled, script changes will be automatically applied. When disabled, changes must be manually applied by clicking the Commit button or with the shortcut ''"Ctrl/Cmd + Return" (when the scripting panel is [[Keyboard_Shortcuts#Keyboard_Focus_Concept\|focussed]])''.
	* '''Read The Docs:''' Takes you to [https://renoise.github.io/pattrns/ a complete Phrase Scripting guide], including a list of the available commands.		* '''Read The Docs:''' Takes you to [https://renoise.github.io/pattrns/ a complete Phrase Scripting guide], including a list of the available commands.
	* '''Render:''' Renders the script into a Pattern phrase, using the LPB and Event Count values. Depending on the script, the render may not exactly match previous script playback. The drop-down menu selection [[Image:3.5_interface-dropdown.png\|text-bottom]] sets whether the render will overwrite the [[#Phrase Controls\|currently selected phrase]] or create a new phrase.		* '''Render:''' Renders the script into a Pattern phrase, using the LPB and Event Count values. Depending on the script, the render may not exactly match previous script playback. The drop-down menu selection [[Image:3.5_interface-dropdown.png\|text-bottom]] sets whether the render will overwrite the [[#Phrase Controls\|currently selected phrase]] or create a new phrase.

Achenar at 10:05, 8 July 2025

2025-07-08T10:05:53Z

Show changes

Achenar at 17:27, 3 June 2025

2025-06-03T17:27:47Z

← Older revision		Revision as of 17:27, 3 June 2025
Line 86:		Line 86:
	** '''Transpose:''' The pitch of the phrase's notes are transposed to the key played. The playback speed of the phrase is unaffected.		** '''Transpose:''' The pitch of the phrase's notes are transposed to the key played. The playback speed of the phrase is unaffected.
	** '''Offset:''' Different keys will cause the phrase to begin playing from different lines (lower keys from earlier in the phrase, higher keys from later).		** '''Offset:''' Different keys will cause the phrase to begin playing from different lines (lower keys from earlier in the phrase, higher keys from later).
	* '''Base Note:''' The note representing the original pitch of the phrase when ''"Key Tracking"'' is set to ''"Transpose"''. ~~''Renoise only:~~ This can also be changed by right-clicking a note on the [[Instruments#Keyboard\|keyboard]], where the current Base Note is shown as a black circle''.		* '''Base Note:''' The note representing the original pitch of the phrase when ''"Key Tracking"'' is set to ''"Transpose"''. This can also be changed by right-clicking a note on the [[Instruments#Keyboard\|keyboard]], where the current Base Note is shown as a black circle.

Achenar at 17:21, 7 April 2022

2022-04-07T17:21:07Z

← Older revision		Revision as of 17:21, 7 April 2022
Line 78:		Line 78:
	* '''Beats per Minute:''' ''(Redux only)'' The current tempo of the phrase, also known as BPM. This value is set by the host DAW.		* '''Beats per Minute:''' ''(Redux only)'' The current tempo of the phrase, also known as BPM. This value is set by the host DAW.
	* '''Lines per Beat:''' This changes the number of lines in the Phrase Editor that make up a musical beat. The higher the LPB, the greater the resolution available to you for editing notes and effects. A phrase's LPB operates independently from the [[Transport Panel\|song's LPB]].		* '''Lines per Beat:''' This changes the number of lines in the Phrase Editor that make up a musical beat. The higher the LPB, the greater the resolution available to you for editing notes and effects. A phrase's LPB operates independently from the [[Transport Panel\|song's LPB]].
	* '''Shuffle:''' Shifts the playback timing of each alternate line back and forth to create a 'swinging' feel. Higher values have a more intense effect, while 0% disables it entirely. The playback style is affected by Lines per Beat values above 4, which groups multiple lines together and delays them as a whole instead of individually.		* '''Shuffle:''' Shifts the playback timing of each alternate line back and forth to create a 'swinging' feel. Higher values have a more intense effect, while 0% disables it entirely. The playback style is affected by Lines per Beat values above 4, which groups multiple lines together and delays them as a whole instead of individually. You may find it useful to watch our video, [https://youtu.be/lvTrl0rXzMU Global Groove & Phrase Shuffle.]
	* '''Autoseek:''' ''(Renoise only)'' During song playback, a phrase is normally only heard once it has been triggered by reaching its position in the pattern. Enabling Autoseek allows the phrase to be heard at any point during song playback without the need for triggering. Note that [[Sampler#Sample Properties\|Autoseeking for samples]] does not function within a phrase.		* '''Autoseek:''' ''(Renoise only)'' During song playback, a phrase is normally only heard once it has been triggered by reaching its position in the pattern. Enabling Autoseek allows the phrase to be heard at any point during song playback without the need for triggering. Note that [[Sampler#Sample Properties\|Autoseeking for samples]] does not function within a phrase.
	* '''Loop:''' Toggles whether the phrase will loop upon reaching the end.		* '''Loop:''' Toggles whether the phrase will loop upon reaching the end.