com.dufte.SimplePianoroll.xrnx
com.dufte.SimplePianoroll.xrnx copied to clipboard
Pianoroll for Renoise
Simple Pianoroll Tool for Renoise

Videos on Youtube
Showing version 2.0 in action:
Older ones
Thread on official Renoise forum
https://forum.renoise.com/t/simple-pianoroll-com-duftetools-simplepianoroll-xrnx/63034
Features
- Piano roll workflow (inspired by FL piano roll)
- Mouse support for note moving, scaling and drawing
- Mouse scroll wheel support for scrolling through grid or change the velocity of selected notes
- Follows Renoise user interface scaling option
- Polyphony support (automatically adds and remove note columns, if needed)
- Note preview via Renoise inbuild OSC Server
- Ghost Track
- Many useful mouse and keyboard shortcuts (inspired by FL, Bitwig, Ableton and Reason)
- Show several tracker related effects like note cut, note retrigger, delay
- Scale highlighting support (None, Minor scale, Major scale, Instrument scale, Automatic scale)
- Many useful options to change the behavior for your own taste
- Chord detection for playing and selected notes
- Chord stamping
- Tool Updater support
- Step sequencing via computer keyboard
- Histogram for note property manipulations
- Basic MIDI Input support for playing (no recording yet)
- And more...
Important
- To improve mouse handling, please disable mouse warping in Renoise preferences. This also fix the jumping mouse cursor. There is an option called "Mouse warping compatibility mode", if you still want to use mouse warping in Renoise. It will disable some internal functions, where disabled mouse warping is needed.
- The key combination alt + shift is a default shortcut to change the keyboard layout on Windows OS. It is
recommended to switch this off or change the keyboard shortcut to avoid problems.
See following for more details: https://answers.microsoft.com/en-us/windows/forum/all/how-to-disable-the-windows-10-language-shortcut/030016c9-bfed-48d9-8e4f-7d1030ced338 - Renoise have a 12 column limit per tack. So when more than 12 columns are needed, then some notes will stick in the current position. A hint should be displayed in Renoise toolbar.
Note rendering in piano roll
It supports different note column effects, and it will also use different note colors, when more than one instrument was used in the pattern.
Note overlapping

Note cut fx

Note retrigger fx

Note delay

Note delay for note off

Different instruments in one pattern

Install and Update
Download the latest version from official tool page:
https://www.renoise.com/tools/simple-pianoroll
Alternative download the latest build here and drop it onto Renoise (beta
build):
https://github.com/ryrun/com.dufte.SimplePianoroll.xrnx/blob/master/out/com.duftetools.SimplePianoroll.xrnx
Tool updater is supported, so when a new version is released, it should show you an update prompt.
More information about how you can install and update Renoise tools:
How to use it
General
Everyone who is familiar with a piano roll, can use it right away. It's heavily inspired by FL, Bitwig and Reason. DAW's which I've used in the past. Most common keyboard shortcuts of these like ctrl+b or ctrl+d for note duplication are working here, too.
Open the piano roll
There are several ways to open the piano roll. It's possible in the pattern view, matrix view, mixer view, instruments pane and also via main menu.
Pattern editor

Matrix view

Scale highlighting
Scale highlighting can be easily changed with the button on the bottem left. It opens a dialog, where you can switch between major or minor or change the root key.

Ghost track
With a ghost track, you can easily set note guidelines for composing. Simply choose a track, and you will see the notes in the piano roll background. With enabled mirroring, every note of your selected track will be spread across all octaves. So manually copy or transpose notes across octaves is not needed anymore. There is also a button to easily switch between the current and the ghost track.

Step sequencing with computer keyboard
In Renoise, you can use your computer keyboard to play notes. This is also possible in the piano roll. So, when you play and hold notes and use the cursor keys left or right to move the edit cursor, it will create or remove notes on the current cursor position. You can also use your midi kleyboard to play a chords and use the cursor keys to draw them, when you have seleted the midi in device in the preferences.

Histogram
The histogram shows you note values (volume, panning, delay and pitch) of your current note selection in a simple graph. It can be used to add randomness to your notes. It's inspired by Bitwig's powerful histogram feature.
There are 4 controls to manipulate these values:
- Offset is used to move the values up or down.
- Scale can be used to grow or shrink the spread across the x-axis. It can also be used to mirror the values via negative scale values.
- Chaos can be used to add randomness to each value.
- Asc by Pos / Note can be used to ascending or descending the values by note position or by note pitch.
With Apply the values will be written. With Reset the histogram controls will be set back to defaul values.

Here a little video showing you, how you can use it:
Chord detection and scale degree detection
The piano roll will always try to detect chords of the current selected or played notes. It also tries to determine the correct scale degree depending on the current scale. It can be used to unterstand music theory better and gives you more information about the current playing notes.

Chord stamping
With the chord stamping you can easily draw chords into the piano roll. The selected chord can be extended by further notes or chord inversion can be performed. If the note preview has been activated, the drawing in of chords can also be done via step sequencing. In addition, it is possible that the drawn chords are always aligned to the currently active scale. Finally, ChordGun chord templates can be read and used, too.

