Login

Duplex

Duplex is a collection of scripts that control various aspects of Renoise with plug-and-play support for a wide range of hardware. The applications range from controlling basic aspects of the Renoise application (like Mixer, DSP chains, Pattern Matrix), to more adventurous applications like sequencers and performance tools.

What makes Duplex special is the strong focus on bi-directional communication. In practice, this will ensure that your controller is always in sync with Renoise, no matter what you do - something which is not possible with the native MIDI-mapping capabilities of Renoise.

Note: Duplex is an optional add-on, you can use any MIDI/OSC capable controller with Renoise without having to go through Duplex.

As a script author, using the Duplex framework can assist in creating programs that are adaptable for a wide range of hardware. It greatly simplifies tasks like creating sliders from buttons, or setting the LED lights on your controller using standard RGB values, and in addition it will automatically perform background tasks such as optimizing outgoing communication (to make controllers more responsive), etc.

Duplex is a standard Renoise tool (xrnx), can be downloaded from tools.renoise.com, and installed by dragging the file onto the Renoise application. Since Duplex is written entirely using the Renoise API, anyone can extend and modify it. The official version, however, is maintained by the Renoise team.

Basic usage

When installed, a new menu will appear, containing a large number of presets with names like "Launchpad Mixer + Matrix", or "Simple TouchOSC template". Each of these configurations represent a mix of different programs that we have found to be useful. Select one of them, and the Duplex Browser dialog will appear. From here, you can turn that configuration on/off, and switch between devices & configurations. This window also contain a unique feature in Duplex, a 'virtual' representation of the hardware using native Renoise UI components.

Bundled applications
- Matrix (control the Renoise matrix + patt. sequence, tutorial video on youtube)
- Mixer (control volume, panning, mute and solo state of all tracks)
- Effect (control all device parameters, or filter them by various criteria)
- StepSequencer (realtime step sequencer for grid controllers, more info)
- Transport (control the basic Renoise transport: play/stop/loop/etc.)
- Navigator (control block-loop offset/size and playback position)
- TrackSelector (provides methods for navigating between tracks)
- Recorder (live performance looper/recorder, see manual for more info)
- NotesOnWheels BETA (hybrid phrase arpeggiator/sequencer, more info, manual)
- SwitchConfiguration BETA (switch between configurations from your device)
- Grid Pie BETA (live performance tool, more info)
- XYPad BETA (dedicated control of the native XYPad device, more info)
- Rotate BETA (shift pattern/track contents in realtime)
- Keyboard BETA (Renoise keyboard replacement, more info))

Supported devices
- Akai APC & APC40, MPD24/32/32, MPK49, LPD8
- Behringer BCF-2000 / BCR-2000
- Korg KONTROL49 / microKONTROL / nanoKONTROL 1+2
- Novation Launchpad / Remote SL-MKII / Nocturn
- monome 64 / 128 (easily adapted to other models)
- Livid Instruments Ohm64
- TouchOSC (iPhone/Android/iPad)

See the full list of controllers here

Release history
0.81: initial release
0.82: improved nocturn configuration, fixed minor issue with Transport
0.83: select MIDI input and output3 ports visually
0.93: OSC device/protocol, MIDI channel support and other features
0.94: Implemented API changes in Renoise 2.6b7
0.96: Updated for Renoise 2.7, new Akai devices supported
0.97: Improvements to Effect, Recorder + TrackSelector (new app)
0.98: BETA Renoise 2.8 support + many new features

See the full changelog here

Renoise 2.8 + Beta versions
To try out the newest version of Duplex, go to this location (Renoise community)

Documentation
For the most part, the Duplex front-end is self-documenting - mouse over any part of the interface to get help and additional information about what each buttons/control does. Also, download the manual (english, japanese) to have some of the most common questions answered
- For information on how to write your own applications, look here (Renoise community)
- If you own a non-supported controller, your can read this introduction on how to write a control-map
- As a script author, you also want to check out the API docs (part of the download)

Downloads

Tool FileDateDownloads
Duplex Browser V0.94 for Renoise 2.6Oct 18th, 20102438
Duplex Browser V0.97 for Renoise 2.7Jun 16th, 20111502
Older files398
Total4338

Installation: Drop the Tool File (.xrnx) on a Renoise window.

Disclaimer:

Liability exclusion "You are downloading or installing a software application from a third-party provider. This software does not originate from Renoise and is displayed here clearly and in summary form solely as a service for the user. Renoise is not liable for malfunctions, damage, incompatibilities or other harm originating from this software or which is otherwise caused by it. Should problems occur while this software is being installed or used, please contract the relevant producer."

Haftungsausschluss „Sie sind dabei, eine Anwendung (Software) von einem Drittanbieter herunterzuladen oder zu installieren. Diese Software stammt nicht von Renoise und wird hier lediglich als Service für den Benutzer zusammenfassend übersichtlich dargestellt. Renoise haftet nicht für Fehlfunktionen, Beschädigungen, Inkompatibilitäten oder sonstige Schäden, die von dieser Software ausgehen oder sonst verursacht werden. Sollten während der Installation oder Benutzung der Software Probleme auftreten, wenden Sie sich bitte an den jeweiligen Hersteller.“

