Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

renoise.Application

The Renoise application.


Properties

log_filename : string

READ-ONLY Access to the application's full log filename and path. Will already be opened for writing, but you nevertheless should be able to read from it.

current_song : renoise.Song

READ-ONLY Get the apps main document, the song. The global "renoise.song()" function is, in fact, a shortcut to this property.

recently_loaded_song_files : string[]

READ-ONLY List of recently loaded song files.

recently_saved_song_files : string[]

READ-ONLY List of recently saved song files.

installed_tools : table<string, string>

READ-ONLY Returns information about all currently installed tools.

installed_tools_observable : renoise.Document.Observable

Fired when the list of installed tools changed.

audio_plugin_effects_observable : renoise.Document.Observable

Fired when the list of available audio plugin effects changed, for example when scanning for new plugins in the preferences. Use the component's available_plugins or available_devices properties to access currently available devices which are supported by the component such as the track device chains.

audio_plugin_instruments_observable : renoise.Document.Observable

Fired when the list of available audio plugin instruments changed, for example when scanning for new plugins in the preferences.

key_modifier_states : table<string, string>

Deprecated. READ-ONLY Use key_modifier_flags instead

key_modifier_flags : ModifierFlags

READ-ONLY Access keyboard modifier states.

window : renoise.ApplicationWindow

READ-ONLY Access to the application's window.

theme : renoise.ApplicationTheme

READ-ONLY Access to the application's color theme.

theme_observable : renoise.Document.Observable

Fired, when any theme color changed. e.g. when a new theme got loaded or when theme colors got edited in the theme preferences.

active_clipboard_index : 1 | 2 | 3 | 4

Range: (1 - 4) Get or set globally used clipboard "slots" in the application.


Functions

show_message(self, message : string)

Shows an info message dialog to the user.

show_error(self, message : string)

Shows an error dialog to the user.

show_warning(self, message : string)

Shows a warning dialog to the user.

show_status(self, message : string)

Shows a message in Renoise's status bar to the user.

show_prompt(self, title : string, message : string, button_labels : string[]?)

->label : string

Opens a modal dialog with a title, text and custom button labels. Returns the pressed button label or an empty string when canceled.

show_custom_prompt(self, title : string, content_view : renoise.Views.View, button_labels : string[], key_handler : KeyHandler?, key_handler_options : KeyHandlerOptions?, focus_handler : FocusHandler?)

->label : string

Opens a modal dialog with a title, custom content and custom button labels. See: renoise.ViewBuilder for more info about custom views.

show_custom_dialog(self, title : DialogTitle, content_view : renoise.Views.View, key_handler : KeyHandler?, key_handler_options : KeyHandlerOptions?, focus_handler : FocusHandler?)

->renoise.Dialog

Shows a non modal dialog (a floating tool window) with custom content. When no key_handler is provided, the Escape key is used to close the dialog. See: renoise.ViewBuilder for more info about custom views.

show_menu(self, dialog : renoise.Dialog, menu_entries : DialogMenuEntry[], below_view : renoise.Views.View?)

Shows a custom context menu on top of the given dialog.

When specifying a view, the menu will be shown below the given view instance. The view instance must be part of the dialog that shows the menu and must be visible. By default the menu will be shown at the current mouse cursor position.

prompt_for_path(self, title : DialogTitle)

->path : string

Opens a modal dialog to query an existing directory from the user.

prompt_for_filename_to_read(self, file_extensions : string[], title : DialogTitle)

->path : string

Opens a modal dialog to query a filename and path to read from a file.

prompt_for_multiple_filenames_to_read(self, file_extensions : string[], title : DialogTitle)

->paths : string[]

Same as 'prompt_for_filename_to_read' but allows the user to select more than one file.

prompt_for_filename_to_write(self, file_extension : string, title : DialogTitle)

->path : string

Open a modal dialog to get a filename and path for writing. When an existing file is selected, the dialog will ask whether or not to overwrite it, so you don't have to take care of this on your own.

open_url(self, url : string)

Opens the default internet browser with the given URL. The URL can also be a file that browsers can open (like xml, html files...).

