[Documentation] [TitleIndex] [WordIndex

Launch Tree (rqt_launchtree)


(click on the image for a larger version)


Some examples where rqt_launchtree can help you (especially in larger systems):


sudo apt-get install ros-indigo-rqt-launchtree

Afterwards, launch RQT (you might need to pass "--force-discover" the first time) and select the plugin from the "Plugins" menu. You find it in the "Configuration" folder as "Launch Tree".

Installation from Source

In case you want to make sure that you get the latest updates and fixes, the source repository is available on github and can be checked out by running (in the /src folder of your workspace):

git clone https://github.com/pschillinger/rqt_launchtree.git 
cd ..

If you are using ROS Kinetic, you will need to switch the branch first. This is required because PyQt4 has been replaced by PyQt5, which has a few different bindings.

git checkout kinetic


  1. Select a package and one of its contained launch files at the bottom of the widget.
    • Reload the currently open launch file by clicking the blue arrow button next to it.
    • Open and edit the chosen launch file by clicking "Open".
    • Pass custom args (like via terminal) by entering them into the "args" text field. This might be mandatory if a launch file does not specify default values for all args.
  2. Navigate the launch file hierarchy in the tree view panel.
    • A specific error message generated by roslaunch will be displayed if some launch files in the hierarchy are invalid.
    • Warnings will be printed if a launch configuration has inconsistencies, for example if the same param is initialized with different values across included files. Entries leading to the related source will be highlighted by a small warning icon.
  3. Filter displayed entries if desired using the panel at the top.
    • Only checked types of entries will be displayed. Only exception is if the entry contains children which should be displayed, then it will always be displayed as well.
    • If "Empty" is checked, launch files without any displayed children will still be displayed. Otherwise, they are only displayed if some of their children are displayed.
    • If a search phrase is entered in the text field, only entries containing this phrase will be displayed according to the rules above. The tree will automatically be expanded to display matching children.
  4. Select one of the entries in order to display its properties
    • Inspect values which would be set if executed, i.e., after all substitution has taken place.
    • Contained launch files can directly be opened in an editor this way.
    • The properties panel can be popped out and resized if required (hold ALT pressed in order to move it around).


Clicking the small gear icon at the top right corner opens a configuration dialog.

Report a Bug

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

2024-07-13 14:38