Interface Overview

A complete tour of the ASCII Motion editor and all its features.

Editor Layout

The ASCII Motion editor is organized into five main areas:

Editor Layout Diagram

1. Top Header Bar

The top bar contains:

  • Hamburger menu (☰) - Access to project management, settings, and help
  • Project name (click to edit inline)
  • Undo/Redo buttons
  • Export button
  • Theme toggle (light/dark mode)
  • User profile menu (when signed in)

2. Left Tool Panel

All drawing and selection tools organized by category:

  • Drawing tools - Brush, shapes, fill, gradient, text
  • Selection tools - Rectangle, lasso, magic wand
  • Utility tools - Eyedropper, flip horizontal/vertical
  • Tool Options - Context-sensitive settings for active tool

3. Center Canvas

Your main workspace:

  • Grid overlay (toggle in project settings)
  • Zoom controls (bottom-right)
  • Pan with Space + drag

4. Right Properties Panel

Active style and creative tools:

  • Appearance - Current character preview with FG/BG color
  • Character Palette - Preset and custom character sets
  • Color Palette - Text and background color swatches
  • Effects - Apply visual effects to selections
  • Generators - Create patterns and procedural content

5. Bottom Timeline

Animation controls:

  • Frame thumbnails with drag-to-reorder
  • Playback controls (play/pause, frame navigation)
  • Onion skin controls
  • Frame management (add, duplicate, delete)
  • FPS slider

Top Header Bar Details

Hamburger Menu (☰)

The hamburger menu provides access to all project operations:

Project Management:

  • New Project - Create a new canvas
  • Save Project (Cmd+S / Ctrl+S) - Save to cloud (requires sign in)
  • Save As... (Cmd+Shift+S / Ctrl+Shift+S) - Save with new name
  • Open Project (Cmd+O / Ctrl+O) - Open from cloud

Settings & Help:

  • Project Settings - Canvas size, background color, grid options
  • Show Welcome Screen - Replay the intro tour
  • Keyboard Shortcuts - View all shortcuts
  • About - Version info and credits

Project Name

Click the project name in the header to edit it inline. Changes are saved automatically when you click away or press Enter.

Action Buttons

ButtonShortcutDescription
UndoCmd+Z / Ctrl+ZUndo last action
RedoCmd+Shift+Z / Ctrl+Shift+ZRedo undone action
Export(click button)Open export dialog

Left Tool Panel

Drawing Tools

Info

Click a tool or use its keyboard shortcut to activate it. The selected tool is highlighted in purple.

ToolShortcutDescription
BrushBDraw freehand with customizable brush size and shape
Bezier PenPDraw bezier curves and vector shapes
EraserERemove characters (hold Ctrl while using Brush for quick access)
FillFFill connected areas with character/color
GradientGApply gradient fills
RectangleRDraw rectangles and squares
EllipseODraw circles and ellipses
TextTType text directly on canvas
ASCII TypeYCreate stylized ASCII text
ASCII BoxQDraw boxes and tables with line characters

Selection Tools

ToolShortcutDescription
SelectMSelect rectangular area
LassoLFreeform selection by drawing
Magic WandWSelect matching cells (by character, color, or background)

Utility Tools

ToolShortcutDescription
EyedropperIPick character and colors from canvas (hold Alt for quick access)
Flip H(click)Flip selection horizontally
Flip V(click)Flip selection vertically

Tool Options

Each tool has specific options that appear below the tool buttons:

Brush/Eraser Options:

  • Brush size (1-20, adjust with [ and ] keys)
  • Brush shape (circle, square, horizontal, vertical)
  • Affects toggles (character, text color, background color)

Shape Tool Options (Rectangle/Ellipse):

  • Filled vs. outline mode

Fill Tool Options:

  • Contiguous mode (fill only connected cells vs. all matching)
  • Match criteria (character, text color, background color)

Gradient Tool Options:

  • Contiguous mode
  • Match criteria for area selection

Magic Wand Options:

  • Contiguous mode
  • Match criteria (character, text color, background color)

Bezier Tool Options:

  • Character mode (Selection, Palette, or Autofill)
  • Color mode (Current Color or Palette)
  • Close shape toggle
  • Stroke width and taper controls (for open paths)

Center Canvas

Canvas Settings Bar

