Documentation
Back to app
User Documentation

How Inkplainer Works

Everything you need to create hand-drawn whiteboard animations in a desktop browser — from adding your first image to exporting a finished video. Use the sidebar to jump to any section.

1
Add Layers
2
Choose Settings
3
Generate
4
Export
Section 1

1
Core Concepts

Inkplainer takes your images and text and turns them into videos that look like someone is drawing them by hand in real time — the kind of effect you see in explainer videos, educational content, and social media animations. You upload your content, choose how it should be drawn, hit Generate, and the app animates it frame by frame on a canvas. When you're happy with the result, you export it as a video file.

There are no subscriptions or required accounts. The editor runs directly in your browser and saves projects locally on your device.


The Mental Model

Before touching any setting, it helps to understand how the app thinks about your project:

  1. Layers are the raw material. Every image or piece of text you add becomes its own layer. Layers stack on top of each other on the canvas, just like in any image editor.
  2. Settings tell the app how to draw each layer. You select a layer, then configure its animation style, drawing look, speed, and hand. Every setting you change applies to that specific layer — not to the whole project. Each layer in your animation can look completely different from the others.
  3. Generate is the moment the app reads all your layers and their settings and plays the animation. You can watch it in real time, pause it, restart it, and tweak settings between runs.
  4. Export records the animation as a video file that you can use anywhere.

How the Canvas Works

The canvas is the white (or colored) area in the center of the screen. It is where your animation plays. What you see on the canvas during playback is exactly what will be recorded when you export — no hidden cropping, no re-rendering.

The canvas has a fixed resolution you choose (720p, 1080p, or 1440p) and a fixed aspect ratio (16:9, 9:16, or 1:1). When you upload an image, it is automatically scaled and centered to fit within that canvas. You can then reposition and resize it however you like.


How Layers Animate in Sequence

When you press Generate, layers animate one after another, in the order you define. As each layer finishes being drawn, it gets permanently "baked" into the background — it stays visible while the next layer animates on top of it.

  • Earlier layers are always visible behind later ones
  • Two layers with the same order number animate at the same time, in parallel

The Two Sidebar Tabs: Animation and Drawing

Animation tab is designed for speed. It gives you a set of styles that work well out of the box — similar to what you find in other whiteboard animation apps. Pick a style, adjust a couple of sliders, and get a good-looking result in under a minute.

Drawing tab is designed for control. It gives you detailed options for how outlines are detected, how strokes look, how fills are applied, and how the image is revealed.

The two tabs are mutually exclusive per layer — you pick one approach for each layer, not both. If you want the Animation tab's look on one layer and the Drawing tab's look on another, that is completely valid. But a single layer uses either the Animation tab or the Drawing tab, not both at the same time.

Section 2

2
Projects and the Interface

Creating a Project

When you first open the app, a new project is created automatically with a randomly generated name like "Bold Sketch" or "Vivid Canvas." To manage your projects, click the Projects button in the top bar.

  • Create a new project — click "New Project." The current project is saved automatically before switching.
  • Switch to an existing project — click its name in the list.
  • Delete a project — hover over it and click the delete button. This is permanent and cannot be undone.
Projects are stored in your browser using IndexedDB — they live on your device, not in the cloud. They will not transfer automatically to another device or browser.

Auto-Save

The app saves your project automatically every time you make a meaningful change. You do not need to press a save button. A small save indicator appears briefly in the top bar each time a save completes.

What gets saved per project:

  • All layers, including their images, positions, sizes, and every per-layer setting
  • Canvas dimensions and background
  • Global animation settings (hand style, speed, etc.)
  • Layer groups and animation order

The Top Bar

ElementWhat it does
Inkplainer logoClick to open the dropdown menu (About, Documentation, Privacy Policy)
Projects buttonOpens the Projects modal
Project nameClick to rename the current project
↩ Undo / ↪ RedoUndo or redo the last change
Support buttonLinks to our Ko-fi support page
Export VideoOpens the Export banner above the canvas