open_path(self, file_path : string)

Opens the default file browser (explorer, finder...) with the given path.

install_tool(self, file_path : string)

Install order update a tool. Any errors are shown to the user during installation. Installing an already existing tool will upgrade the tool without confirmation. Upgraded tools will automatically be re-enabled, if necessary.

uninstall_tool(self, file_path : string)

Uninstall an existing tool. Any errors are shown to the user during uninstallation.

new_song(self)

Create a new song document (will ask the user to save changes if needed). The song is not created immediately, but soon after the call was made and the user did not aborted the operation. In order to continue execution with the new song, attach a notifier to 'renoise.app().new_document_observable' See: renoise.ScriptingTool for more info.

new_song_no_template(self)

Create a new song document, avoiding template XRNS songs (when present) to be loaded. The song is not created immediately, but soon after the call was made and the user did not aborted the operation. In order to continue execution with the new song, attach a notifier to 'renoise.app().new_document_observable' See: renoise.ScriptingTool for more info.

load_song(self, filename : string)

Load a new song document from the given filename (will ask to save changes if needed, any errors are shown to the user). Just like new_song(), the song is not loaded immediately, but soon after the call was made. See 'renoise.app():new_song()' for details.

load_track_device_chain(self, filename : string)

->success : boolean

Load a track device chains into the currently selected track. Any errors during the export are shown to the user.

load_track_device_preset(self, filename : string)

->success : boolean

Load a track device devices into the currently selected track. When no device is selected a new device will be created. Any errors during the export are shown to the user.

load_instrument(self, filename : string)

->success : boolean

Load an instrument into the currently selected instrument. Any errors during the export are shown to the user.

load_instrument_multi_sample(self, filename : string)

->success : boolean

Load an instrument multi sample into the currently selected instrument. Any errors during the export are shown to the user.

load_instrument_device_chain(self, filename : string)

->success : boolean

Load an instrument device chain into the currently selected instrument's device chain. When no device chain is selected, a new one will be created. Any errors during the export are shown to the user.

load_instrument_device_preset(self, filename : string)

->success : boolean

Load an instrument device into the currently selected instrument's device chain's device. When no device is selected, a new one will be created. Any errors during the export are shown to the user.

load_instrument_modulation_set(self, filename : string)

->success : boolean

Load an instrument modulation chain into the currently selected instrument's modulation chain. When no device is selected, a new one will be created. Any errors during the export are shown to the user.

load_instrument_phrase(self, filename : string)

->success : boolean

Load an instrument phrase into the currently selected instrument's phrases. When no phrase is selected, a new one will be created. Any errors during the export are shown to the user.

load_instrument_sample(self, filename : string)

->success : boolean

Load an instrument sample into the currently selected instrument's sample lists. When no sample is selected, a new one will be created. Any errors during the export are shown to the user.

load_theme(self, filename : string)

->success : boolean

Load a new theme file and apply it. Any errors during the export are shown to the user.

save_song(self)

Quicksave or save the current song under a new name. Any errors during the export are shown to the user.

save_song_as(self, filename : string)

Save the current song under a new name. Any errors during the export are shown to the user.

save_track_device_chain(self, filename : string)

->success : boolean

Save a currently selected track device chain to a file with the given name. When no device chain is selected an error is raised. returns success.

save_instrument(self, filename : string)

->success : boolean

Save a currently selected instrument to a file with the given name. When no instruemnt is selected an error is raised. returns success.

save_instrument_multi_sample(self, filename : string)

->success : boolean

Save a currently selected instrument multi sample file to a file with the given name. When no instrument is selected an error is raised. returns success.

save_instrument_device_chain(self, filename : string)

->success : boolean

Save a currently selected instrument's device chain to a file with the given name. When no chain is selected an error is raised. returns success.

save_instrument_modulation_set(self, filename : string)

->success : boolean

Save a currently selected instrument's modulation set to a file with the given name. When no modulation is selected an error is raised. returns success.

save_instrument_phrase(self, filename : string)

->success : boolean

