Preferences - Revision history

Achenar at 17:00, 11 July 2026

2026-07-11T17:00:54Z

← Older revision		Revision as of 17:00, 11 July 2026
Line 266:		Line 266:
	=== Graphics ===		=== Graphics ===

	Change the texture set and bevel amounts that are used for the current Theme, affecting the buttons, ~~slider~~ and panels.		Change the texture set and bevel amounts that are used for the current Theme, affecting the buttons, sliders and panels.

Achenar at 17:00, 11 July 2026

2026-07-11T17:00:22Z

← Older revision		Revision as of 17:00, 11 July 2026
Line 258:		Line 258:
	=== Color Settings ===		=== Color Settings ===

	Change ~~individual~~ color settings~~. Colors are organized into~~ multiple categories.		Change color settings for individual GUI elements from multiple categories. This can be done with traditional RGB values or with HSV: Hue, Saturation and Value.

	=== Global Color Filter ===		=== Global Color Filter ===

	Adjust ~~all~~ color settings at once by applying Hue, Saturation or Value changes to them.		Adjust the color settings for the entire GUI at once by applying Hue, Saturation or Value changes to them. The Invert toggle will invert all of the values. Clicking the Apply button applies the current values to the Color Settings of every element.

	=== Graphics ===		=== Graphics ===

	Change the texture set and bevel amounts that are used for the current Theme.		Change the texture set and bevel amounts that are used for the current Theme, affecting the buttons, slider and panels.

Achenar at 13:17, 10 July 2026

2026-07-10T13:17:02Z

← Older revision		Revision as of 13:17, 10 July 2026
Line 249:		Line 249:
	=== Theme Files ===		=== Theme Files ===

	There are four different options for handling Theme files (.xrnc) here and they can also be Imported/Exported in the [[Disk Browser]].		There are four different options for handling Theme files (.xrnc) here and they can also be Imported/Exported in the [[Disk Browser]]. Themes are compatible between Renoise and Redux.

	* Import a Theme file~~. To store this within Renoise/Redux for future use, be sure to also Save it~~.		* Import a Theme file.
	* Export the current color settings to a file.		* Export the current color settings to a file.
	* Delete the selected user-created (non-bundled) Theme.		* Delete the selected user-created (non-bundled) Theme.
	* Save the current color settings as a user-created Theme. ~~Before pressing Save, enter~~ the desired name into the text field~~, finishing with~~ ''"~~Enter~~"''.		* Save the current color settings as a user-created Theme. Enter the desired name into the text field and click the ''"Save"'' button.

	=== Color Settings ===		=== Color Settings ===

Achenar at 22:16, 9 July 2026

2026-07-09T22:16:58Z