Keyboard Shortcuts

ShortcutAction
SpacePlay / Pause the animation
Delete or BackspaceRemove the selected layer (only when not typing)
Ctrl + Z / Cmd + ZUndo
Ctrl + Shift + Z / Cmd + Shift + ZRedo
Ctrl + Y / Cmd + YRedo (alternative)
EscapeCancel text placement or close text editor without saving
Ctrl + Enter / Cmd + EnterConfirm and close the text editor
You cannot undo while the animation is playing. Pause or restart the animation first.
Section 3

3
Layers

Adding Images

To add an image, use the drop zone in the top section of the right panel. You can drag and drop one or more image files directly, or click the drop zone to open a file browser.

Supported formats: PNG, JPG, GIF, SVG. You can upload multiple files at once — each file becomes its own layer. The app accepts images of any size and will scale them to fit the canvas automatically.

PNG files with transparency work best with the Drawing tab's outline detection — the transparent areas give the edge-detection algorithms a clean boundary to work with.

Adding Text

Switch to the Text tab in the right panel to add a text layer. Configure your text first, then click "Click canvas to place text" and click anywhere on the canvas to drop it.

  • Font — choose from the font picker list
  • Size — 10–400px
  • Style — Bold (B) and Italic (I) toggles
  • Alignment — Left, Center, or Right
  • Line height — 0.80–2.50
  • Letter spacing — −5 to 30
  • Color — 8 preset swatches or a custom color picker

To edit text after placing it, double-click it directly on the canvas. Press Ctrl + Enter to confirm, or Escape to cancel.


The Layer List

Every layer you add appears in the layer list at the bottom of the right panel, from top to bottom in visual stacking order. Each layer row shows:

  • ⠿ Drag handle — drag to reorder layers in the visual stack
  • Eye icon — toggle visibility. Hidden layers are excluded from the animation
  • Thumbnail — a preview of the image or text
  • Layer name — click once to select; click again to rename inline
  • Order field — controls when this layer animates
  • ✕ Delete — removes the layer (use Undo to recover)

Click any layer to select it and expand its individual controls: Resize (10–300%), Opacity (0–100%), Group assignment, and Position & Size (X, Y, W, H coordinates).


Animation Order

The Order field on each layer controls when it animates relative to the others.

  • Layers animate from the lowest order number to the highest
  • Layers with no order number animate after all numbered layers, in visual stack order
  • Layers with the same order number animate simultaneously — in parallel
LayerOrderWhen it animates
Logo1First
Title text1Same time as Logo
Background2After both Logo and Title finish
Chart(blank)Last, after Background

The Slicer

The Slicer cuts one layer into multiple new layers, each with its own independent animation. Select a layer and click the Slice button above the layer list to open it.

Grid mode
Divides the image into a uniform grid. Set Columns (1–8) and Rows (1–8). Each cell becomes its own layer. Fastest way to slice.
Rectangles mode
Draw custom rectangular regions on the preview canvas. Each rectangle becomes a separate layer. More control than Grid.
Freehand mode
Click to place polygon points around the area you want to isolate. Most precise option — ideal for irregular shapes and character silhouettes.
After slicing
All new layers inherit the original layer's settings. The original layer is removed. Set different animation orders on each new layer independently.

Canvas Background

The canvas background sits behind all layers and is included in the exported video. Choose from solid colors (White, Black, None, Custom) or ten preset textures:

PresetDescription
NotebookLight blue horizontal lines on a pale blue background
GraphA grid of faint blue lines on white
CreamA warm amber-to-gold radial gradient
ChalkboardA dark green radial gradient — mimics a real chalkboard
Soft GradientA subtle purple-to-blue-to-mint diagonal gradient
Warm WhiteAn off-white near-neutral background
BlueprintA dark blue background with lighter blue grid lines
KraftA brown crosshatch pattern on an amber background
DarkNear-black, suitable for high-contrast or neon-style animations
LinenA warm beige with a faint horizontal texture
Section 4