Save a currently selected instrument's phrase to a file with the given name. When no phrase is selected an error is raised. returns success.

save_instrument_sample(self, filename : string)

->success : boolean

Save a currently selected instrument's sample to a file with the given name. When no sample is selected an error is raised. returns success.

save_theme(self, filename : string)

->success : boolean

Save a current theme to a file with the given name. returns success.


Structs

DialogMenuEntry

Defines a custom menu entry, shown in custom dialog windows.

Separating entries: To divide entries into groups prepend one or more dashes to the name:

---First Group Item Regular item

To create sub menus, define entries with a common path, using a colon as separator:

Main Menu Item Sub Menu:Sub Menu Item 1 Sub Menu:Sub Menu Item 2

To insert a script menu entry into an existing context menu, see ToolMenuEntry.


Properties

name : string

Name and optional path of the menu entry

invoke : fun()

A function that is called as soon as the entry is clicked

active : boolean?

Default: true. When false, the action will not be invoked and will be "greyed out".

selected : boolean?

Default: false. When true, the entry will be marked as "this is a selected option"

KeyEvent


Properties

name : string

name of the key, like 'esc' or 'a'

modifiers : ModifierStates

Deprecated. Use modifier_flags instead READ-ONLY the held down modifiers as a string

modifier_flags : ModifierFlags

READ-ONLY the held down modifiers as flags

character : string?

possible character representation of the key

note : integer?

virtual keyboard piano key value (starting from 0)

state : "pressed" | "released"

only present if send_key_release was set to true

repeated : boolean?

only present if send_key_repeat was set to true


Aliases

ModifierFlags

{ alt : boolean, control : boolean, meta : boolean, shift : boolean }

The currently pressed/release key's modifiers as platform independent flags. On macOS "control" is their "Command" key and the "meta" keyboard is the "Control" key. On Windows the "meta" key is the "Windows" key and on Linux the "Super" key.

ModifierStates

string

Deprecated. Use ModifierFlags instead.

The modifier keys will be provided as a string. Possible keys are dependent on the platform

  • Windows : "shift", "alt", "control", "winkey"
  • Linux : "shift", "alt", "control", "meta"
  • Mac : "shift", "option", "control", "command". If multiple modifiers are held down, the string will be formatted as " + " Their order will correspond to the following precedence shift + alt/option + control + winkey/meta/command If no modifier is pressed, this will be an empty string.

KeyHandlerOptions


Properties

send_key_repeat : boolean?

Default: true

send_key_release : boolean?

Default: false


Aliases

DialogTitle

string

The title that shows up at the title-bar of the dialog.

FocusHandler

(dialogs : renoise.Dialog, focused : boolean) -> KeyEvent?

Optional focus change notifier for a custom dialog. Will be called when the dialog gains of loses key focus. You maybe want to initialize your dloag's (modifier) keyboard states here.

KeyHandler

(dialog : renoise.Dialog, key_event : KeyEvent) -> KeyEvent?

Optional keyhandler to process key events on a custom dialog. When returning the passed key from the key-handler function, the key will be passed back to Renoise's key event chain, in order to allow processing global Renoise key-bindings from your dialog. This will not work for modal dialogs. This also only applies to global shortcuts in Renoise, because your dialog will steal the focus from all other Renoise views such as the Pattern Editor, etc.

ModifierFlags

{ alt : boolean, control : boolean, meta : boolean, shift : boolean }

The currently pressed/release key's modifiers as platform independent flags. On macOS "control" is their "Command" key and the "meta" keyboard is the "Control" key. On Windows the "meta" key is the "Windows" key and on Linux the "Super" key.

ModifierStates

string

Deprecated. Use ModifierFlags instead.

The modifier keys will be provided as a string. Possible keys are dependent on the platform

  • Windows : "shift", "alt", "control", "winkey"
  • Linux : "shift", "alt", "control", "meta"
  • Mac : "shift", "option", "control", "command". If multiple modifiers are held down, the string will be formatted as " + " Their order will correspond to the following precedence shift + alt/option + control + winkey/meta/command If no modifier is pressed, this will be an empty string.