New in Groovy, Hydro and Indigo kinect_aux is now a standalone package. In Electric it was a package in kinect, which is deprecated.


This driver provides access to additional features present in the Kinect sensor: accelerometer, tilt, and LED. One may use it in parallel with the openni_camera driver.



If you are using Ubuntu, simply install the package using apt-get:

$ sudo apt-get install ros-groovy-kinect-aux

$ sudo apt-get install ros-hydro-kinect-aux

$ sudo apt-get install ros-indigo-kinect-aux

From source

Alternatively, install the package from source as described below.

catkin specific

Assuming a catkin workspace has been created as described in catkin/Tutorials/create_a_workspace, follow the steps below.

Firstly, install the system dependencies (if not yet installed):

$ sudo apt-get install libusb-1.0-0 libusb-1.0-0-dev

Next, download the source code to your catkin workspace and build it:

$ cd ~/catkin_ws/src
$ git clone -b groovy
$ cd ~/catkin_ws
$ catkin_make

$ cd ~/catkin_ws/src
$ git clone -b hydro
$ cd ~/catkin_ws
$ catkin_make

$ cd ~/catkin_ws/src
$ git clone -b indigo
$ cd ~/catkin_ws
$ catkin_make

Lastly, run the node (remember to run roscore if it is not yet running):

$ rosrun kinect_aux kinect_aux_node

Quick tests

To set the the tilt angle to, e.g., -15 degrees (Kinect facing downwards), simply publish a message on the topic (see API below):

$ rostopic pub /tilt_angle std_msgs/Float64 -- -15

To view current tilt angle, run:

$ rostopic echo /cur_tilt_angle



Subscribed Topics

/tilt_angle (std_msgs/Float64)
  • set the tilt angle, must be within [-31:31] degrees
/led_option (std_msgs/UInt16)
  • set the LED option, must be within [0:7]

Published Topics

/imu (sensor_msgs/Imu)
  • accelerometer data, you might want to change the topic to something like "imu_kinect" to not conflict with the main imu.
/cur_tilt_angle (std_msgs/Float64)
  • current tilt angle
/cur_tilt_status (std_msgs/UInt8)
  • current tilt status


device_index (int, default: 0)
  • index of device, if multiple Kinects are connected

Bug reports and feature requests

Use GitHub to report bugs or submit feature requests. [View active issues]

Wiki: kinect_aux (last edited 2015-03-20 15:12:59 by MuriloFM)