Giter Site home page Giter Site logo

m4l-zs-knobbler3's Introduction

m4l-zs-Knobbler3

An auto-labeling control surface for Ableton Live and TouchOSC.

This is a Max For Live device and a TouchOSC layout that provides a control surface that auto-labels parameter controls when a parameter is mapped, and minimizes the steps required to map controls.

Download

See the "Releases" section to the right to download .zip files.

Old versions are linked from the Changelog section below.

About

Demo Video

The problem with in-the-box musicmaking is that the best control surfaces like the Push 2 are modal, requiring you to navigate menus to find parameters, and non-modal surfaces like the BCR-2000 require you to either remember knob assignments or write them on the device itself. This poses a barrier to switching between projects, or simply remembering knob assignments from day-to-day.

With the zs-Knobbler3, you get 16 auto-labeling fader controls. When you map one of the auto-labeling faders using this device, the TouchOSC layout instantly displays the parameter name, device name, and track name and color of the mapped parameter.

The mappings are saved with your Live Set, so you can switch between sets and your mappings (and labels!) are preserved.

It also integrates my Bluhand device, which allows you to control the first 16 parameters of the currently selected device on the iPad. It also incorporates CurrentParamKnob and ToggleInput functionality into the device and layout, which are two utilities I found to be essential to a good workflow. Functionality of these features is described below.

Installation / Setup

If you just want to download and install the device, then go to the frozen/ directory and download the newest .zip file there. You can also download it directly via the links in Changelog below.

You will need to have the TouchOSC app installed on your iPad and configured to talk with your computer, along with the appropriate .tosc file on the iPad. Instructions for that are below.

If you want to use the non-frozen device (e.g. to do your own development) you will need to install the zero.* package. To do this, open the Package Manager in Max, then search for 'zero'. The package to install is called zero and it is published by Cycling '74.

Setup

TouchOSC (iPad) to Computer Connection

You will need to configure TouchOSC to send OSC to your computer. zs-Knobbler3 advertises itself on your network, so you should be able to open TouchOSC's Connections config (the chain icon), Tap OSC, then in Connection 1, tap Browse (1). You should see zs Knobbler3 in the dropdown list (2). Tap it, and then tap the IPv4 address (e.g. 192.168.x.x:2346) in the flyout menu (3).

TouchOSC OSC Setup

NOTE: Max/MSP and Max For Live are limited to only working with IPv4 addresses. If you pick an IPv6 address (e.g. [fe80:xxxx:xxxx:xxxx:xxxx%en0]:2346) it will not work.

Computer to TouchOSC (iPad) Connection

The zs-Knobbler3 uses OSC (not MIDI) to communicate parameter/device/track names and values to TouchOSC running on the iPad. It uses service auto-discovery (zeroconf) to know what OSC devices are on the network. The dropdown list should contain your iPad. If not, you can edit the Host and Port boxes manually. In my case, my iPad is named "iPad". You can get your iPad's name by going to Settings ... General ... About.

Auto-Discovery Dropdown

If the iPad does not show up in the Auto-Discovery dropdown, then you may need to enter its hostname or IP address manually. You can get the IP address of your iPad in Settings ... Wi-Fi ... then click your wi-fi network. The IP address is displayed next to "IP Address".

Usage

Mapping a Parameter

Ensure the "Knobbler" tab is selected on your iPad. Click a parameter in Ableton Live. It should be highlighted either with a rectangle (e.g. for small text boxes like Send Values) or its corners will be highlighted (e.g. knobs). Then touch the slider you want to map it to and slide up slightly, then remove your finger. You should see the parameter / device / track name show up, and the slider will jump to its current value.

Unmapping a Parameter

With the Knobbler tab selected, click the red "X" in the upper-left corner of the TouchOSC interface. All of the sliders will change to solid red boxes. Tap the box or boxes that you want to unmap. Click the red button in the upper left corner to exit unmapping mode.

If you would prefer to unmap in the computer, you can click the "x" next to the parameter in the zs-Knobbler3 device itself.

Bluhand Functionality

Bluhand lets you control the first 16 parameters of the currently selected device. Select the "Bluhand" tab in the tablet interface to see this work.

CurrentParam and ToggleInput Functionality