Mouse actions
Actions | |
---|---|
Add notes | Double click on a free spot in the grid Alternative: While hold alt its just one click |
Remove notes | Double click on a note Alternative: While hold alt its just one click |
Select a note | Click on a note. It also reads out note length and velocity of the selected note and set these values for new notes. |
Move one note or multiple notes | Click and drag a note. It will also move all selected notes, too. When alt is holded, the notes will be moved in micro steps (using delay values). Please note, that alt + note click is note removing. So you need to click first, before you hold alt. Alternative: Alt click note remove can be disabled in options, so its easier to use. Using shift during micro step note movement, forces the note to snap into a special grid (0, 0x55, 0xaa). |
Change note length | Click and hold the end of a note and move the mouse to the right. It will also increase the length of all selected notes. To decrease the note length, just move the mouse to the left. Using alt also allows you to change the length by micro steps |
Change velocity of selected notes | Hold alt and use the scroll whell |
Preview a note | Click on a note or use preview mode |
Play from mouse cursor | While holding ctrl, click on a freespot in the grid |
Play all notes from mouse cursor | While holding ctrl + shift, click and hold on a freespot in the grid |
Select multiple individual notes | While holding ctrl, click on a note |
Deselect individual notes in selection | While holding ctrl, click on a selected note |
Deselect notes | Click on a free spot in the grid |
Rectangle select notes | Click and hold left mouse button on a free spot, it starts to select all notes inside mouse position and start point. When you hold shift, the notes will be added to the current selection. |
Select all notes with a specific note value | Hold ctrl and click one of the notes in the piano keyboard control |
Select all notes with on a specific position | Hold ctrl and click one of the position indicators above the piano grid |
Duplicate selected notes | Hold shift or ctrl and start dragging the selection to duplicate the notes |
Scroll vertically | Use your mouse wheel above the piano roll grid or the piano roll keys on the left. |
Scroll horizontally | Use your mouse wheel and hold alt or shift or control above the piano roll grid or the piano roll keys on the left. Please note, some of these combinations only work, when no note is selected. |
Quick clear of vol, pan and dly controls | Left mouse click on the grid, when no note is selected. (can be disabled) |
Keyboard actions
Info: Non handled keyboard events will be sent back to the host. So renoise default keyboard shortcuts should work.
About AZERTY keyboard layout: AZERTY mode in the preferences will internally convert non number keys to number keys. So you don't need to hold shift.
Nothing selected
Keys | Description |
---|---|
F1 | Switch to select tool |
F2 | Switch to pen tool |
ctrl + F2 | Open pen tool seetings dialog |
F3 | Switch to audio preview tool |
up | Move in the grid upwards |
down | Move in the grid downwards |
left | Move edit position cursor leftwards, scroll when cursor get's outside the grid |
right | Move edit position cursor rightwards, scroll when cursor get's outside the grid |
page up | Move in the grid 16 steps upwards |
page down | Move in the grid 16 steps downwards |
shift + up | Move in the grid 12 steps upwards |
shift + down | Move in the grid 12 steps downwards |
shift + left | Move in the grid 4 steps leftwards |
shift + right | Move in the grid 4 steps rightwards |
ctrl + a | Select all visible notes |
ctrl + b or ctrl + d |
Select all visible notes and duplicate it to the right |
ctrl + u | Select all visible notes and quick chop it |
ctrl + 1 .. 9 | Set current note length |
ctrl + 0 | Double current note length |
ctrl + shift + 0 | Halve current note length |
alt + m | Mute all visible notes (set volume to 0) |
alt + h | All notes will be selected and histogram window will be opened |
alt + shift + m | Unmute all visible notes (remove volume value) |
ctrl + space or shift + space |
Play from edit cursor position |
ctrl + p | Show preferences |
One or more notes selected
Keys | Description |
---|---|
ctrl + space | Play selection |
ctrl + b or ctrl + d |
Duplicate selected notes to the right |
ctrl + u | Quick chop all selected notes |
ctrl + 1 .. 9 | Set current note length and for very selected note |
ctrl + 0 | Double current note length and for very selected note |
ctrl + shift + 0 | Halve current note length and for very selected note |
ctrl + c | Copy selected notes to internal clipboard |
ctrl + x | Cut selected notes to internal clipboard |
ctrl + v | Paste notes to the last click grid position |
alt + n | Match note value to the first selected one |
alt + m | Mute selected notes (set volume to 0) |
alt + h | Histogram window will be opened |
alt + shift + m | Unmute selected notes (remove volume value) |
alt + left or alt + right or alt + up or alt + down |
Move note selection. When shift is holded, it add notes to the current selection. |
up | Transpose note 1 semitone up |
down | Transpose note 1 semitone down |
shift + up | Transpose note 12 semitones up |
shift + down | Transpose note 12 semitones down |
ctrl + shift + up | Transpose note 7 semitones up |
ctrl + shift + down | Transpose note 7 semitones down |
ctrl + up | Transpose note 1 semitone up but stay in scale |
ctrl + down | Transpose note 1 semitone down but stay in scale |
ctrl + shift + up | Transpose note 12 semitone up but stay in scale |
ctrl + shift + down | Transpose note 12 semitone down but stay in scale |
left | Move note 1 step left |
right | Move note 1 step right |
shift + left | Move note 4 steps left |
shift + right | Move note 4 steps right |
ctrl + alt + left | Move note 1 micro steps left (using note delay) |
ctrl + alt + right | Move note 1 micro steps right (using note delay) |
ctrl + left | Increase note length by 1 |
ctrl + right | Decrease note length by 1 |
ctrl + shift + left | Increase note length by 1 micro step |
ctrl + shift + right | Decrease note length by 1 micro step |
shift + i | Invert note selection |
del or backspace | Remove selected notes |
esc | Deselect all notes |