← Back to Krazy Stitcher

Krazy Stitcher User Manual

Free browser-based bead pattern maker — no account, no install, no limits.

Contents

  1. Getting Started
  2. Interface Overview
  3. Drawing Tools
  4. Stitch Types
  5. Color Palettes
  6. Photo Import & Conversion
  7. Color Management Tools
  8. Transform Tools
  9. Selection & Clipboard
  10. Text Tool
  11. Image Trace Overlay
  12. Calculators & Counts
  13. Export & Sharing
  14. Storage & File Management
  15. Keyboard Shortcuts
  16. Tips & Workflow Advice
  17. Troubleshooting

1. Getting Started

Krazy Stitcher runs entirely in your browser. There's nothing to download, install, or sign up for. Just open KrazyStitcher.html and start designing.

Creating Your First Pattern

Click the New button in the top toolbar. In the dialog that appears, give your pattern a name, choose a stitch type (Loom is the simplest), and set the width and height in beads. Click Create, and you'll see an empty grid on the canvas ready for drawing.

Your First Beadwork

The Draw tool is selected by default. Pick a color from the palette on the right side panel, then click or drag on the canvas to paint beads. Switch colors anytime by clicking a different swatch. That's the core workflow — everything else builds on it.

Saving

Click Save to store your pattern in the browser's local IndexedDB. This storage is unlimited and persists across sessions. For backup or sharing, use Save File to export a .bforge file.

2. Interface Overview

The Krazy Stitcher interface has five main areas:

AreaLocationPurpose
Top ToolbarTop of screenFile operations, edit actions, transform tools, color tools, toggles, help
Tool PanelLeft sideDrawing tools and zoom controls (icon buttons)
CanvasCenterThe main editing area where you draw your pattern
Right PanelRight sideColor palette, used colors, saved pattern list
Status BarBottomPattern size, type, bead count, color count, storage info

Canvas Navigation

Scroll your mouse wheel to zoom in and out. Hold Space and drag to pan the canvas, or select the Pan tool. The current zoom level is shown in the bottom-right corner. Click the Fit button (or press Home) to zoom the entire pattern into view.

The bottom-left corner shows the current bead coordinates as you move the mouse over the canvas.

3. Drawing Tools

ToolKeyHow It Works
DrawDClick or drag to paint beads with the selected color. This is the default tool.
EraseEClick or drag to remove beads (sets cells to empty/white).
FillFClick a bead to flood-fill all connected beads of the same color with the selected color. Uses 4-directional connectivity.
Color PickIClick any bead to make its color the active drawing color. Works like an eyedropper.
LineLClick to set the start point, then click again to draw a straight line between the two points. Uses Bresenham's line algorithm.
RectangleRClick two corners to draw a rectangular outline.
Filled RectShift+RClick two corners to draw a solid filled rectangle.
SelectSClick and drag to select a rectangular region. See Selection & Clipboard.
TextTOpens a dialog to enter text, then click to place it. See Text Tool.
PanSpaceDrag the canvas to scroll around. You can also hold Space with any other tool active.

4. Stitch Types

Krazy Stitcher supports twelve stitch types. The stitch type determines how beads are laid out on the grid and affects the visual rendering, coordinate system, and finished size calculations.

StitchGrid LayoutBest For
LoomStraight square grid, all rows and columns alignedLoom beadwork, beginners, geometric patterns
PeyoteOdd rows offset right by half a bead widthFlat peyote stitch, the most popular off-loom stitch
BrickOdd columns offset down by half a bead height (peyote rotated 90°)Brick stitch earrings, small shapes
Peyote 2-DropPairs of rows share the same offsetFaster beading with two beads picked up per stitch
Peyote 3-DropGroups of three rows share the same offsetEven faster multi-drop peyote
Peyote 4–9 DropGroups of 4 through 9 rows share the same offsetAdvanced multi-drop peyote for wide, fast-coverage designs
Gourd StitchAlternating row offset (like peyote), used tubularlyTubular peyote for covering round objects like bottles, ornaments
HerringboneSquare grid with pair-bracket visual guides every two columnsHerringbone (Ndebele) stitch visualization
RAWSquare grid with cross-stitch visual guides showing the four-bead unitsRight Angle Weave visualization
Note: Herringbone and RAW use a square grid data model with decorative visual guides. The guides help you visualize bead groupings but don't change how you draw or edit.

5. Color Palettes

Krazy Stitcher ships with four bead color palettes:

PaletteColorsNotes
Miyuki Delica64 colorsBased on popular Miyuki Delica 11/0 cylinder beads. Each color has a DB product ID.
Toho Round64 colorsToho 11/0 round seed beads with Toho product IDs.
Preciosa64 colorsCzech Preciosa seed bead colors.
Generic 6464 colorsA basic set of named colors, not tied to any brand.

Finding Colors

