Get the character and colors at a specific canvas position

Set the character and/or colors at a specific canvas position

Clear a cell, resetting it to empty (space with transparent background)

Set multiple cells in a single operation. More efficient than calling set_cell repeatedly.

Paste a multi-line ASCII art block onto the canvas at a specified position. Great for pasting found ASCII art.

Fill a region with a character and colors. Can be contiguous (flood fill) or global (all matching cells).

Resize the canvas. Content outside the new bounds will be clipped.

Clear all cells on the current frame, leaving it empty

List all frames in the animation with their metadata

Add a new frame to the animation

Delete a frame from the animation. Cannot delete the last remaining frame.

Duplicate a frame, inserting the copy immediately after the original

Navigate to a specific frame, making it the current/active frame

Set the duration of a frame in milliseconds

Set or change the name of a frame

Create a new empty project, discarding any unsaved changes

Save the current project to a .asciimtn file

Load a project from a .asciimtn file

Get information about the current project

Set the project name

List all .asciimtn project files in the project directory

Get a compact summary of the canvas (dimensions, fill count, bounding box). Use this first to understand the canvas before requesting more detail.

Get non-empty cells in a region. Use for inspecting specific areas.

Get the canvas as raw ASCII text (characters only, no color info). Good for verifying visual appearance.

Get the cells that differ between two frames. Useful for understanding animation changes.

Get a high-level description of the animation: frame count, timing, and motion patterns.

Undo the last action

Redo the last undone action

Check if undo/redo is available and what actions can be undone/redone

Duplicate a frame and apply modifications in a single operation. Efficient for creating animation sequences.

Shift all content on the current frame by an x/y offset. Useful for creating scrolling or movement animations.

Flip/mirror content horizontally or vertically

Copy a region of cells from one frame to another

Generate intermediate frames between two keyframes. Creates smooth transitions.

Select a rectangular region of the canvas

Select cells that match specific criteria (magic wand style)

Get the current selection bounds and contents

Clear the current selection (deselect)

Apply an operation to all cells in the current selection

Delete all cell content within the current selection

Export the current frame or all frames as plain text (.txt). Returns ASCII art as text.

Export the project as structured JSON data. Good for programmatic processing.

Export the project as an .asciimtn session file (can be loaded by Ascii-Motion app).

Export the animation as a self-contained HTML file with embedded animation player.

Export the animation as a React component (JSX or TSX).

Export the current frame with ANSI escape codes for terminal display.

Apply a visual effect to the current frame or selection. Effects modify colors and/or characters.

Get statistics about colors used in the current frame. Useful before applying color effects.

Replace one color with another across the entire frame or selection.

Replace one character with another across the entire frame or selection.

List all procedural effect blocks across layers, groups, and global effects. Shows effect type, timing, enabled status, and keyframe count.

Add a non-destructive procedural effect to a layer, group, or global effects. Available types: levels, hue-saturation, remap-colors, remap-characters, scatter, wave-warp, wiggle.

Update a procedural effect block's settings, timing, or enabled state.

Remove a procedural effect block from its owner (layer, group, or global).

Add a keyframe to a procedural effect property. Creates the property track if it doesn't exist.

Remove a keyframe from a procedural effect property track.

Generate procedural animation frames. Creates new frames with animated patterns.

Preview a single frame from a generator without applying to the project.

Export the current frame as an Ink (React CLI) component for Node.js terminal apps.

Export the current frame as a Bubbletea (Go TUI) component.

Export the current frame as an OpenTUI (Python TUI) component.

Import an image file and convert it to ASCII art on the canvas. Requires optional "sharp" or "jimp" package for image processing.

Import a video file and convert each frame to ASCII art animation. Requires ffmpeg and optional image processing package.

Import ASCII art from a plain text file onto the canvas.

List all available character palettes for ASCII art.

Get all characters from a specific palette.

List all available color palettes.

Get all colors from a specific palette.

Get the currently active foreground and background colors.

Set the active foreground (text) color.

Set the active background color.

Set the active character used for drawing.

Get palette recommendations for a specific style.

Request the browser to send its current state. Use this before reading canvas data to ensure you have the latest state. Returns success if browser is connected and responded.

Compare two frames and show what cells changed between them. Useful for understanding motion and edits in an animation.

Get all layers in the project with their metadata, content frame count, and property track info.

Add a new layer to the project. If project is in legacy frame mode, this switches it to layer mode.

Remove a layer by ID. Cannot remove the last remaining layer.

Duplicate a layer with all its content frames and property tracks.

Set which layer is active for drawing and editing operations.

Rename a layer.

Move a layer from one z-order position to another. Index 0 = bottom layer.

Set visibility, solo, lock, or opacity on a layer.

Add a new content frame (canvas data segment) to a layer at a specific timeline position.

Remove a content frame from a layer.

Add a keyframe to a layer property track. Creates the property track if it doesn't exist.

Remove a keyframe from a property track.

Get all transform property values for a layer at the current frame, including keyframe status.

Create a layer group to organize layers together.

Dissolve a layer group, keeping the layers.

Set the timeline frame rate (FPS). Preserves frame count — only changes playback speed.

Set the total timeline duration in frames.

Check browser connection status. Returns whether browser is connected and client count

Get the authentication token for browser connection.

Export the current frame as an image (PNG, JPG, or SVG). The browser renders the image at full quality. Requires live mode with a connected browser.

Export the animation as a video file (MP4 or WebM). The browser renders each frame and encodes the video. Requires live mode with a connected browser.