← Older revision		Revision as of 22:16, 9 July 2026
Line 224:		Line 224:
	* '''View multiple patterns continuously:''' ''(Renoise only)'' Show any previous/next patterns at the edges of the current pattern.		* '''View multiple patterns continuously:''' ''(Renoise only)'' Show any previous/next patterns at the edges of the current pattern.
	* '''Syntax highlighting (color-code FX commands):''' Highlights different types of [[Effect Commands]] with different colors.		* '''Syntax highlighting (color-code FX commands):''' Highlights different types of [[Effect Commands]] with different colors.
	* '''Line number format:''' Use either decimal or [[Tracker_Interface#Hexadecimal\|hexadecimal]] for the Pattern Editor line numbers.		* '''Line number format:''' Use either decimal or [[Tracker_Interface#Hexadecimal\|hexadecimal]] for the Pattern/Phrase Editor line numbers.
	* '''Font size:''' Choose between four font sizes.		* '''Font size:''' Choose between four font sizes.
	* '''H-Spacing:''' The horizontal spacing between individual letters and numbers.		* '''H-Spacing:''' The horizontal spacing between individual letters and numbers.

Achenar at 22:01, 9 July 2026

2026-07-09T22:01:04Z

← Older revision		Revision as of 22:01, 9 July 2026
Line 222:		Line 222:
	* '''Instant drag & drop:''' When enabled, clicking upon a selected area in the Pattern Editor will instantly start to drag the selection. When disabled, you have to click and hold for a second to drag.		* '''Instant drag & drop:''' When enabled, clicking upon a selected area in the Pattern Editor will instantly start to drag the selection. When disabled, you have to click and hold for a second to drag.
	* '''Hide 0s in effect columns:''' Hides 0s in the effect columns.		* '''Hide 0s in effect columns:''' Hides 0s in the effect columns.
	* '''View multiple patterns continuously:''' ''(Renoise only)'' Show previous/next patterns at the edges of the current pattern.		* '''View multiple patterns continuously:''' ''(Renoise only)'' Show any previous/next patterns at the edges of the current pattern.
	* '''Syntax highlighting (color-code FX commands):''' Highlights different types of [[Effect Commands]] with different colors.		* '''Syntax highlighting (color-code FX commands):''' Highlights different types of [[Effect Commands]] with different colors.
	* '''Line number format:''' Use either decimal or [[Tracker_Interface#Hexadecimal\|hexadecimal]] for the Pattern Editor line numbers.		* '''Line number format:''' Use either decimal or [[Tracker_Interface#Hexadecimal\|hexadecimal]] for the Pattern Editor line numbers.

Achenar at 22:18, 1 December 2025

2025-12-01T22:18:00Z

← Older revision		Revision as of 22:18, 1 December 2025
Line 252:		Line 252:

	* Import a Theme file. To store this within Renoise/Redux for future use, be sure to also Save it.		* Import a Theme file. To store this within Renoise/Redux for future use, be sure to also Save it.
	* Export the current ~~colour~~ settings to a file.		* Export the current color settings to a file.
	* Delete the selected user-created (non-bundled) Theme.		* Delete the selected user-created (non-bundled) Theme.
	* Save the current ~~colour~~ settings as a user-created Theme. Before pressing Save, enter the desired name into the text field, finishing with ''"Enter"''.		* Save the current color settings as a user-created Theme. Before pressing Save, enter the desired name into the text field, finishing with ''"Enter"''.

	=== Color Settings ===		=== Color Settings ===

	Change individual ~~colour~~ settings. ~~Colours~~ are organized into multiple categories.		Change individual color settings. Colors are organized into multiple categories.

	=== Global Color Filter ===		=== Global Color Filter ===

	Adjust all ~~colour~~ settings at once by applying Hue, Saturation or Value changes to them.		Adjust all color settings at once by applying Hue, Saturation or Value changes to them.

	=== Graphics ===		=== Graphics ===

Achenar at 23:30, 9 July 2025

2025-07-09T23:30:00Z

← Older revision		Revision as of 23:30, 9 July 2025
Line 66:		Line 66:
	=== CPU Load and Threshold ===		=== CPU Load and Threshold ===

	* '''When the CPU is above, For at least:''' - When the conditions are fulfilled, Renoise executes Panic (instantly stops all playback). This option prevents very high CPU loads from freezing your computer.		* '''When the CPU is above, For at least:''' When the conditions are fulfilled, Renoise executes Panic (instantly stops all playback). This option prevents very high CPU loads from freezing your computer.

Achenar at 11:40, 8 July 2025

2025-07-08T11:40:45Z

← Older revision		Revision as of 11:40, 8 July 2025
Line 28:		Line 28:
	* '''Reinitialize:''' Shut down and then reopen all connections to the soundcard/driver. May be useful for troubleshooting.		* '''Reinitialize:''' Shut down and then reopen all connections to the soundcard/driver. May be useful for troubleshooting.

	=== Device Settings (~~MacOS~~) ===		=== Device Settings (macOS) ===

	* '''In Device:''' If you have multiple soundcards installed, you will be able to select the one you want to use with Renoise here.		* '''In Device:''' If you have multiple soundcards installed, you will be able to select the one you want to use with Renoise here.
Line 163:		Line 163:
	Applies to exported XRNI (Renoise Instrument files) and XRNS (Renoise Song files).		Applies to exported XRNI (Renoise Instrument files) and XRNS (Renoise Song files).

	* '''Sample format:''' Select how samples are stored in Renoise song or instrument files. XRNI and XRNS files are regular zip files with a custom extension, so it is possible to open them with any tool which can use zip files (e.g. WinRar/WinZip on Windows, Stuff-it on ~~MacOS~~) and extract all of the samples manually. ''"Flac"'' will result in smaller files and should be used by default. ''"Wav"'' files might be useful if you later want to extract the files and use them in other programs.		* '''Sample format:''' Select how samples are stored in Renoise song or instrument files. XRNI and XRNS files are regular zip files with a custom extension, so it is possible to open them with any tool which can use zip files (e.g. WinRar/WinZip on Windows, Stuff-it on macOS) and extract all of the samples manually. ''"Flac"'' will result in smaller files and should be used by default. ''"Wav"'' files might be useful if you later want to extract the files and use them in other programs.


Line 215:		Line 215:
	* '''Limit frame rate to:''' Set how fast the GUI will update itself. Lower values require less CPU power, while higher values result in a more responsive user interface. Disabling the frame rate will allow use of the necessary amount of CPU power to update the GUI as responsively as possible.		* '''Limit frame rate to:''' Set how fast the GUI will update itself. Lower values require less CPU power, while higher values result in a more responsive user interface. Disabling the frame rate will allow use of the necessary amount of CPU power to update the GUI as responsively as possible.
	* '''More compatible GFX rendering (might be slower):''' ''(Windows only)'' Uses a possibly slower method of drawing the GUI with your graphics card. This option should be kept on unless it needs to be disabled to avoid problems with multi-monitor setups.		* '''More compatible GFX rendering (might be slower):''' ''(Windows only)'' Uses a possibly slower method of drawing the GUI with your graphics card. This option should be kept on unless it needs to be disabled to avoid problems with multi-monitor setups.
	* '''Enable Metal based GFX updates:''' ''(~~MacOS~~ only)'' Enables Apple's Metal API for the Renoise UI instead of using CoreGraphics. This should result in a much smoother UI when your GFX cards supports Metal, and is enabled by default when Renoise detects a Retina screen on the first launch after installation.		* '''Enable Metal based GFX updates:''' ''(macOS only)'' Enables Apple's Metal API for the Renoise UI instead of using CoreGraphics. This should result in a much smoother UI when your GFX cards supports Metal, and is enabled by default when Renoise detects a Retina screen on the first launch after installation.

	=== Pattern/Phrase Editor ===		=== Pattern/Phrase Editor ===
Line 273:		Line 273:
	[[Image:3.5_preferences-plugmisc.png]]		[[Image:3.5_preferences-plugmisc.png]]

	=== Audio Unit Plugins (~~MacOS~~ only) ===		=== Audio Unit Plugins (macOS only) ===

	* Enable the use of Audio Unit plugins in Renoise.		* Enable the use of Audio Unit plugins in Renoise.
Line 284:		Line 284:

	* Enable the use of VST2 plugins in Renoise and choose the initial folder where Renoise will scan for plugin files.		* Enable the use of VST2 plugins in Renoise and choose the initial folder where Renoise will scan for plugin files.
	* Enable and choose a second folder ''(Linux)'' or multiple folders ''(Win & ~~MacOS~~)'' where Renoise will scan for plugin files.		* Enable and choose a second folder ''(Linux)'' or multiple folders ''(Win & macOS)'' where Renoise will scan for plugin files.

	=== VST3 Plugins (Windows, Mac & Linux) ===		=== VST3 Plugins (Windows, Mac & Linux) ===

Achenar at 10:25, 8 July 2025

2025-07-08T10:25:32Z

← Older revision		Revision as of 10:25, 8 July 2025
Line 10:		Line 10:
	== Audio ==		== Audio ==

	[[Image:3.~~4_preferences~~-audio.png]]		[[Image:3.5_preferences-audio.png]]

	=== Device Settings (Windows) ===		=== Device Settings (Windows) ===
Line 19:		Line 19:
	* '''Sample Rate:''' Select the Sample Rate for playback. All internal audio processing in Renoise will be done at this rate. The higher the Sample Rate, the more detailed the results will be, but also the more CPU power will be used.		* '''Sample Rate:''' Select the Sample Rate for playback. All internal audio processing in Renoise will be done at this rate. The higher the Sample Rate, the more detailed the results will be, but also the more CPU power will be used.
	* '''Latency/Buffer Size:''' ''(not ASIO)'' Set the latency/buffer size affecting overall latency. Higher numbers will reduce the possibility of crackling sound at high CPU usage, but will also cause more latency (the time it takes the sound from Renoise to reach an output and be heard).		* '''Latency/Buffer Size:''' ''(not ASIO)'' Set the latency/buffer size affecting overall latency. Higher numbers will reduce the possibility of crackling sound at high CPU usage, but will also cause more latency (the time it takes the sound from Renoise to reach an output and be heard).
			* '''Sync Start/Stop with Ableton Link:''' If enabled, and Ableton Link is selected as [[Transport Panel\|Sync mode]], Renoise will send and react to start/stop requests from other Link clients.
	* '''Sync offset:''' A custom offset applied when [[Transport_Panel#Song_Parameters\|synchronizing audio playback to an external source such Ableton Link peers]]. It is only necessary to set this if Renoise cannot reliably detect the actual output latency of the audio device.		* '''Sync offset:''' A custom offset applied when [[Transport_Panel#Song_Parameters\|synchronizing audio playback to an external source such Ableton Link peers]]. It is only necessary to set this if Renoise cannot reliably detect the actual output latency of the audio device.
	* '''Open in exclusive mode:''' ''(WASAPI only)'' Exclusive-mode access to an audio device offers better performance and lower latency, but may block system sounds and prevent interoperability with other applications.		* '''Open in exclusive mode:''' ''(WASAPI only)'' Exclusive-mode access to an audio device offers better performance and lower latency, but may block system sounds and prevent interoperability with other applications.
Line 70:		Line 71:
	== MIDI ==		== MIDI ==

	[[Image:3.~~4_preferences~~-midi.png]]		[[Image:3.5_preferences-midi.png]]

	=== MIDI Master Keyboard/Mapping ===		=== MIDI Master Keyboard/Mapping ===
Line 100:		Line 101:
	== OSC ==		== OSC ==

	[[Image:3.~~3_preferences~~-osc.png]]		[[Image:3.5_preferences-osc.png]]

	=== Server ===		=== Server ===
Line 123:		Line 124:
	== Files ==		== Files ==

	[[Image:3.~~3_preferences~~-files.png]]		[[Image:3.5_preferences-files.png]]

	'''Note:''' All import options mentioned below can also be quickly accessed in the [[Disk Browser]] by right-clicking the file, then choosing ''"Load File with Options..."''		'''Note:''' All import options mentioned below can also be quickly accessed in the [[Disk Browser]] by right-clicking the file, then choosing ''"Load File with Options..."''
Line 167:		Line 168:
	== Keys ==		== Keys ==

	[[Image:3.~~3_preferences~~-keys.png]]		[[Image:3.5_preferences-keys.png]]

	=== Keyboard Mapping List ===		=== Keyboard Mapping List ===
Line 200:		Line 201:
	== GUI ==		== GUI ==

	[[Image:3.~~3_preferences~~-gui.png]] [[Image:dux1.~~1_preferences~~-gui.png]]		[[Image:3.5_preferences-gui.png]] [[Image:dux1.4_preferences-gui.png]]

	The GUI options allow the customisation of the general display behaviour.		The GUI options allow the customisation of the general display behaviour.
Line 213:		Line 214:
	* '''User interface scaling:''' Can override the amount of scaling used by the default ‘Auto’ setting, which uses your main display’s DPI value, and instead uses a percentage chosen from 100-350%. This option can still be used to enlarge the Renoise GUI even if your display isn’t [[HiDPI and UI Scaling\|HiDPI]], making it more comfortable to use on higher resolution screens.		* '''User interface scaling:''' Can override the amount of scaling used by the default ‘Auto’ setting, which uses your main display’s DPI value, and instead uses a percentage chosen from 100-350%. This option can still be used to enlarge the Renoise GUI even if your display isn’t [[HiDPI and UI Scaling\|HiDPI]], making it more comfortable to use on higher resolution screens.
	* '''Limit frame rate to:''' Set how fast the GUI will update itself. Lower values require less CPU power, while higher values result in a more responsive user interface. Disabling the frame rate will allow use of the necessary amount of CPU power to update the GUI as responsively as possible.		* '''Limit frame rate to:''' Set how fast the GUI will update itself. Lower values require less CPU power, while higher values result in a more responsive user interface. Disabling the frame rate will allow use of the necessary amount of CPU power to update the GUI as responsively as possible.
	* '''More compatible GFX ~~updates~~ (might be slower):''' ''(Windows only)'' Uses a possibly slower method of drawing the GUI with your graphics card. This option should be kept on unless it needs to be disabled to avoid problems with multi-monitor setups.		* '''More compatible GFX rendering (might be slower):''' ''(Windows only)'' Uses a possibly slower method of drawing the GUI with your graphics card. This option should be kept on unless it needs to be disabled to avoid problems with multi-monitor setups.
	* '''Enable Metal based GFX updates:''' ''(MacOS only)'' Enables Apple's Metal API for the Renoise UI instead of using CoreGraphics. This should result in a much smoother UI when your GFX cards supports Metal, and is enabled by default when Renoise detects a Retina screen on the first launch after installation.		* '''Enable Metal based GFX updates:''' ''(MacOS only)'' Enables Apple's Metal API for the Renoise UI instead of using CoreGraphics. This should result in a much smoother UI when your GFX cards supports Metal, and is enabled by default when Renoise detects a Retina screen on the first launch after installation.

Line 244:		Line 245:
	== Theme ==		== Theme ==

	[[Image:3.~~3_preferences~~-theme.png]]		[[Image:3.5_preferences-theme.png]]

	=== Theme Files ===		=== Theme Files ===
Line 270:		Line 271:
	== Plugins/Misc ==		== Plugins/Misc ==

	[[Image:3.~~4_preferences~~-plugmisc.png]]		[[Image:3.5_preferences-plugmisc.png]]

	=== Audio Unit Plugins (MacOS only) ===		=== Audio Unit Plugins (MacOS only) ===
Line 294:		Line 295:
	* '''Rescan:''' Rescan for new plugins or try to rescan previously failed plugins (see above).		* '''Rescan:''' Rescan for new plugins or try to rescan previously failed plugins (see above).
	* '''Scan for new plugins on startup:''' By default, Renoise will always start scanning for new plugins when launched. If you have a large amount of plugins installed then disabling this option can vastly improve startup time. If disabled, then after installing new plugins you will have manually scan for them with the ''"Rescan"'' button, as described above.		* '''Scan for new plugins on startup:''' By default, Renoise will always start scanning for new plugins when launched. If you have a large amount of plugins installed then disabling this option can vastly improve startup time. If disabled, then after installing new plugins you will have manually scan for them with the ''"Rescan"'' button, as described above.
	* '''~~Run all plugins in sandboxes~~ (➜separate process):''' ~~When enabled,~~ plugins ~~will~~ be ~~started in their own process~~, preventing bugged ones from crashing Renoise.		* '''Plugin sandboxing (➜separate process):''' Configures if and how plugins should be wrapped into separate processes, preventing bugged ones from crashing Renoise and other running plugins.

	=== Backup ===		=== Backup ===

Achenar at 17:29, 18 June 2025

2025-06-18T17:29:45Z

← Older revision		Revision as of 17:29, 18 June 2025
Line 18:		Line 18:
	* '''Out Device:''' ''(DirectSound only)'' If you have multiple soundcards installed, you will be able to select the one you want to use with Renoise here. Choose ''"Primary Device"'' to use the system's default.		* '''Out Device:''' ''(DirectSound only)'' If you have multiple soundcards installed, you will be able to select the one you want to use with Renoise here. Choose ''"Primary Device"'' to use the system's default.
	* '''Sample Rate:''' Select the Sample Rate for playback. All internal audio processing in Renoise will be done at this rate. The higher the Sample Rate, the more detailed the results will be, but also the more CPU power will be used.		* '''Sample Rate:''' Select the Sample Rate for playback. All internal audio processing in Renoise will be done at this rate. The higher the Sample Rate, the more detailed the results will be, but also the more CPU power will be used.
	* '''Latency:''' ''(~~DirectSound only~~)'' Set the buffer size affecting overall latency. Higher numbers will reduce the possibility of crackling sound at high CPU usage, but will also cause more latency (the time it takes the sound from Renoise to reach an output and be heard).		* '''Latency/Buffer Size:''' ''(not ASIO)'' Set the latency/buffer size affecting overall latency. Higher numbers will reduce the possibility of crackling sound at high CPU usage, but will also cause more latency (the time it takes the sound from Renoise to reach an output and be heard).
	* '''Sync offset:''' A custom offset applied when [[Transport_Panel#Song_Parameters\|synchronizing audio playback to an external source such Ableton Link peers]]. It is only necessary to set this if Renoise cannot reliably detect the actual output latency of the audio device.		* '''Sync offset:''' A custom offset applied when [[Transport_Panel#Song_Parameters\|synchronizing audio playback to an external source such Ableton Link peers]]. It is only necessary to set this if Renoise cannot reliably detect the actual output latency of the audio device.
			* '''Open in exclusive mode:''' ''(WASAPI only)'' Exclusive-mode access to an audio device offers better performance and lower latency, but may block system sounds and prevent interoperability with other applications.
	* '''Use hardware buffers:''' ''(DirectSound only)'' This option may speed up playback processing a bit, but only some soundcards support this. If you enable this option, then experiment with recording in the [[Waveform#Recording New Samples\|Sampler]] before deciding to use it permanently, as it may cause issues. If you experience strange results then disable this function.		* '''Use hardware buffers:''' ''(DirectSound only)'' This option may speed up playback processing a bit, but only some soundcards support this. If you enable this option, then experiment with recording in the [[Waveform#Recording New Samples\|Sampler]] before deciding to use it permanently, as it may cause issues. If you experience strange results then disable this function.
	* '''Limit to stereo in/out:''' ''(ASIO only)'' If you have a multi-IO soundcard, you can disable all inputs and outputs except for the main stereo pair. This may lead to better performance when you don't need the other channels.		* '''Limit to stereo in/out:''' ''(ASIO only)'' If you have a multi-IO soundcard, you can disable all inputs and outputs except for the main stereo pair. This may lead to better performance when you don't need the other channels.