4
Animation Tab — Fast and Familiar

The Animation tab is the starting point for most projects. Pick a style, optionally adjust the Chunks slider, and press Generate. The styles here are designed to be intuitive and fast — similar to what you find in other whiteboard animation apps.

Settings Presets

The Presets card sits above both tabs. Presets save and restore your entire settings configuration in one click.

PresetStyleHandWhat it produces
Quick RevealScannerGhostFast clean reveal with no visible hand
Sketch ArtistContourHand 1Slow artistic contour with a charcoal stroke feel
BlueprintOutline OnlyGhostTechnical drafting lines on a dark background
IllustratedIllust FillHand 1Full illustrated look with color fills

To save a custom preset, click "+ Save current settings" at the bottom of the Presets card. Up to 6 custom presets can be saved.


Basic Animation Styles

Chunk Jump Default
The canvas is divided into tiles. Each tile pops into view one at a time. Rapid and energetic — content materializes in confident jumps.
Best for: general-purpose animation, icons, diagrams, product images. Works on virtually any image.
Scanner
Image revealed in horizontal bands sweeping left to right, top to bottom. Includes a Zigzag toggle to alternate scan direction like a typewriter.
Best for: wide landscape images, banners, backgrounds, methodical reveals.
Contour
Two phases: first traces the visible silhouette pixel by pixel, then fills the interior with tight zigzag hatching strokes.
Best for: portraits, character art, logos with clear silhouettes.
Outline Chunks
Detects edges, groups them into chunks, and draws each chunk one at a time. Builds up as a collection of strokes rather than tiles.
Best for: diagrams, technical drawings, illustrations with strong graphic lines.

The Chunks slider (6–80) appears for Chunk Jump and Outline Chunks. Low values (6–15) = large chunks that appear quickly. High values (50–80) = many small tiles building up gradually.


Specialized Animation Styles

The seven Specialized styles use the same reveal engine as Chunk Jump, but apply a subject-aware spatial priority map — each one draws in an order that feels natural for that type of subject.

StyleDrawing orderBest for
HumanHead → shoulders → torso → legsFull-body illustrations of people
AnimalLeft (head) → right (tail)Side-profile illustrations of animals
PortraitEyes/nose center → radiates outwardClose-up face portraits and headshots
VehicleFront (left) → rear (right)Side-profile illustrations of cars, trucks, aircraft
BuildingFoundation → roofArchitectural illustrations and building diagrams
LandscapeSky/horizon → midground → foregroundNature scenes and environmental illustrations
SpiralVisual center → outward in a spiralCircular compositions, centered logos
Use Basic styles for abstract graphics, charts, and icons. Use Specialized styles when the image has a clear real-world subject and you want the drawing order to feel intentional. A Chunks value of 30–40 is a good starting point.
Section 5

5
Drawing Tab — Advanced Control

The Drawing tab controls how the drawing looks — the character of the strokes, the quality of outline detection, whether the original image is revealed at the end, and more.

Outline Animation Modes

An important distinction from the Animation tab: the Drawing tab never reveals the original image during the drawing process. Instead, it actively draws strokes, outlines, and fills from scratch — interpreting your image's edges and colors as drawing instructions. The result is a drawn version of your image, not the original. The exception is the "Reveal original image at the end" option in Fill Options, which places the actual original image on top of everything once drawing is complete — useful when the drawn result works as a process but you want the final frame to be clean.

Outline Fill
Detects and draws outlines as strokes, then optionally reveals the original image on top. Final result shows drawn strokes layered over the real content.
Best for: product images, photographs, illustrations.
Illust Fill
Like Outline Fill but adds a coloring pass after drawing — fills regions to mimic an illustrator blocking in flat color. Looks like a colored illustration.
Best for: cartoon art, character illustrations, infographics.
Outline Only
Draws detected outlines as strokes on the canvas background. No image is shown at any point — not during drawing, and not at the end. The final result is a pure line drawing. This mode has no "Reveal original image" option.
Best for: technical diagrams, minimalist animations, blueprint-style content.
✏ Text
Designed for images of text — logos, title cards, handwritten words. Draws in a chosen direction, character by character or stroke by stroke.
Best for: brand names, headlines, any image where the primary content is letterforms.