The TouchOSC layout includes two additional controls at the bottom of the screen. The wide teal slider always shows the value of the currently selected parameter in your live set. This gives you use a very high-resolution way to control parameter values that does not require you to use the mouse. The yellow/orange button is a way to toggle whether input is enabled on the current track. This lets you overdub automation easily without messing up any recorded MIDI or audio clips.

Common Problems

I get a "Spinning Beach Ball" when I try to use zs-Knobbler3.

This usually means that the Host value is incorrect. Max will do this if it is waiting for a DNS lookup to finish. Either fix the name, or use the IP address of the iPad.

My iPad doesn't show up in the Auto-Discovery dropdown.

Generally this indicates that either your computer, iPad, or your network is configured not to allow multicast UDP, also known as mDNS or Zeroconf. If you cannot work around that, then you can enter your iPad's IP address and listening port in the hostname box in the zs-Knobbler-3 device. You can get your iPad's IP address by going to Settings ... Wi-Fi ... then tap your wi-fi network name. The IP address is displayed next to "IP Address".

Changelog

Direct download links below. For 1.1.7 and newer, download both the amxd and tosc files! 1.1.9 introduced the tosc-16 layout option and the .zip download.

  • 1.3.1-noBLU - zip - 2024-04-10 - Temporarily remove Bluhand functionality because it seems to cause crashes in Live 12.
  • 1.3.1 - zip - 2023-12-27 - Support parameter banks in the Bluhand function. Updates the TouchOSC layout with Next / Prev Bank controls. (bugfixes)
  • 1.2.1 - zip - 2023-09-03 - Gracefully handle the case where the iPad cannot be found, i.e. prevent infinite OSC loops.
  • 1.2.0 - zip - 2023-04-23 - Fold the functionality of Bluhand into Knobbler. New tabbed TouchOSC layout that supports both.
  • 1.1.9 - zip - 2023-04-15 - Reliability fixes, small bugfixes.
  • 1.1.8 - amxd tosc - 2022-10-19 - Prevent feedback loop in OSC connectivitity.
  • 1.1.7 - amxd tosc - 2022-10-10 - Have the color of the fader on the iPad follow the color of the track. Fixes an issue with ToggleInputEnable. First versioned .tosc file in the frozen/ directory.
  • 1.1.3 - 2022-09-08 - Fix bug with auto-discovery that prevented the iPad hostname from being set properly.
  • 1.1.2 - 2022-04-28 - Integrate CurrentParamKnob and ToggleInput functionality into this device and the TouchOSC layout.
  • 1.1.0 - 2022-03-13 - Go all-in on OSC, no more MIDI. Much simpler, faster, and better.
  • 1.0.1 - 2022-03-09 - More confidence in fixing path saving problem.
  • 1.0.0 - 2022-03-09 - First solid, frozen release. Added zeroconf, fixed bug with inserting tracks or devices (updating parameter path when necessary).

TODOs

  • ...

m4l-zs-knobbler3's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Forkers

silvioinpixels

m4l-zs-knobbler3's Issues

Bluehand for Drift

The new synth in Ableton 11.3 - Drift - does not appear in knobbler3 1.2.0 in the bluehand tab. It simply says no device detected when Drift is selected. Other instruments/effects work normally.

Bluehand device bank parameters

Hello,

Firstly, thank you for this incredible work. I have a question and really hope that you can help me as i am scratching my head with this since several weeks....

Regarding your "Bluehand" touchOSC device, as i know, only the 16 first parameters of a device are mapped and I search a solution to be able to select the other banks of the device parameters so I could control all of the devices parameters that are available without the need to map them individually. As an exemple, my Launchpad pro mk3 can to this but as it doesn't has any screen it is really difficult to know in which order the device parameters are mapped.

Do you have any idea how I could implement this in your work? Is there any OSC message that exist in order to change the bank of parameter for the selected device?

Thanks in advance for your help_

zero.externals

the m4l device needs the zero.* externals (download via Package Manager in Max)

OpenStageControl ?

Thank you for making this available.

Would be nice to have an alternative to TouchOSC.
OpenStageControl runs as a server and in the browser. I will try to make it talk to Knobbler.

However, I'm a very slow and novice programmer - perhaps something you will consider to add?

http://openstagecontrol.ammd.net/

Bluhand Requires a Control Surface

A control surface (Ableton Push, Akai MPK, etc) must be connected in order for the Bluhand functionality to work.

Investigate alternatives to watching the currently selected device that does not have this requirement.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.