The settings bar above the canvas provides quick access to canvas configuration:

Canvas Size:

  • Mode Toggle - Switch between character count (char) and pixel dimensions (px)
  • Width × Height - Adjust canvas dimensions with +/- buttons or direct input
  • Character mode: 4-200 columns, 4-100 rows
  • Pixel mode: Automatically calculates character count based on typography settings

Display Controls:

  • Grid Toggle - Show/hide the alignment grid overlay
  • Background Color - Click the color swatch to open the color picker (supports transparent)
  • Typography - Opens typography settings panel

Typography Settings (via Type icon):

  • Text Size - Font size from 8px to 48px
  • Character Spacing - Horizontal spacing multiplier (0.5x to 2.0x)
  • Line Spacing - Vertical spacing multiplier (0.8x to 2.0x)
  • Font Family - Choose from bundled monospace fonts or system fonts
  • Reset to Default - Restore all typography settings

Zoom Controls:

  • Current zoom percentage display
  • Zoom in/out buttons

Zoom Controls

ActionShortcutDescription
Zoom in+ or =Increase zoom level
Zoom out-Decrease zoom level

Zoom range: 20% to 400%

Pan (Move Canvas)

  • Hold Space and drag to pan the canvas
  • Useful when zoomed in to navigate around your artwork

Canvas Overlays

Selection Outline

  • Marching ants animation shows selected area
  • Purple highlight for active selection

Onion Skin (animation mode)

  • Blue tint shows previous frames
  • Red tint shows next frames
  • Toggle with Shift+O
  • Adjust number of frames shown in timeline controls

Cursor Preview

  • Shows character and color that will be placed
  • Displays brush size for brush/eraser tools

Right Properties Panel

The right panel contains collapsible sections for appearance, palettes, effects, and generators.

Appearance Section

Shows your current drawing style at a glance:

  • Character Preview - Large preview showing active character with FG/BG colors applied. Click to open the full character picker.
  • Color Selector - FG/BG color swatches. Click to open the color picker overlay.
  • Color Readout - Displays current hex values for foreground and background.

Shortcuts:

  • X - Swap foreground and background colors

Character Palette Section

Manage character sets for quick access:

  • Palette Dropdown - Switch between preset palettes (Basic, Blocks, Lines, Symbols, etc.) or your custom palettes
  • Character Grid - Click to select, double-click to edit, drag to reorder
  • Controls - Move left/right, add current character, delete, import/export palettes

Shortcuts:

  • Cmd+[ / Ctrl+[ - Previous character in palette
  • Cmd+] / Ctrl+] - Next character in palette

Color Palette Section

Manage color swatches with Text and BG tabs:

  • Palette Dropdown - Switch between preset palettes (ANSI, Monokai, etc.) or custom palettes
  • Text Tab - Foreground color swatches (click to select, double-click to edit)
  • BG Tab - Background color swatches (includes transparent option)
  • Controls - Move colors, add current, delete, import/export

Shortcuts:

  • Shift+[ - Previous palette color
  • Shift+] - Next palette color

Effects Section

Apply visual transformations to your selection:

  • Dithering - Add texture patterns
  • Color Adjustments - Modify brightness, contrast, saturation
  • Character Remapping - Replace characters based on rules

Generators Section

Create procedural content:

  • Digital Rain - Matrix-style falling characters
  • Noise Patterns - Random character distributions
  • Gradients - Character-based gradient fills

Bottom Timeline

Playback Controls

The timeline appears at the bottom for animation projects:

Timeline Interface

ButtonShortcutFunction
⏮️ FirstShift+<Jump to first frame
◀️ Previous, (comma)Previous frame
▶️ Play/PauseSpacePlay/pause animation
▶️ Next. (period)Next frame
⏭️ LastShift+>Jump to last frame
🔄 Loop(click)Toggle looping playback

Frame Management

ActionShortcutDescription
Add frameCmd+N / Ctrl+NAdd new frame after current
Duplicate frameCmd+D / Ctrl+DDuplicate current frame(s)
Delete frameCmd+Delete / Ctrl+BackspaceDelete current frame(s)

Frame List:

  • Thumbnails of all frames
  • Current frame highlighted with purple border
  • Click to switch frames
  • Drag to reorder frames
  • Multi-select with Cmd/Ctrl+click or Shift+click

