Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions pages/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ All notable changes to Node Banana are documented here.

---

## Unreleased

### Fixed

- Video Stitch node now applies loop count (1x/2x/3x) when using the Stitch button ([#58](https://github.com/shrimbly/node-banana/pull/58))

---

## 1.3.0 β€” 2026-01-31

### Added
Expand Down
63 changes: 63 additions & 0 deletions pages/nodes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ This page documents all available node types in Node Banana. Each node serves a
| [LLM Generate](#llm-generate) | AI text generation | Text, Image | Text |
| [Annotation](#annotation) | Draw on images | Image | Image |
| [Split Grid](#split-grid) | Split into grid | Image | Reference |
| [Video Stitch](#video-stitch) | Combine videos | Video (multiple), Audio (optional) | Video |
| [Output](#output) | Display results | Image, Video | β€” |

---
Expand Down Expand Up @@ -359,6 +360,68 @@ Split Grid is primarily for visual organization. It:

---

## Video Stitch

The Video Stitch node combines multiple video clips into a single continuous video. It's useful for creating sequences, montages, or stitching together generated video clips.

### Inputs
- **Video** (multiple) β€” Video clips to stitch together in sequence
- **Audio** (optional) β€” Audio track to overlay on the stitched video

### Outputs
- **Video** β€” The combined video file

### Settings

| Setting | Description |
|---------|-------------|
| **Loop** | Repeat the entire clip sequence 1x, 2x, or 3x |

### Features

- **Filmstrip preview** β€” Visual grid showing thumbnail previews of all connected video clips
- **Drag to reorder** β€” Rearrange clips by dragging thumbnails in the filmstrip
- **Loop control** β€” Use the Loop selector (1x/2x/3x) to repeat the final sequence multiple times
- **Audio overlay** β€” Connect an optional audio track to add sound to the stitched video
- **Progress indicator** β€” Shows stitching progress percentage during processing
- **Output preview** β€” Play the stitched video directly in the node

### Usage

1. Add a Video Stitch node to the canvas
2. Connect 2 or more video sources (e.g., from Generate Video nodes)
3. (Optional) Drag thumbnails in the filmstrip to reorder clips
4. (Optional) Set the Loop control to 2x or 3x to repeat the sequence
5. (Optional) Connect an audio source to add a soundtrack
6. Click **Stitch** to combine the videos
7. The output video appears in the preview and flows to connected nodes

### Loop Feature

The Loop selector allows you to duplicate the entire clip sequence:
- **1x** (default) β€” Single playthrough of all clips
- **2x** β€” Entire sequence plays twice back-to-back
- **3x** β€” Entire sequence plays three times

For example, if you have 3 video clips of 2 seconds each:
- 1x loop = 6 seconds total
- 2x loop = 12 seconds total (clips play: 1, 2, 3, 1, 2, 3)
- 3x loop = 18 seconds total (clips play: 1, 2, 3, 1, 2, 3, 1, 2, 3)

<Callout type="tip">
Use the loop feature to create seamless repeating animations or extend short video sequences without manually duplicating clips.
</Callout>

### Execution Paths

The Video Stitch node has two execution methods:
1. **Manual stitching** β€” Click the "Stitch" button on the node
2. **Workflow execution** β€” Run the full workflow with `Cmd+Enter`

Both methods apply the loop count setting correctly.

---

## Output

The Output node displays the final result of your workflow. Use it as the endpoint for generated images and videos.
Expand Down