Your rating: None Average: 5 (30 votes)

Comments

TouchOSC/iPad2

In the tool window for duplex (when TouchOSC is the controller) it says below "Description: Controlmap for TouchOSC (simple layout)." Should I infer there is a premade iPad touchosc template somewhere? All I have are Mix2iPad and Logic so can't get it work correctly.

Just to reply to myself,

Just to reply to myself, again on an iPad2, the layout Danoise refers to is only available from the "iPhone" list in TouchOSC 1.7.4 "layouts", which seems to look like the controller image it represent in duplex.

RE: TouchOSC/iPad2

Yes, you are right that the TouchOSC template that comes with Duplex is based on the iPhone/Android "simple template". There shouldn't be any difference between iPhone and iPad, excerpt from the layout though.

Korg nanoKONTROL 2

First of all thanks for all your hard work on developing this software. You just managed to help Akai sell another APC40 thanks to your effort of getting great support for this unit! I also ordered a Korg nanoKONTROL2 for my "ultra-portable" setup. Hopefully they show up at my door tomorrow.
I've been, unsuccessfully, trying to track down an .xrnx-file for the 'new' nanoKontrol2. It has some valuable new buttons on it I'd like to see mapped in Duplex; Namely track select and marker advance buttons.
"Also featured is improved transport control with Mackie® HUI protocol built in." I have no idea what the last part means tho. :)
Any chance of throwing together a new .xrnx-file for this cute little thing? I'd also love to see a map for the Novation ReMOTE (25) SL (mark one), as there are some quirks using the mkII-map.
Also know that I'd gladly do these myself have I had the skills, so here's to hoping that "a loving someone" with the knowledge will do the job for me.

Big ups!

Re: Korg nanoKONTROL 2

satobox delivers: control-map for the nano2 (Renoise forum)

my bad

Ok, just noticed i called the map-file .xrnx not .xml
I'm guessing you understand what i meant anyway. Sorry for the mixup!

Duplex / Hercules Dj Console MK4 !!??!!

At first , wanna say HI ;)

i´ve a little question , can i used my " Hercules DJ Console MK4 " with renoise/duplex ?
can i use it to regulate some Fx buttons, create a cutoff or any other fx ?

the only thing that i can do this time is , play and stop :( - ( with the BPM pitch -rotary buttons )

anyone knows what i can do ? is it possible to work with MK4 and Renoise ?

thanks for your help ..

Greetz
Bertram Dee

Re: Duplex / Hercules Dj Console MK4 !!??!!

The company that makes this product is not very forthcoming with hardware specs, so my best guess is "probably".
An external review mentioned that the unit is MIDI-enabled, so you can have the basic stuff going for sure.

!!

thanks for your post :)

but now i have the 3 KORGnano´s , and they works good witch duplex , than i have load the latest renoise version , and now duplex doesn´t work **The following tools have been disabled, because they are not compatible with this version of Renoise:

com.renoise.Duplex

Please download the latest version of the tools from http://tools.renoise.com or contact the authors of the tools for assistance.***

and many other dosn´t work,too .

Greetz Bertram Dee

Crash TouchOSC

Hi, when I am trying to start Duplex with TouchOSC - it crashes. I am attaching log:

'/home/bluszcz/.renoise/V2.6.0/Scripts/Tools/com.renoise.Duplex.xrnx/' failed to execute in one of its menu entry functions.

Please contact the author (danoise [bjorn.nesby@googlemail.com]) for assistance...

./Duplex/Display.lua:568: attempt to perform arithmetic on field 'size' (a string value)
stack traceback:
./Duplex/Display.lua:568: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:701: in function '__walk_table'
./Duplex/Display.lua:372: in function 'build_control_surface'
./Duplex/Browser.lua:1473: in function 'show_control_surface'
./Duplex/Browser.lua:413: in function 'set_configuration'
./Duplex/Browser.lua:283: in function 'set_device'
./Duplex/Browser.lua:351: in function 'set_configuration'
main.lua:34: in function 'create_browser'
main.lua:44: in function 'show_dialog'
main.lua:124: in function

Hm

I am not pretty sure what is this error about - I am pretty new in Lua, but just read that there is in automatic conversion between types in Lua, i put debug stament and value of size is 3.18...

Akai LPD8 support

Hi

is there any chance to get the setup for MPD24 too? It would be really helpful, or maybe we have to deal with the same problem as in case of MPD32?:)....

ok forget it, I found it.....sorry for bothering

AKAI MPD32

Any potential for a duplex setup for the AKAI MPD32 USB controller?

Re: AKAI MPD32

Hi ninth - take look at this post.

Launchpads Mixer supports only 8 tracks

Hello!

This tool made me buy the novation launchpad! :)
I really like the Matrix+Transport config, works well.
The Matrix+Mixer+Transport has only mixer support for track 1-8 while you can scroll through all tracks for the Matrix part.