Onion Skinning

Onion Skinning

Toggle with Shift+O. Shows ghost images of previous (blue) and next (red) frames to help create smooth animations.

Controls:

  • Number inputs for frames before/after (0-10)
  • Center button toggles onion skin on/off

FPS Control

Slider to adjust animation speed from 1 to 60 FPS. The current FPS value is displayed on the slider.


Keyboard Shortcuts Quick Reference

Info

Access the complete keyboard shortcuts reference from the hamburger menu → Keyboard Shortcuts.

Tool Selection

ShortcutTool
B Brush
E Eraser
F Fill
G Gradient Fill
M Rectangle Select
L Lasso Select
W Magic Wand
I Eyedropper
R Rectangle
O Ellipse
T Text
Y ASCII Type
Q ASCII Box
P Bezier Pen

Canvas Actions

ShortcutAction
Cmd+A / Ctrl+ASelect All
Cmd+C / Ctrl+CCopy Selection
Cmd+V / Ctrl+VPaste Selection
Cmd+Z / Ctrl+ZUndo
Cmd+Shift+Z / Ctrl+Shift+ZRedo
Delete / BackspaceDelete selected cells
EscClear selection

Color & Brush

ShortcutAction
XSwap foreground/background colors
[Decrease brush size
]Increase brush size
Alt (hold)Temporary eyedropper
Ctrl (hold with Brush)Temporary eraser

View & Zoom

ShortcutAction
+ or =Zoom in
-Zoom out
Space (hold) + dragPan canvas

Animation

ShortcutAction
, (comma)Previous frame
. (period)Next frame
Shift+<First frame
Shift+>Last frame
SpacePlay/Pause animation
Cmd+N / Ctrl+NAdd new frame
Cmd+D / Ctrl+DDuplicate frame
Cmd+Delete / Ctrl+BackspaceDelete frame
Shift+OToggle onion skinning

File Operations

ShortcutAction
Cmd+S / Ctrl+SSave to cloud
Cmd+Shift+S / Ctrl+Shift+SSave As...
Cmd+O / Ctrl+OOpen from cloud

Customizing Your Workspace

Theme Selection

Click the sun/moon icon in the top-right to switch between:

  • Light Mode - Bright, high-contrast interface
  • Dark Mode - Easy on the eyes, default theme

Your preference is saved automatically.

Project Settings

Access via hamburger menu → Project Settings:

  • Canvas size - Width and height in cells
  • Background color - Default canvas background
  • Grid visibility - Show/hide the grid overlay

Tips for Efficient Workflow

Pro Tips
  1. Learn the essential shortcuts - B for brush, E for eraser, Space for play/pause, and [/] for brush size will speed you up significantly.

  2. Use modifier keys - Hold Alt for quick eyedropper, hold Ctrl with brush for quick eraser.

  3. Zoom for precision - Press + multiple times to zoom in for pixel-perfect editing.

  4. Save custom palettes - If you use the same colors or characters often, save them as a palette.

  5. Use onion skinning - Press Shift+O when animating to see previous/next frames as guides.

  6. Multi-select frames - Cmd/Ctrl+click to select multiple frames for batch operations like duplicate or delete.


Responsive Layout

The interface adapts to your screen size:

Desktop (1920×1080+)

  • All panels visible
  • Maximum canvas space
  • Timeline expanded

Laptop (1366×768)

  • Panels may be more compact
  • Full functionality maintained

Tablet/Mobile

Warning

ASCII Motion is optimized for desktop use with keyboard and mouse. Tablet support is limited, and mobile phones are not recommended for editing.


Accessibility Features

ASCII Motion includes accessibility features:

Keyboard Navigation

  • Full keyboard control for all tools and operations
  • Tab through controls
  • Escape to cancel/clear selections

Visual Options

  • Light and dark mode
  • High contrast tool highlighting

Next Steps

Interface Mastered!

You now know your way around the editor. Time to create!

Explore next:

Quick Start:

  1. Press B to select the brush
  2. Choose a character and color from the right panel
  3. Start drawing on the canvas!
  4. Press Cmd+N / Ctrl+N to add frames for animation

Need help? Access keyboard shortcuts from the hamburger menu, or contact support@ascii-motion.com