Repository navigation
Releases: mlisi1/DendROS
Releases · mlisi1/DendROS
Release list
v1.1.0
[1.1.0] - 2026-10-12
The headline of this release is TUI mode: ros2 launch now opens in a full-screen viewer where you scroll, search and filter the log while the launch keeps running. It is the new default; set launch_mode: classic to keep the 1.0 output.
Added
TUI mode (launch_mode: tui, the default, for ros2 launch) — docs
- Full-screen log viewer with scrollback (
tui_scrollback_lines, default 5000), line wrapping, a scrollbar and resize support. - Mouse wheel scrolling, and click-and-drag selection that copies to the clipboard through OSC 52 and
xclip/xsel/wl-copy. - Crash and parameter-change alerts stay pinned in the header instead of scrolling away.
- Falls back to classic output automatically when the output is piped or redirected, or when the terminal can't run it.
Console commands (press \ in TUI mode) — docs
focus <node>...shows only the listed nodes. It matches the process name or the ROS logger name, so components inside a container can be focused one by one.level <lvl>shows lines at a severity or worse. Tracebacks and other lines without a level always stay visible.grep <text>is a live text filter with the matches highlighted.find <text>searches the scrollback; Tab and Shift+Tab step through the matches.mute <node>andunmute <node|all>hide and restore noisy nodes.mark [label]inserts a timestamped separator line.tee <file> [-c] [-a]saves the lines currently shown to a file, optionally with colors or appending.clearremoves every filter and mute;helplists every command and key.- Filters combine, and Esc removes the most recent one at a time.
- Tab completion for commands, node names and levels, and Up/Down command history.
Remote control and reopen — docs
dendros focus,find,grep,level,mute,unmute,mark,teeandclearsend the same commands to a running TUI from another terminal.dendros reopenreopens the last TUI run of the current terminal after it has ended, with its full scrollback.
Runtime control — docs
dendros disableanddendros enableswitch DendROS off and on in every terminal, including launches that are already running, without restarting them.
Output options
show_timestampandshow_logger_namehide the[timestamp]and[logger]brackets of node log lines for a terser output. Both can be set globally or per package.ignore_boldstrips bold from every color, for terminals that brighten bold text but not backgrounds and so show a badge in a different shade than its node's text.
Other
- A
package.xml, so the repository can be indexed as a ROS package. - Documentation: new pages for TUI mode, console commands, remote control, enable and disable, troubleshooting and a ROS 2 CLI overview. Every screenshot was redone, and each console command has a short recording.
Changed
ros2 launchopens in the TUI viewer by default (launch_mode: tui).ros2 run, piped or redirected output, and every other command are unchanged.dendros configgroups its settings into tabs (Output, CLI, Unmatched, System, Diagnostics, Param Alerts, Init) instead of one long list.dendros initmust be run from the package root, the folder that containspackage.xml. From a subfolder it tells you where to run it instead of guessing.dendros initwrites nothing when it finds no nodes. Previously it created an empty config and patched the build files anyway.dendros initcolors its warnings yellow and its errors red, like ROS 2 does.- The
[dendROS]tag uses the same brand blue and orange everywhere it is printed.
Fixed
dendros initonament_cmakepackages added an install rule that putdendROS.yamlinshare/<pkg>/instead ofshare/<pkg>/config/, so the config was never found. See the upgrade notes below.uninstall.shnow works as root (for example in Docker), removes only the two lines the installer added to.bashrcinstead of every line mentioningdendROS, and cleans up saved TUI runs and other runtime files. Your settings file is kept.- The docs gave
afteras the defaulttag_position; the default has always beenbefore.
Upgrading from 1.0
- Pull the repository and run
bash install.shagain, then open a new terminal orsource ~/.bashrc. ros2 launchnow opens in the viewer, also if you saved your settings with 1.0. To keep the old scrolling output, rundendros configand set Launch mode toclassicin the Output tab, or addlaunch_mode: classicto~/.config/dendROS/defaults.yaml.- If you ran
dendros initon anament_cmakepackage with 1.0, open itsCMakeLists.txtand changeinstall(DIRECTORY config/toinstall(DIRECTORY config(no trailing slash), then rebuild.ament_pythonpackages are not affected.
v1.0.0
DendROS v1.0.0
First stable release. DendROS shadows ros2 launch/ros2 run with a colorizing pipe and wraps the
main ros2 CLI inspection commands with the same group colors — zero launch-file changes, zero
new ROS 2 dependencies.
Highlights
- Color by group — map node groups to colors/badges via a small
dendROS.yamlin your package dendros init— automatically generates a config by scanning your launch files (--recursive,--labels)dendros config— TUI for global defaults- Full
ros2CLI wrapped —node list,node info,service list,action list,topic list(withtopic_sort=group),param list,param describe - Crash alert — inline banner on node death with exit code, repeats periodically
- Traceback highlighting — bold/dim red tracebacks (
fancy/red/off) - Keyword highlighting — per-group or package-wide word/pattern highlighting
- Parameter change alert — live
old → newnotifications onros2 param set, inline or
inverted style - Truly non-invasive — shell-level pipe, exit codes preserved, can be disabled anytime
- Works on host install, Docker, any ROS 2 distribution
Install
git clone https://github.com/mlisi1/DendROS
cd DendROS && bash install.sh && source ~/.bashrcFull docs: https://mlisi1.github.io/DendROS