Use the search box above the palette to filter by color name or ID. Type "blue" to see all blue-family colors, or "DB0325" to find a specific Miyuki shade.

Used Colors

Below the palette grid, the Used in Pattern section shows every color currently present in your pattern. Click one to select it for drawing.

6. Photo Import & Conversion

Krazy Stitcher can convert any photograph or image into a bead pattern. Click Import Photo in the toolbar to open the conversion dialog.

Settings

SettingWhat It Does
Max WidthMaximum width of the resulting pattern in beads. Height is calculated proportionally from the image aspect ratio and the bead type's aspect ratio.
Max ColorsThe target number of colors after quantization (2–100).
Bead TypeThe stitch type for the new pattern. Affects aspect ratio calculations.
QuantizationMedian Cut is fast and produces good results. K-Means is slower but often finds more accurate color groupings, especially for images with subtle gradients.
DitheringNone maps each pixel to its nearest palette color. Floyd-Steinberg distributes quantization error to neighboring pixels, creating smoother gradients and more natural-looking transitions.
BrightnessLighten or darken the image before conversion (-100 to +100).
ContrastIncrease or decrease tonal range (-100 to +100).
SaturationBoost or reduce color intensity (-100 to +100). Set to -100 for grayscale.

Preview

The dialog shows a side-by-side preview: your original image on the left and the converted bead pattern on the right. Click Update Preview after changing settings to see the effect before committing. When satisfied, click Import to create the pattern.

Tip: Start with K-Means quantization and Floyd-Steinberg dithering for photographic images. For logos or flat-color artwork, try Median Cut with no dithering for cleaner results.

7. Color Management Tools

Recolor (Global Color Replace)

Click Recolor in the toolbar. Select a "From" color and a "To" color from the dropdowns (which list only colors currently used in the pattern), then click Replace. Every bead of the "From" color is instantly changed to the "To" color across the entire pattern.

Merge Colors

Click Merge to combine two colors. Select the color you want to eliminate ("Merge This Color") and the color to replace it with ("Into This Color"). This is especially useful after photo import when the quantizer produces near-duplicate shades.

Confetti Cleanup

Click Cleanup to automatically remove "confetti" pixels — isolated single beads surrounded by a different color. The algorithm checks each bead's four neighbors; if all four neighbors share the same color and the center bead is different, it gets replaced with the majority color. This dramatically cleans up photo-converted patterns.

Tip — Post-Import Workflow: After importing a photo, run Cleanup first to remove scattered pixels, then use Merge to combine any near-duplicate colors. This typically reduces a 20-color pattern to 12–15 distinct, clean colors.

8. Transform Tools

ToolWhat It Does
MirrorFlips the pattern horizontally (left-to-right). Useful for creating symmetric designs.
FlipFlips the pattern vertically (top-to-bottom).
RotateRotates the pattern 90° clockwise. Width and height are swapped. Repeat three times for a full 360°.

All transforms are undoable with Ctrl+Z. The undo system preserves both the grid data and the dimensions, so rotating and undoing works correctly.

9. Selection & Clipboard

Switch to the Select tool (S), then click and drag on the canvas to draw a selection rectangle. The selected region is highlighted with a dashed red border.

ActionShortcutWhat It Does
CopyCtrl+CCopies the selected region to the clipboard.
PasteCtrl+VPastes the clipboard contents at the current selection start point (top-left of selection rectangle). If no selection is active, pastes at (0, 0).
DeleteDeleteClears (erases) all beads inside the selected region.
Tip: To paste into a specific location, first select the target area, then press Ctrl+V. The paste begins at the top-left corner of your selection.

10. Text Tool

Click the T button in the tool panel (or press T) to open the text dialog. Enter the text you want to place and choose a font size:

SizeBead HeightBead Width per CharacterUse Case
5 (tiny)5 beads~4 beadsSmall labels, annotations
7 (small)7 beads5 beadsStandard text (native font size)
9 (medium)9 beads~6 beadsLarger text, headings

Click Place Text, then click anywhere on the canvas to stamp the text at that position. Text is rendered in the current drawing color using a built-in 5×7 pixel font that supports A–Z, 0–9, and common symbols (space, period, hyphen, exclamation, question mark, colon, hash).

Once placed, text becomes regular beads — you can edit, erase, or recolor individual cells.

11. Image Trace Overlay

When you import a photo, the original image is automatically stored as a trace overlay. This semi-transparent image sits behind your bead grid, letting you see the original while you hand-edit the converted pattern.

Controls

The Trace slider appears in the toolbar when a trace image is loaded. Slide it to adjust overlay opacity from 0% (invisible) to 100% (fully opaque). Click the × button next to the slider to remove the trace entirely.

Tip: Set trace opacity to about 30% for a subtle reference, or 60–70% to closely compare your bead placement against the original photo.

12. Calculators & Counts