A suggestion for the Mixer; It would be great if you kept the upper row of round buttons as transport, like in the Matrix config.
First row of square buttons could then be used for track muting, using a different colour (dark red maybe)
That way you will have support for more than 8 Mixer tracks when you have the round arrow buttons for turning page to control track 9-16, 17-24 and so on.

For us not into LUA, there would be nice if we could setup own configs within the Duplex, if possible.

Thanks for this tool and hope you can increase mixer to support more than 8 tracks :)
/J

Transport?

All I wish for is a "Transport" function for the launchpad matrix.

Launchpads Mixer supports only 8 tracks

Thanks for your input Joakim! Please take a look here

Using m-audio axiom 25

Hi,

your tool looks very useful for me.
I didn't install it so far and want to know it its possible that i use your tool with my m-audio axiom 25.

It is not one of listed devices - or can i edit the mapping for this tool by myself?

Kind regards,
Ben

monome

Very nice! I just tried it out with my monome and it works!

Korg Kontrol 49?

Release coming soon for support for the Kontrol49? ...Cant wait!

Re: Korg Kontrol 49?

You're already able to use the bledding-edge version on code.google.com, but if you want to wait a little time there will soon be a public release containing Kontrol49 support

Nocturn 25 support

whoa this is nice, now that i bought novation nocturn 25 this seems to be usable, although mappings included in current package are for the non-keyboard version and although some of the controllers work, unfortunately some do not - is there any chance to see Nocturn Keyboard support in Duplex?

Re: Nocturn 25 support

If the Nocturn 25 is anything like the Novation Remote, the keyboard and dials/buttons may be split into seperate outputs? I can't really tell, as I don't own one myself. If you want to, you can create a control-map file based on the existing Nocturn XML template. If you are not sure how / have additional question, please post them in the XRNX discussion forum

Re: Nocturn 25 support

i think it's more like Nocturn with added keys... is there any tutorial on how to make a template from scratch? the thing is that i have to make automap & duplex template simultaneously and i'm not sure how to.

I just want Launchpad transport map...

I want to make a Duplex template for launchpad transport only...

hmmm...

gonna look into this...

UC-33

Will you add Evolution UC-33 mapping?

Yes please! I'd love to see

Yes please! I'd love to see support for the UC-33.

Synced launch ?

First, i'd like to thank you for such a great tool ! :)

Question : maybe i'm missing something but... is there any way that when you press the right PLAY key of a whole line (on the novation launchpad)... it will play it synced, when i press it .. it plays it right away ... not like if i click the PLAY icon on the left side of the screen, any idea about this ?

Thanks :)

Re: Synced launch ?

You want to check out the options for the Matrix application. There are !many! ways to customize the way that patterns are launched. The default options are simply the ones I find most useful.

To do this, you just need to open the Matrix app in a text editor, study the various options (the are listed right in the beginning of the file), and find a combination you like. Then, open the Launchpad.lua file and add the *number* of the option you like to the Matrix options.

Following this principle, this will cause the Matrix to schedule patterns instead of switching:

options = {
switch_mode = 4
}

Thanks ! This schedule mode 4

Thanks !

This schedule mode 4 works perfectly ! :)

Thanks a lot danoise ! I'll

Thanks a lot danoise !

I'll try this :)

Channel support for controller mapping

Hi guys,
first of all i want to thank all the people making renoise the best DAW in the world.
Now to my question.
Is it possible to implement channel support in duplex controller mappings. I've got a M-16 DX Edirol mixer which generates the same CC Messages on different midi channels.

Please refer also this post about the problematic:
http://www.renoise.com/board/index.php?showtopic=26559&st=0&p=209165&hl=...

Thanks in advance
Max

Thanks for Channel support

CC12|CH6 ;)

BCR2000 - how to edit the duplex mappings ?

...

new device

hello, i want to create new device for duplex
i just copy one controller and change everything to new. restart renoise and it is wont listed?
can you help me please.

midi controller doesent "shut down"when exiting Duplex

first of thanks for this nice tool.

one thing though,i have noticed that if i have used my launchpad controller with Duplex,and i exit Duplex (and even if i close down renoise)then the launchpad controller is still on,i mean the lights in the pads shut down,but theres still light in one button??

EDIT:dont know what have happened,but now it works as intended

Hi,I really want to try this

Hi,I really want to try this out but when i drag and drop the XRNX file onto renoise it does nothing. Other XRNX files work fine. I'm running it on OSX 10.5.8

Thanks!

we are working on it

the problem has been issued a ticket on our xrnx tracker:
http://code.google.com/p/xrnx/issues/detail?id=31&colspec=ID%20Type%20St...

splendid tool!

Very cool!

.

thx,

I hope it's useful to you!

ohm64

is this what you were saying to hold out for?

ok, i see the results with the launchpad.

i almost anticipate something along
the lines of auto.mapping features.

i'm going in...
wish me luck
-
@bLcKtRsH

duplex : 10.6.4

i see,

a ticket has already been
filed about this...

:(

gonna click the link above
mentioned. let's see
if we can get this
going...

thx,

-
bLcKtRsH

[mb pro late 2008, 2.4ghz, 4gb ram, 10.6.4]