The Drawing tab works best with clear illustrations, cartoon-style images, and vector-style artwork — images with well-defined, clean edges that detection algorithms can read reliably. For photographs, the Animation tab is the better choice, since it simply uncovers the original image without trying to interpret it.

Stroke Style

Default 🖊
Clean, uniform whiteboard marker line. Consistent thickness, no texture. The classic whiteboard animation look.
Charcoal ✏️
Soft, thick, dusty strokes with a gritty texture. Feels academic and organic — like a life-drawing study.
Sketch 〰
Four faint overlapping passes along the same path — mimics exploratory strokes before committing to a line. Looks tentative and hand-crafted.
Fountain 🪶
Variable line weight — thin on fast strokes, thick on slow curves. Calligraphic quality. Best on images with smooth flowing outlines.
Blueprint 📐
Crisp light-blue technical drafting lines. Designed to be paired with the Blueprint canvas background for a schematic look.

Coloring Style

Sparse — minimal uneven coverage, loose sketchy quality.
Filled (Default) — complete color coverage, solid and clean.
Watercolor — soft translucent color that bleeds slightly beyond outlines, painterly and organic.


Outline Detection

Detection Slider (0–100)

RangeSensitivityBest for
0–30StrictBold, clean outlines — graphic art, cartoons, simple diagrams
40–60BalancedDefault range — works on most images. Start here.
70–100FineThin, faint, low-contrast strokes — pencil sketches, watercolor art

Detection Algorithm

AlgorithmHow it worksBest for
Classic (Default)Balanced edge pickup for dark outlines on light backgroundsMost illustrations, logos, diagrams, photographs
AdaptiveAnalyzes small regions independently for local contrastUneven lighting, textured backgrounds, complex photographs
Morph ShellErodes shapes and uses the difference as the borderCartoons and anime with solid color regions
Canny+Links edge fragments into continuous linesVector illustrations, line drawings, crisp graphic design

Fill Options Card

Appears when Outline Fill or Illust Fill is selected. Controls what happens after the drawing phase.

Image Reveal Animations

OptionWhat it looks like
Instant ⚡The image appears all at once with no transition
Fade 🌫 (Default)The image smoothly fades in over the drawn strokes
Dissolve ✦The image appears pixel by pixel in a scattered pattern
Wipe →The image slides in from left to right
Iris ◎The image expands outward from the center of the canvas
Scanlines ≡The image builds in through horizontal scan lines

The Outline Overlay controls whether drawn strokes remain visible on top of the revealed image — toggle visibility and set opacity (0–100%). Outline color and thickness (0.5–8px) control the appearance of the drawn strokes, with an auto-detect option to pull colors from the image itself.


Outline Only Options

These two options exist for users who specifically want to use the Drawing tab with real photographs, but it is worth being direct: the Drawing tab is not designed for photos, and results will vary significantly. If you are working with photographs, the Animation tab will almost always produce a better result with less effort.

Color Region Outlines — finds boundaries between solid-color regions rather than fine ink lines. Slightly more reliable on photos than standard edge detection, but still limited.

Real Image Edges — gradient-based detection tuned for photographic content, finding object boundaries and structural contours. Pair it with a strict detection slider value (20–40) to reduce clutter.

Both options are a last resort for photos. If the result looks wrong, switching to the Animation tab is the right move. Color Region Outlines and Real Image Edges are mutually exclusive — enabling one automatically disables the other.

Text Draw Options

Start Direction — Left→Right (default), Right→Left, Top→Bottom, Bottom→Top. Controls which part of the text image animates first.

Fill StyleReveal (text appears progressively), Outline (traces just the letterform borders), or Outline + Fill (traces then fills the interior — the most "drawn" result).

Section 6

6
The Bottom Bar

Hand Style