Bead Count

Click Counts to see a sortable table of every color in your pattern with the number of beads and percentage. Click column headers to sort. Colors used fewer than a configurable threshold (default: 5 beads) are highlighted in orange — these are candidates for merging to simplify your palette.

Finished Size Calculator

Click Size to calculate the real-world dimensions of your finished piece. Select your bead type from the dropdown:

Bead TypeWidth × Height
11/0 Miyuki Delica1.6mm × 1.3mm
11/0 Toho Round2.2mm × 2.2mm
8/0 Round3.0mm × 3.0mm
15/0 Round1.5mm × 1.5mm
10/0 Delica2.2mm × 1.6mm
CustomEnter your own dimensions

The result shows width and height in both millimeters and inches.

Palette Brand Remap

Click Remap to convert all bead colors in your pattern to the nearest match in a different brand palette. This is useful when you designed with Miyuki Delicas but want to switch to Toho Rounds (or vice versa). Click Preview first to see the color mapping before committing.

Pattern Difficulty Score

Click Score to see a 0–100 difficulty rating for your pattern. The score considers:

Ratings: Beginner (0–20), Easy (21–40), Intermediate (41–60), Advanced (61–80), Expert (81–100).

13. Export & Sharing

Export PDF

Click Export PDF to generate a print-ready PDF of your pattern. The PDF includes the color grid and a color legend with bead IDs. Opens in a new tab for printing or saving.

Export PNG

Click Export PNG to save the pattern as a PNG image file. Each bead renders as a 10×10 pixel square. The resulting image is useful for sharing previews online, embedding in documents, or printing.

Text Chart

Click Text Chart to export a text file containing:

The Word file is formatted for standard letter-size paper and can be printed directly.

Save File / Load File

Save File exports the current pattern as a .bforge JSON file. This includes all grid data, colors, dimensions, and pattern settings. Use this to back up your work, share patterns with other Krazy Stitcher users, or transfer patterns between computers.

Load File imports a previously saved .bforge or .json file and adds it to your saved patterns.

14. Storage & File Management

Krazy Stitcher stores all patterns in your browser's IndexedDB, which provides virtually unlimited local storage (typically several hundred megabytes or more). Patterns persist across browser sessions — you don't need to save to a file every time.

Pattern Management

Important: IndexedDB storage is tied to your browser and domain. Clearing browser data or using a different browser means starting fresh. Use Save File regularly to keep backups of important patterns.

15. Keyboard Shortcuts

KeyAction
DDraw tool
EErase tool
FFill tool
IColor picker / eyedropper
LLine tool
RRectangle (outline)
Shift+RFilled rectangle
SSelect tool
TText tool
Ctrl+ZUndo
Ctrl+YRedo
Ctrl+CCopy selection
Ctrl+VPaste at selection
DeleteClear selection
+ or =Zoom in
-Zoom out
HomeZoom to fit
Space (hold)Pan mode (with any tool)
Scroll wheelZoom in/out

16. Tips & Workflow Advice

Photo-to-Pattern Workflow

  1. Import with K-Means quantization and Floyd-Steinberg dithering for best results.
  2. Adjust brightness/contrast/saturation before importing — preview until it looks right.
  3. Run Cleanup immediately after import to remove confetti pixels.
  4. Open Counts to find low-count colors (highlighted in orange).
  5. Use Merge to fold near-duplicate colors together.
  6. Hand-edit details with the Draw and Erase tools, using the trace overlay as a guide.
  7. Export as PDF for printing or Text Chart for row-by-row instructions.

Design Tips

Performance

Krazy Stitcher handles patterns up to 1000×1000 beads, but very large patterns may render slower. For best performance on complex designs, keep the grid under 500×500 beads. Turn off the grid overlay at high zoom levels if rendering feels sluggish.

17. Troubleshooting

ProblemSolution
Pattern not savingClick Save manually. Check the status bar's storage indicator. If your browser's IndexedDB is full (very rare), export patterns as files and clear old ones.
Photo import looks washed outIncrease contrast and saturation in the photo import dialog. Try K-Means quantization for better color accuracy.
Too many colors after importLower the Max Colors setting, or import with a higher number and use Merge afterward for more control.
Canvas feels sluggishZoom out or turn off the grid display. Very large patterns (800+ beads wide) require more rendering time.
Undo doesn't restore correctly after rotateThis was fixed in the current version. If you're seeing issues, refresh the page to load the latest code.
Can't find my saved patternsPatterns are stored per browser and per domain. If you opened the file from a different location or browser, previous patterns won't appear. Use Save File to export important work.
PDF export opens blankSome browsers block pop-ups. Allow pop-ups for the Krazy Stitcher page, or right-click the Export PDF button and choose "Open in new tab."

Krazy Stitcher — Free, open, browser-based bead pattern maker. No tracking, no ads, no account required.