You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2026/05/20 10:28:01 UTC
(camel) 01/01: camel-tui: Add --record option and demo tape recordings
This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch worktree-camel-tui-demo
in repository https://gitbox.apache.org/repos/asf/camel.git
commit 5032bc8f0b546b336ac4d9b0c85f10346b2532fc
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Wed May 20 12:23:53 2026 +0200
camel-tui: Add --record option and demo tape recordings
Add TamboUI-based demo recording support to Camel TUI monitor:
- New --record CLI option that activates TamboUI's headless RecordingBackend
for artifact-free terminal recordings via .tape interaction scripts
- Hello world demo tape with screenshots and animated gif
- record.sh wrapper script for easy recording
- Register .tape file extension with license-maven-plugin (SCRIPT_STYLE)
Co-Authored-By: Claude Opus 4.6 <no...@anthropic.com>
---
.../docs/video/camel-tui-hello.cast | 59 +++++++++++++++++++++
.../docs/video/camel-tui-hello.gif | Bin 0 -> 685576 bytes
.../docs/video/camel-tui-hello.tape | 54 +++++++++++++++++++
.../camel-jbang-plugin-tui/docs/video/readme.md | 56 +++++++++++++++++++
.../camel-jbang-plugin-tui/docs/video/record.sh | 53 ++++++++++++++++++
.../video/screenshots/camel-tui-hello-diagram.png | 1 +
.../screenshots/camel-tui-hello-endpoints.png | 1 +
.../video/screenshots/camel-tui-hello-health.png | 1 +
.../docs/video/screenshots/camel-tui-hello-log.png | 1 +
.../video/screenshots/camel-tui-hello-overview.png | 1 +
.../video/screenshots/camel-tui-hello-routes.png | 1 +
.../dsl/jbang/core/commands/tui/CamelMonitor.java | 17 ++++++
pom.xml | 2 +
13 files changed, 247 insertions(+)
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.cast b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.cast
new file mode 100644
index 000000000000..4031c45820de
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.cast
@@ -0,0 +1,59 @@
+{"version": 2, "width": 200, "height": 50, "timestamp": 1779272014, "env": {"TERM": "xterm-256color"}}
+[0.000000, "o", "\u001b[2J\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[0.140000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[0.406000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[0.680000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[1.602000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[1.734000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[2.270000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[2.527000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[2.662000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[2.795000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[3.330000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[3.457000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[3.717000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[2;1H [...]
+[4.148000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[4.678000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[5.734000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[6.648000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[7.681000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[7.812000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[8.191000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[8.981000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[9.646000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[10.703000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[11.881000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[12.119000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[12.254000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[12.788000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[13.169000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[13.439000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[13.809000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[14.444000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[14.834000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[15.484000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[15.849000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[16.650000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[16.913000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[17.150000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[17.283000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[17.650000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[18.830000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[19.757000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[20.820000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[21.223000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[25.297000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[25.559000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[25.686000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[25.929000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[26.289000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[26.527000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[26.770000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[27.009000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[27.415000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[27.544000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[27.815000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[28.081000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[28.478000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[28.739000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
+[29.134000, "o", "\u001b[1;1H\u001b[0;38;2;246;145;35;1m Camel TUI\u001b[0m \u001b[0;32mv4.21.0-SNAPSHOT\u001b[0m \u001b[0;36m1 integration(s)\u001b[0m \u001b[0;33mselected: timer-log\u001b[0m \u001b[2;1H [...]
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.gif b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.gif
new file mode 100644
index 000000000000..8026062396cf
Binary files /dev/null and b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.gif differ
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.tape b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.tape
new file mode 100644
index 000000000000..a0de446c05fc
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/camel-tui-hello.tape
@@ -0,0 +1,54 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# Overview tab shows running integrations
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-overview.png
+
+# Routes tab - see the timer route
+Type "3"
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-routes.png
+
+# Route diagram
+Type "D"
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-diagram.png
+Type "D"
+Sleep 1s
+
+# Endpoints tab
+Type "5"
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-endpoints.png
+
+# Log tab - see Hello World messages flowing
+Type "2"
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-log.png
+
+# Health tab
+Type "7"
+Sleep 4s
+Screenshot screenshots/camel-tui-hello-health.png
+
+# Back to overview
+Type "1"
+Sleep 4s
+
+# Quit
+Type "q"
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/readme.md b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/readme.md
new file mode 100644
index 000000000000..e28f111a6871
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/readme.md
@@ -0,0 +1,56 @@
+# Camel TUI Demo Videos
+
+Terminal demo recordings using TamboUI's built-in recording system.
+This produces Asciinema `.cast` files with pixel-perfect rendering
+(no differential rendering artifacts).
+
+## Prerequisites
+
+- [Camel JBang](https://camel.apache.org/manual/camel-jbang.html) installed
+- [camel-jbang-examples](https://github.com/apache/camel-jbang-examples) cloned
+ (for the circuit-breaker, openapi, and routes demos)
+- Optional: [agg](https://github.com/asciinema/agg) to convert `.cast` to `.gif`
+ (`brew install agg`)
+- Optional: [asciinema](https://asciinema.org/) to play `.cast` files in the terminal
+ (`brew install asciinema`)
+
+## Recording
+
+Use the `record.sh` wrapper script:
+
+```bash
+# Basic hello world demo (uses built-in example)
+./record.sh camel-tui-hello --example=timer-log
+
+```
+
+The script starts a Camel integration in the background (`camel run --background`),
+then launches `camel tui monitor --record=<tape>` which uses TamboUI's headless
+recording backend. Interactions from the `.tape` file are played back automatically.
+After recording, the background integration is stopped with `camel stop`.
+
+## Playback
+
+```bash
+asciinema play camel-tui-hello.cast
+```
+
+## Convert to GIF
+
+```bash
+agg camel-tui-hello.cast camel-tui-hello.gif
+```
+
+## Tape files
+
+Tape files use the [VHS](https://github.com/charmbracelet/vhs) format to script
+terminal interactions (`Type`, `Sleep`, `Screenshot`, etc.).
+
+| File | Description |
+|------|-------------|
+| `camel-tui-hello.tape` | First impression — basic Hello World tour across all main tabs |
+
+## Output
+
+Screenshots are saved to `screenshots/` and `.cast` files are written
+to the current directory.
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/record.sh b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/record.sh
new file mode 100755
index 000000000000..bc47a58776b9
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/record.sh
@@ -0,0 +1,53 @@
+#!/bin/bash
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# Records Camel TUI demos using TamboUI's built-in recording system.
+#
+# Usage:
+# ./record.sh <tape-name> <camel-run-args...>
+#
+# Examples:
+# ./record.sh camel-tui-hello --example=timer-log
+
+set -e
+
+TAPE_NAME="${1:?Usage: $0 <tape-name> <camel-run-args...>}"
+shift
+CAMEL_RUN_ARGS="$@"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TAPE_FILE="${SCRIPT_DIR}/${TAPE_NAME}.tape"
+
+if [ ! -f "$TAPE_FILE" ]; then
+ echo "Error: Tape file not found: $TAPE_FILE"
+ exit 1
+fi
+
+echo "Starting Camel integration in background..."
+camel run --background --background-wait=false $CAMEL_RUN_ARGS
+
+echo "Recording ${TAPE_NAME} ..."
+camel tui monitor --record="${TAPE_FILE}"
+
+# Stop the background integration
+echo "Stopping Camel integration..."
+camel stop "*"
+
+echo "Done. Output: ${TAPE_NAME}.cast"
+echo "Play with: asciinema play ${TAPE_NAME}.cast"
+echo "Convert to gif: agg ${TAPE_NAME}.cast ${TAPE_NAME}.gif"
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-diagram.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-diagram.png
new file mode 100644
index 000000000000..cbf6e2c6d33f
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-diagram.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-endpoints.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-endpoints.png
new file mode 100644
index 000000000000..06d77b8b04de
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-endpoints.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-health.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-health.png
new file mode 100644
index 000000000000..c482d7f802d0
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-health.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-log.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-log.png
new file mode 100644
index 000000000000..8d26ea7c1c0d
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-log.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-overview.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-overview.png
new file mode 100644
index 000000000000..a4c4e63ba82b
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-overview.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-routes.png b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-routes.png
new file mode 100644
index 000000000000..c42cc6af06b3
--- /dev/null
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/docs/video/screenshots/camel-tui-hello-routes.png
@@ -0,0 +1 @@
+<svg class="rich-terminal" viewBox="0 0 2458 1270" xmlns="http://www.w3.org/2000/svg"> <!-- Generated with TamboUI --> <style> @font-face { font-family: "Fira Code"; src: local("FiraCode-Regular"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"), url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff"); font-style: normal; [...]
\ No newline at end of file
diff --git a/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/CamelMonitor.java b/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/CamelMonitor.java
index 9090fbc6be38..d632bceae948 100644
--- a/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/CamelMonitor.java
+++ b/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/CamelMonitor.java
@@ -154,6 +154,11 @@ public class CamelMonitor extends CamelCommand {
defaultValue = "100")
long refreshInterval = DEFAULT_REFRESH_MS;
+ @CommandLine.Option(names = { "--record" },
+ description = "Record a demo to an Asciinema .cast file using a TamboUI tape script",
+ arity = "0..1")
+ String record;
+
// State
private final AtomicReference<List<IntegrationInfo>> data = new AtomicReference<>(Collections.emptyList());
private final Map<String, VanishingInfo> vanishing = new ConcurrentHashMap<>();
@@ -359,6 +364,18 @@ public class CamelMonitor extends CamelCommand {
public Integer doCall() throws Exception {
System.setProperty("java.awt.headless", "true");
+ // Configure TamboUI recording if --record is specified
+ if (record != null) {
+ Path tapeFile = Path.of(record);
+ Path castFile = Path.of(record.replaceAll("\\.tape$", "") + ".cast");
+ System.setProperty("tamboui.record", castFile.toAbsolutePath().toString());
+ System.setProperty("tamboui.record.config", tapeFile.toAbsolutePath().toString());
+ System.setProperty("tamboui.record.width", "200");
+ System.setProperty("tamboui.record.height", "50");
+ System.setProperty("tamboui.record.duration", "120000");
+ System.setProperty("tamboui.record.fps", "10");
+ }
+
// to make ServiceLoader work with tamboui for downloaded JARs
Thread.currentThread().setContextClassLoader(classLoader);
TuiHelper.preloadClasses(classLoader);
diff --git a/pom.xml b/pom.xml
index bf02b125d302..d2fc977e2e55 100644
--- a/pom.xml
+++ b/pom.xml
@@ -391,6 +391,7 @@
<exclude>**/helm/etc/**</exclude>
<exclude>**/examples/*</exclude>
<exclude>**/*.wav</exclude>
+ <exclude>**/*.cast</exclude>
</excludes>
</licenseSet>
</licenseSets>
@@ -436,6 +437,7 @@
<spring.provides>CAMEL_PROPERTIES_STYLE</spring.provides>
<spring.schemas>CAMEL_PROPERTIES_STYLE</spring.schemas>
<sql>DOUBLEDASHES_STYLE</sql>
+ <tape>SCRIPT_STYLE</tape>
<thrift>JAVADOC_STYLE</thrift>
<toml>SCRIPT_STYLE</toml>
<unrealircd.conf>SLASHSTAR_STYLE</unrealircd.conf>