The hand is the graphic that moves across the canvas during animation — the visual element that sells the "someone is drawing this" illusion. Five options are available: Ghost, Hand 1, Hand 2, Hand 3, and Pen. Ghost means no hand graphic is shown at all — the drawing happens invisibly, hence the name. The other four are different visual styles of a hand or writing instrument. Choose whichever looks right for your animation — there is no functional difference between them beyond appearance.


Speed Controls

Two sliders control different aspects of the animation timing independently.

Reveal Speed (1–100) — how many pixels of image content are revealed per animation tick. This is the primary speed control that determines how long the animation takes from start to finish.

Hand Speed (1–20) — how fast the hand graphic itself moves across the canvas, independently of reveal speed.

Reveal Speed is most effective in the Animation tab, where it directly controls how fast the original image is uncovered. In the Drawing tab, it controls the pace at which strokes are laid down — it still works, but the relationship is less direct since nothing is being revealed. Adjust both sliders to find the timing that feels right for your animation.


Canvas Size

Changing the canvas size after adding and positioning layers will rescale and re-center everything automatically. Set your canvas size at the start of a project before adding content.

Aspect Ratio — 16:9 (landscape, default), 9:16 (portrait/vertical), 1:1 (square)

Resolution16:99:161:1
720p (Default)1280 × 720720 × 1280720 × 720
1080p1920 × 10801080 × 19201080 × 1080
1440p2560 × 14401440 × 25601440 × 1440

720p is the right choice for most use cases — renders faster and produces smaller files. Use 1080p for large screens or high-resolution embeds. Use 1440p only when output quality genuinely demands it — render time increases significantly.

Section 7

7
Generating and Exporting

The Generate Button

The Generate button is pinned at the bottom of the left sidebar. Clicking it reads all your layers and their settings, builds the animation from scratch, and begins playing it on the canvas.

Every time you change a setting, you need to click Generate again to see the updated result. The canvas does not update in real time while you adjust settings — Generate is always the step that applies your changes.


The Playbar

The playbar sits directly below the canvas once an animation has been generated.

  • ⟳ Restart — stops and regenerates the animation from the beginning
  • ▶ / ⏸ Play / Pause — toggles playback. Also triggered by Space
  • Progress bar — click anywhere to seek to that point in the animation
  • % display — current position as a percentage. 0% = blank canvas, 100% = final frame
  • Done badge — green badge that appears at 100%, confirming the animation completed

Exporting Your Animation

Click the Export Video button in the top bar to open the export banner.

Format

WebM (Recommended) — modern open format with broad browser support. Best for YouTube, website embeds, and most editing workflows.

MP4 (H.264) — useful when you need wider compatibility outside the browser. Only available in Chrome and Edge — Firefox and Safari fall back to WebM automatically.

Quality

OptionBitrateBest for
High8 MbpsFinal delivery, large screens, archiving
Medium (Default)4 MbpsGeneral use — good quality, reasonable file size
Low2 MbpsQuick sharing, messaging apps, drafts
For YouTube, Instagram, and TikTok, Medium quality is sufficient — these platforms re-encode the video anyway.

The Recording Flow

  1. Click Start Recording in the export banner
  2. The animation automatically restarts from the beginning
  3. The canvas plays through the entire animation — do not interact with the app during recording
  4. When the Done badge appears, recording stops automatically
  5. Your browser downloads the video file immediately
Do not switch browser tabs or minimize the window while recording. Some browsers throttle background tabs, which can cause dropped frames or a corrupted export.

Export Checklist

Before clicking Start Recording, run through this list:

  • Canvas size and aspect ratio are set correctly for the destination platform
  • All layers are visible (check the eye icon on each layer)
  • Animation order is set the way you want
  • You have clicked Generate and watched the full animation at least once
  • The Done badge appeared, confirming the animation completed without errors
  • Format is set to your preference (WebM for most uses, MP4 for compatibility)
  • Quality is set appropriately for the destination
  • "Export final frame as PNG" is checked if you need a still image