====== 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 that snaps back into place. Useful for fast-forwarding and re-winding.
  - Five mouse-like buttons.

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

To use in [[linux]] and [[Kdenlive]] you will need to add a [[udev]] rule.

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

  * [[github>threedaymonk/shuttlexpress]]
  * [[github>SERVCUBED/ShuttlePRO]]
  * [[github>irontoby/shuttleit]]
  * [[aur>shuttlepro-git]]
  * [[aur>shuttlepro-v2-git]]
  * [[https://www.lwks.com/index.php?option=com_kunena&func=view&catid=25&id=72223&Itemid=81|ShuttlePROv2 working with Linux !]]

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