[Documentation] [TitleIndex] [WordIndex

New in Groovy (also builds against fuerte)

alt Screen shot of ROS GUI


rqt is a software framework of ROS that implements the various GUI tools in the form of plugins. One can run all the existing GUI tools as dockable windows within rqt! The tools can still run in a traditional standalone method, but rqt makes it easier to manage all the various windows on the screen at one moment.

You can run any rqt tools/plugins easily by:

$ rqt

On Fuerte you have to use rosrun to run rqt:

$ rosrun rqt_gui rqt_gui

that shows a GUI where you can choose any available plugins on your system.

Users can create their own plugins for rqt with either Python or C++. Over 20 plugins (as of Feb 2013) have already been created and more are slated for development.

rqt supercedes the former GUI tools of ROS rxtools, which now is deprecated since ROS groovy.

rqt components structure

rqt consists of three (+1) metapackages:

Required environment

Advantage of rqt framework

Compared to building your own GUIs from scratch...

From system architecture's perspective,

See also



  1. Installing rqt on Ubuntu

    Shows how to install the rqt related packages.

  2. Install rqt on Mac OSX

User Documentation

  1. User Guide

  2. Available Plugins


For those who want to develop their own rqt plugins.

  1. Create your rqt plugin package

    Entry point for creating your rqt plugin either in python or C++.

  2. Writing a C++ Plugin

    Shows how to write a plugin for rqt in C++.

  3. Writing a Python Plugin

    Shows how to write a plugin for rqt in Python.

  4. Create rqt plugin using an existing Qt based tool

    No Description

  5. Using .ui file in rqt plugin

    In this tutorial python is used for now. C++ tutorial is pending.

  6. To show error or exception message to users

    Shows error/warning msgs or progress bar on GUI by using a component in rqt_py_common pkg

Create a new tutorial:

Assistance & Contribution


Enhancement, issue report

Design & development

Official decision process

Github policy for rqt plugins

There's a policy for the development repositories of rqt_common_plugins and rqt_robot_plugins (Related discussion):

2024-07-20 14:45