====== 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 I think for wider use you have to use one of these:

  * [[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.

=== 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

=== See Also ===

  * [[https://www.lwks.com/index.php?option=com_kunena&func=view&catid=25&id=72223&Itemid=81|ShuttlePROv2 working with Linux !]]

==== See Also ====

  * [[github>EMATech/OpenContourShuttle]] - In development, maybe Windows-only so far (haven't tested). Has a GUI for configuration.

===== 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}}