====== Contour ShuttleXpress ======
{{ :media:image:hardware:contour-shuttlexpress.jpg}}

The **ShuttleXpress** is a hardware input device useful for controlling video and audio editing software. They can be configured for all sorts of uses though. A popular one seems to be media playback, but they could be a game controller, and so on.

It has seven kinds of input:

  - An infinitely spinning dial with clicky movement. Good for stepping through a clip frame-by-frame.
  - Another dial with limited movement (70° each side, I think) that snaps back into place. Useful for fast-forwarding and re-winding.
  - Five mouse-like buttons.

There are larger versions that add more buttons.

===== Setup =====
==== Linux ====

NB: I've got it working in [[kdenlive]] without installing anything (see below), but for universal use [[gitlab>Robotista/shuttle-lander]] has been great: installs easy, has a GUI for configuration, can set different key assignments for different programs. If it doesn't detect your shuttle unplug and replug it again.

I've also found and tried (to try) a bunch of others:---

  * [[github>threedaymonk/shuttlexpress]]
  * [[github>SERVCUBED/ShuttlePRO]]
    * [[github>agraef/ShuttlePRO]] | [[aur>shuttlepro-git]]
      * [[github>SERVCUBED/ShuttlePRO]] | [[aur>shuttlepro-v2-git]]
        * NB: I had to grab the example config from Github, because the makefile in this fork doesn't install it.
  * [[github>irontoby/shuttleit]]

---Though I've had no luck with any of them. The older ones don't find the device, and the latest one by SERVCUBED doesn't find my config files, and has removed some important bits like debugging and specifying config location. Ugh. I guess merging the working bits together can be a [[projects|project]] for another time.

Some other links...

  * [[https://www.lwks.com/index.php?option=com_kunena&func=view&catid=25&id=72223&Itemid=81|ShuttlePROv2 working with Linux !]]
  * ? [[https://forum.linuxcnc.org/9-installing-linuxcnc/40116-how-to-configure-a-contour-shuttle-pro-v2-onlinuxcnc|How to configure a Contour Shuttle Pro V2 on LinuxCNC]]

=== Kdenlive ===

You need to make a [[udev]] rule and then you can configure things in Kdenlive's settings:

  - Plug-in the shuttle, use ''lsusb'' and note the ID info. ''ID 0b33:0020'' in my case, but in the example on the Kdenlive documentation the //product ID// is ''0030''.
  - Create a file in ''/etc/udev/rules.d'' (for example ''90-shuttlexpress.rules'' and add the line:\\ <code>SUBSYSTEMS=="usb", ATTRS{idVendor}=="0b33", ATTRS{idProduct}=="0020", MODE="0444"</code> where ''0b33'' is the first part of the ID you noted, and ''0020'' is the second.
  - Restart the udev stuff with ''# udevadm control %%--%%reload'' and ''# udevadm trigger''.
  - Open Kdenlive, go: Settings > Configure Kdenlive... > JogShuttle, and once you enable and select your device you should be able to configure the buttons as you wish.
  * NB: the FF/RW wheel seems bugged in this setup... it seems to work like a mouse scrollwheel, but reversed FIXME

=== Reaper ===

I've been using Shuttle Lander for [[Reaper]]. Also saw this, which might be useful for someone:

  * [[github>AtmanActive/shuttlemidi-for-reaper-via-realearn-on-windows]] - Use as a MIDI controller in Reaper. This means it will work even if Reaper's not in focus, which sounds annoying. Window's-only I think.

==== See Also ====

  * [[github>EMATech/OpenContourShuttle]] - In development, says it's Windows-only so far (haven't tested). Has a GUI for configuration.
  * [[github>dg1psi/shuttlemidi]] - Windows-only thing that turns it into a [[MIDI controller]].

===== See Also =====

  * [[https://videogameinterface.wiki/index.php/ShuttleXpress|ShuttleXpress]] on the [[Videogame Interface Wiki]].
  * [[https://manual.ardour.org/using-control-surfaces/Countour_Design/|Using the Contour Design Shuttle Devices]] in the [[Ardour]] manual.

{{tag>Contour hardware guide linux input setup}}