Skip to content

ryrun/com.dufte.SimplePianoroll.xrnx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚠️ This README is currently outdated. Will be updated soon.

Simple Pianoroll Tool for Renoise

Simple Pianoroll Tool for Renoise

Table of contents

Videos on Youtube

Showing version 5.3 in action:

Older ones

v2.0:

v0.7:

v0.1:

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.
  • For note preview, you need to enable the OSC server in the Renoise preferences. Be sure, that protocol and port are correctly set for both the OSC server and the piano roll.
  • 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 overlapping

Note cut fx

Note cut fx

Note retrigger fx

Note retrigger fx

Note delay

Note delay

Note delay for note off

Note delay for note off

Different instruments in one pattern

Note delay for note off

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.

Eraser sub mode

When you hold the mouse button on note deletion and move, you can remove others notes, too. It will internally swap to the eraser mode, you can see in the toolbar, where the pen tool icon swaps to “X”.

Eraser mode

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

Open Piano Roll in Renoise

Matrix view

Open Piano Roll in Renoise in the Matrix view

Note preview

With the help of Renoise's OSC server it is possible to play the drawn as well as selected notes. You can also use your computer keyboard to play notes. The keys are the same as on the Renoise Tracker. With the preview tool you can scroll through the pattern and play all notes at the respective position. By default, the OSC server is turned off, so you have to activate it first. Furthermore, the protocol and the port number must match the settings of the Pianoroll tool. After that it should work immediately.

OSC Server settings in Renoise

Timeline bar

With the timeline bar it is possible to set, move or remove loop areas. To draw in a loop, simply hold down the ctrl key and mark the desired area with the left mouse button pressed. If the shift key is pressed, the loop area can be moved. While the song is playing and the play point is outside the loop on the right, it will be moved back into the loop automatically. Double click removes the current loop. Single click sets the editor cursor positions.

Showing usage of timeline

Made a Youtube short about this, so you can see it in action:

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.

Showing usage of scale highlighting dialog

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.

Ghost track

Chord ghost track

When no ghost track target is set, you can enable the ghost chord track. It’s using the lowest note as the first note of a chord and showing your notes above it as ghost to, so you create a chord very fast. I used it alot lately for chord melodies.

Chord 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.

Step sequecing in Simple Pianoroll Tool for Renoise

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.

Histogram feature

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 detection and scale degree detection

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.

Pen settings chord stamping

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)
Set a loop range Hold ctrl and use the mouse on the timeline bar with left mouse button to draw in a loop range
Move the current loop range Hold shift, click and hold left mouse button on the current loop range and move your mouse
Remove the current loop range Double click on the timeline bar or use the loop button

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
ctrl + shift + r Randomly deselect all notes

Inbuilt additional tools

I've added some of my internal tools, which improved my workflow in Renoise alot. I don't want to mantain more than one tool, so I've added them to this tool instead. The context menu ones are optional and disabled by default. You need to enable them in the piano roll settings (restart of Renoise is needed).

Sample Editor - Fit sample to beat sync ...

This tool helps you to calculate the correct beat sync value for timestretching of loops and set it. It tries to detect the correct BPM by the sample length in samples. Please note that the beat sync value also use your lines per beat song parameter. So this parameter shouldn't be automated in your song. When you select a part of your sample (from snare to snare) to manually select a 4 bar loop, because the sample is longer, it's using the selection length for calculation. It'll also extend the sample, when the calculated beat sync value is not a whole number. Float numbers for the beat sync parameter is currently not supported in Renoise.

Sample Editor - Fit sample to beat sync (Song BPM)

Instead of calculate the correct BPM of a sample, it uses the current Song BPM. You can use it for one shot synth for pitch shifting. Or you can create some glitchy sounds, when you automate the line per beat parameter of your song. Set a quite high LPB value, 16 for example. Then just load some drum sounds like kick / snare and hihats. Apply the "Fit sample to beat sync (Song BPM)" to each drum sample. Now create a simple drum pattern and use the ZLxx parameter to automate / change the line per beats in some parts of your loop.

This idea is inspired by a song from suunk. Here is a good interview about his technique:

Sample Editor - Align sample selection to beat

This tool helps you to align swoops or risers in your song. You set the selection cursor to a point of your riser sample, where the crash would hit, and then you choose how many lines you would use for the "rising"-part fit in. So, when you choose 32 lines, the "tail" part of the riser should be played from line 33. This can also be used on reverse crash samples, when you want to have it exaclty 32 lines long for your song.

Instrument box - Change instruments global pitch

With this function it's possible to change the instrument pitch of several instrument at once. Because of the current API limitations, it's not possible to use the instrument selection. Instead, its using empty instruments as selection borders. So, when you group your instruments and want to change the pitch of these in one step, it's possible now.

Matrix view - Duplicate content

I often want to duplicate a whole pattern. So a 64 pattern can be enlarged to a 128 pattern and the content will be duplicated. Just right-click on a pattern and choose "Duplicate content ...".

Useful global keyboard shortcuts

Some useful keyboard shortcuts for mixing and analysing. These can be found under "Global \ Simple Pianoroll - Workflow Tools". Supported plugins are currently limited. Other plugins can be added via feature requests.

Audio reference switch

Switch between Renoise song and a Reference song in your plugin on a master channel. Supported plugins currently are:

  • MeldaProduction: MCompare
  • Plugin Alliance: ADPTR MetricAB

Sub Filter switch

Enable / disable sub only filter on master channel for checking sub frequencies. Supported plugins currently are:

  • MeldaProduction: MCompare
  • Plugin Alliance: ADPTR MetricAB

Show / Hide Analyzer

Show or Hide the audio analyzer plugin on the master channel. Supported plugins currently are:

  • Voxengo: SPAN
  • Plugin Alliance: ADPTR MetricAB

Show / Hide Waveform Analyzer

Show or Hide the waveform analyzer plugin on the master channel. Supported plugins currently are:

  • Xfer Records: LFOTool_x64
  • Cableguys: ShaperBox 3

Other tools via main menu

Upgrade filters of all instruments

A small tool to upgrade old Renoise filters in instruments to the new one. Can also be used to enable anti aliasing in all samples.

About

Pianoroll for Renoise

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published