Krazy Stitcher Pro User Manual
Browser-based bead pattern maker — no account, no install, no limits. • v3.4.1
1. Before You Start
Verify these requirements before you begin:
- Browser — Use a current version of Chrome, Firefox, Edge, or Safari. Krazy Stitcher requires JavaScript and IndexedDB support.
- Screen size — Use a desktop or laptop screen (1024px wide or larger). The canvas tools are not optimized for phones or small tablets.
- Storage — Krazy Stitcher saves patterns to your browser's IndexedDB. This storage persists across sessions but is tied to your browser and domain. Clear your browser data and the patterns are gone. Export important work as
.ksor.kspfiles. - Internet — Not required after the initial page load. The app runs entirely in your browser.
2. Get Started
Krazy Stitcher runs entirely in your browser. Open KrazyStitcher.html and start working.
Creating Your First Pattern
Click the New button in the top toolbar. A dialog opens. Give your pattern a name and choose a stitch type (Loom is the simplest). Set the width and height in beads, then click Create. An empty grid appears on the canvas.
Your First Beadwork
The Draw tool starts as the active tool. 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 IndexedDB. Storage persists across sessions. For backup or sharing, use Export Pattern to save a .ks file.
3. Navigate the Interface
The Krazy Stitcher interface has five main areas:
| Area | Location | Purpose |
|---|---|---|
| Top Toolbar | Top of screen | File operations, edit actions, transform tools, color tools, toggles, help |
| Tool Panel | Left side | Drawing tools and zoom controls (icon buttons) |
| Canvas | Center | The main editing area where you draw your pattern |
| Right Panel | Right side | Color palette, used colors, saved pattern list |
| Status Bar | Bottom | Pattern size, type, bead count, color count, storage info |
Canvas Navigation
Scroll your mouse wheel to zoom in and out. To prevent accidental zooming, click the lock icon (🔒) below the zoom buttons in the left toolbar — the icon changes to 🔓 when locked. Hold Space and drag to pan the canvas, or click the Pan tool (it auto-returns to your previous tool after one drag). The bottom-right corner shows the current zoom level. 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.
Floating Help Button
The round ? button fixed in the bottom-right corner of the screen opens the in-app help panel from anywhere. Click it whenever you need a quick reminder about tools, shortcuts, or features. The help panel slides out from the right and can be closed with the × button or by pressing Escape.
4. Use the Drawing Tools
| Tool | Key | How It Works |
|---|---|---|
| Draw | D | Click or drag to paint beads with the selected color. This is the default tool. |
| Erase | E | Click or drag to remove beads (sets beads to empty or white). |
| Fill | F | Click a bead to flood-fill all connected beads of the same color with the selected color. Uses 4-directional connectivity. |
| Color Pick | I | Click any bead to make its color the active drawing color. Works like an eyedropper. |
| Line | L | Click to set the start point, then click again to draw a straight line between the two points. Uses Bresenham's line algorithm. |
| Rectangle | R | Click two corners to draw a rectangular outline. |
| Filled Rect | Shift+R | Click two corners to draw a solid filled rectangle. |
| Oval | O | Click and drag to define a bounding box, then release to draw an oval outline. |
| Filled Oval | Shift+O | Click and drag to draw a solid filled oval/ellipse. |
| Triangle | G | Click and drag to define a bounding box, then release to draw a triangle outline (apex at top center). |
| Filled Triangle | Shift+G | Click and drag to draw a solid filled triangle. |
| Diamond | M | Click and drag to define a bounding box, then release to draw a diamond outline. |
| Filled Diamond | Shift+M | Click and drag to draw a solid filled diamond. |
| Select | S | Click and drag to select a rectangular region. See Select, Copy, and Paste. |
| Text | T | Opens a dialog to enter text, then click to place it. See Place Text on the Canvas. |
| Pan | Space | Click to pan the canvas once, then auto-returns to your previous tool. You can also hold Space with any other tool active for temporary panning. |
5. Choose a Stitch Type
Krazy Stitcher Pro supports twenty-one stitch types. The stitch type controls how the app arranges beads on the grid. It also affects the coordinate system and finished size calculations.
| Stitch | Grid Layout | Best For |
|---|---|---|
| Loom | Straight square grid, all rows and columns aligned | Loom beadwork, beginners, geometric patterns |
| Peyote | Odd rows offset right by half a bead width | Flat peyote stitch, the most popular off-loom stitch |
| Brick | Odd columns offset down by half a bead height (peyote rotated 90°) | Brick stitch earrings, small shapes |
| Peyote 2-Drop | Pairs of rows share the same offset | Faster beading with two beads picked up per stitch |
| Peyote 3-Drop | Groups of three rows share the same offset | Even faster multi-drop peyote |
| Peyote 4–9 Drop | Groups of 4 through 9 rows share the same offset | Advanced multi-drop peyote for wide, fast-coverage patterns |
| Gourd Stitch | Alternating row offset (like peyote), used tubularly | Tubular peyote for covering round objects like bottles, ornaments |
| Herringbone | Square grid with pair-bracket visual guides every two columns | Herringbone (Ndebele) stitch visualization |
| RAW | Square grid with cross-stitch visual guides showing the four-bead units | Right Angle Weave visualization |
| Square Stitch | Straight square grid, identical layout to Loom | Individually-stitched square patterns; same grid as Loom, different thread path |
| Spiral Rope | Each row rotates a quarter bead width, wrapping every four rows | Tubular spiral rope necklaces and bracelets |
| Dutch Spiral | Same quarter-bead rotation as Spiral Rope | Two-color spiral rope with a twisting accent stripe |
| Netting | Open, lacy diagonal lattice — rows offset by a third of a bead width | Net-like, zigzag jewelry and edging |
| Ladder Stitch | Beads stacked in pairs, one directly above the next | Foundation rows used to start herringbone and brick stitch projects |
| Albion Stitch | Ornamental grid guides marking 3×3 unit blocks | Decorative combination pieces mixing seed beads and crystals |
| Bead Crochet Rope | Progressive diagonal offset — each row shifts by a fraction of a bead width | Tubular bead crochet ropes and necklaces |
6. Work with Color Palettes
Krazy Stitcher ships with nine bead color palettes:
| Palette | Colors | Notes |
|---|---|---|
| Miyuki Delica | 950 colors | Comprehensive Miyuki Delica 11/0 cylinder bead palette. Each color has a DB product ID. |
| Toho Round | 320 colors | Toho 11/0 round seed beads with Toho product IDs. |
| Preciosa | 220 colors | Czech Preciosa seed bead colors. |
| Miyuki Rocailles | 64 colors | Miyuki 11/0 round seed beads (rocailles). Each color has an MR product ID. |
| Matsuno | 42 colors | Japanese Matsuno (Dyna-Mites) 11/0 seed beads with MT product IDs. |
| Mill Hill | 64 colors | Mill Hill glass seed beads with MH product IDs. Popular in cross-stitch and needlework. |
| Toho Aiko | 42 colors | Toho Aiko precision cylinder beads (1.75mm × 1.0mm) with TA product IDs. |
| Toho Treasure | 60 colors | Toho Treasure 11/0 precision cylinder beads (1.7mm × 1.3mm) with TT product IDs. Similar to Miyuki Delica; ideal for peyote stitch, brick stitch, and loom work. |
| Generic 64 | 64 colors | A 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.
7. Create Custom Palettes
You can create your own palettes and save them for future use. Custom palettes store in your browser alongside your patterns.
Save a Palette from Your Pattern
- Open a pattern that contains the colors you want to save.
- Click Save Palette below the brand dropdown.
- Enter a name for the palette (e.g., “Sunset Bracelet Colors”).
- The app saves all colors from your pattern as a new custom palette.
Create an Empty Palette
- Click + New below the brand dropdown.
- Enter a name for the palette.
- Select colors from any brand palette and click Add Current Color in the Manage dialog to build your palette.
Manage Custom Palettes
Click Manage to open the palette manager. From this dialog you can:
- Use — Switch to a custom palette.
- Rename — Change the palette name.
- Add Current Color — Add the color you have selected to the active custom palette.
- Delete — Remove a custom palette permanently.
Custom palettes appear in the brand dropdown with a ★ prefix.
8. Draw with Symmetry
Symmetric Drawing Mode mirrors your brush strokes across one or two axes. This is useful for patterns with bilateral or four-way symmetry, such as mandalas, medallions, and snowflakes.
How to Use Symmetry
- Click the ⊜ button in the toolbar or press M to cycle through symmetry modes.
- Draw on one side of the pattern. The app mirrors each stroke automatically.
- Press M again to cycle to the next mode or return to normal drawing.
Symmetry Modes
| Mode | What It Does |
|---|---|
| None | Normal drawing with no mirroring (default). |
| Horizontal | Mirrors left to right across a vertical center line. |
| Vertical | Mirrors top to bottom across a horizontal center line. |
| Both | Mirrors across both axes. Draw in one quadrant and all four quadrants fill. |
Red dashed guide lines show the active symmetry axes on the canvas. The Draw, Erase, Line, Rectangle, Oval, Triangle, and Diamond tools all support symmetric drawing.
9. Show Row and Column Numbers
Row and column numbers help you locate specific beads, count rows, and follow instructions. They appear along the top and left edges of the canvas.
Toggle Numbers
- Check or uncheck the Numbers checkbox in the toolbar.
- Or press N to toggle numbers on or off.
Adaptive Display
The numbers adjust to your zoom level:
- High zoom (18+ pixels per bead) — Every row and column is numbered.
- Medium zoom (10–17 pixels per bead) — Every 5th row and column is numbered.
- Low zoom (5–9 pixels per bead) — Every 10th row and column is numbered.
- Very low zoom (below 5 pixels per bead) — Numbers are hidden to avoid clutter.
10. Add Pattern Notes
Click Notes in the toolbar to open the notes panel for the active pattern. Use notes to record construction tips, bead brand preferences, row-specific reminders, or any information you want to keep with the pattern.
How to Use
- Open a pattern.
- Click Notes in the toolbar.
- Type your notes in the text area. Notes save automatically as you type.
- Click Close when finished.
Notes are stored with the pattern in IndexedDB and included when you export as a .ks or .ksp file. When someone imports your pattern, they see your notes.
11. Generate a Color Gradient
The Gradient Generator fills the entire canvas with a smooth transition between two palette colors. Each step in the gradient snaps to the nearest color in the active palette, so the result uses real bead colors.
How to Use
- Click Gradient in the toolbar.
- Select a color from the palette, then click Use Current next to "Start Color."
- Select a different color from the palette, then click Use Current next to "End Color."
- Choose a direction: Horizontal, Vertical, or Diagonal.
- Drag the Steps slider to control how many color bands the gradient uses. The preview bar updates in real time.
- Click Apply Gradient to fill the canvas.
| Direction | Description |
|---|---|
| Horizontal | Color transitions from left to right across columns. |
| Vertical | Color transitions from top to bottom across rows. |
| Diagonal | Color transitions from top-left corner to bottom-right corner. |
12. Import and Convert a Photo
Krazy Stitcher can convert any photograph or image into a bead pattern. There are several ways to load an image:
Loading an Image
| Method | How It Works |
|---|---|
| Drag and drop | Drag any image from Finder, Photos, your Desktop, iCloud Drive, a USB drive, or a shared network drive directly onto the canvas area. The Import Photo dialog opens automatically with your image pre-loaded. |
| Paste from clipboard | Copy an image from any app or take a screenshot (Cmd+Shift+4 on Mac), then press Cmd+V (Mac) or Ctrl+V (Windows). The image loads straight into the Import Photo dialog. |
| Click Import Photo | Opens the Import Photo dialog. Click the "Drop image here or click to browse" zone to open your system file picker. On Mac, this gives you full access to local drives, iCloud Drive, network shares, external drives, and any mounted volume. On Windows, it opens File Explorer with access to all connected drives. |
| Drop into the dialog | If the Import Photo dialog is already open, drag an image directly onto the drop zone at the top of the controls panel. |
Settings
| Setting | What It Does |
|---|---|
| Max Width | Maximum width of the resulting pattern in beads. The app calculates height from the image aspect ratio and the bead aspect ratio. |
| Max Colors | Drag the slider to set the target number of colors (2–256). The preview updates in real time as you drag, so you can see exactly how the palette reduction affects the image. With the expanded palettes (up to 950 bead colors), higher values give more faithful color reproduction. |
| Bead Type | The stitch type for the new pattern. Affects aspect ratio calculations. |
| Quantization | Median Cut is fast and produces good results. K-Means is slower but often finds more accurate color groupings, especially for images with subtle gradients. |
| Primary Dither | Controls how color transitions are smoothed. None maps each pixel directly to its nearest bead color. Floyd-Steinberg is a reliable all-rounder. Atkinson makes edges pop and boosts contrast — great for landscapes and architecture. Stucki is the smoothest, ideal for skies and gradients. Sierra falls between smooth and sharp. Burkes is similar to Stucki but faster on large patterns. |
| Secondary Dither | Optional. Pick a second algorithm to blend with the primary. The Blend slider controls the mix — 0% uses only the primary, 100% uses only the secondary. Try Atkinson + Stucki at 50% for crisp subjects with smooth backgrounds. |
| Blend | Appears when a secondary dither is selected. Controls the blend ratio between the two dithering algorithms (0–100%). |
| Brightness | Lighten or darken the image before conversion (-100 to +100). |
| Contrast | Increase or decrease tonal range (-100 to +100). |
| Saturation | Boost or reduce color intensity (-100 to +100). Set to -100 for grayscale. |
Grayscale Mode
Grayscale Mode is a checkbox in the Import Photo dialog that restricts the bead palette to neutral (gray/white/black) colors only.
- Auto-Detection — When you import a black-and-white or grayscale photo, Krazy Stitcher automatically detects it (an “AUTO-DETECTED” badge appears next to the checkbox) and enables Grayscale Mode for you. This eliminates unwanted color artifacts — like teal or blue tints — that can otherwise appear when converting a B/W image with a full-color palette.
- Manual Override — You can also check the Grayscale Mode box yourself on any image to force a neutral-only palette. This is useful for creating monochrome versions of color photos.
- How it works — Grayscale Mode desaturates every pixel to a pure luminance value and filters the bead palette down to beads whose RGB channel spread is 35 or less, ensuring clean gray-to-gray conversions with no stray color casts.
Preview
The dialog shows a side-by-side preview: your original image on the left and the converted bead pattern on the right. Click the Side/Stack toggle to switch between side-by-side and stacked (vertical) comparison. Stacked mode shows larger previews, making it easier to compare fine details. All sliders update the preview automatically as you drag them. You can also click Update Preview manually. When satisfied, click Import to create the pattern.
Sample Photo
Click Try Sample Photo below the Update Preview button to load a built-in test image. Use it to experiment with different dithering combinations and see how they affect the output before loading your own photo.
Presets
Save up to three favorite dithering configurations as presets. After dialing in settings you like, click Save and choose a slot (1, 2, or 3). Click a preset button to instantly restore those settings. Presets persist between sessions, so you can build a library of go-to settings for different types of images — one for portraits, one for landscapes, one for graphics.
13. Manage Colors
Recolor (Global Color Replace)
Click Recolor in the toolbar. Select a "From" color and a "To" color from the dropdowns. The dropdowns list only colors in the current pattern. Click Replace. The app instantly changes every bead of the "From" color to the "To" color.
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 remove 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 differs, the app replaces it with the majority color. This cleans up photo-converted patterns.
14. Transform a Pattern
| Tool | What It Does |
|---|---|
| Mirror | Flips the pattern horizontally (left-to-right). Useful for creating symmetric patterns. |
| Flip | Flips the pattern vertically (top-to-bottom). |
| Rotate | Rotates the pattern 90° clockwise. The app swaps width and height. Repeat three times for a full 360°. |
You can undo all transforms with Ctrl+Z. The undo system preserves both the grid data and the dimensions.
15. Select, Copy, and Paste
Switch to the Select tool (S), then click and drag on the canvas to draw a selection rectangle. A dashed red border highlights the selected region.
| Action | Shortcut | What It Does |
|---|---|---|
| Copy | Ctrl+C | Copies the selected region to the clipboard. |
| Paste | Ctrl+V | Pastes the clipboard contents at the top-left corner of the selection rectangle. If you have no active selection, pastes at (0, 0). |
| Delete | Delete | Clears (erases) all beads inside the selected region. |
16. Place Text on the Canvas
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:
| Size | Bead Height | Bead Width per Character | Use Case |
|---|---|---|---|
| 5 (tiny) | 5 beads | ~4 beads | Small labels, annotations |
| 7 (small) | 7 beads | 5 beads | Standard text (native font size) |
| 9 (medium) | 9 beads | ~6 beads | Larger text, headings |
Click Place Text, then click anywhere on the canvas to stamp the text. The app renders text in the current drawing color. The built-in 5×7 font supports A–Z, 0–9, and common symbols.
Once placed, text becomes regular beads — you can edit, erase, or recolor individual beads.
17. Use the Image Trace Overlay
The trace overlay lets you display a reference image behind your bead grid while you hand-edit a converted pattern. The trace does not auto-enable on photo import — click the Trace button in the toolbar to load a reference image when you want one.
Controls
Once a trace image is loaded, the Trace slider appears in the toolbar. 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.
18. Track Your Bead Inventory
Click Inventory in the toolbar to mark which bead colors you own. Owned colors display a green ✓ on their palette swatch and in the bead count table. Colors not in your inventory show a red ✗ in the bead count table so you know what to buy.
How to Add Beads
- Open the Inventory dialog (Inventory button).
- Click Add Current Color to add the active palette color, or Add All Pattern Colors to add every color used in the current pattern.
- Each entry shows the color swatch, name, brand ID, and a remove button.
Shopping List Integration
When you have inventory data, the CSV shopping list (Export CSV in the Counts dialog) adds an "In Inventory" column. Colors you own show "Yes" and colors you need show "NEED TO BUY".
19. Estimate Project Cost
The Cost Estimator helps you budget for a pattern before you buy beads. It lives inside the Counts dialog — click Counts in the toolbar, then expand the Cost Estimator section.
How to Use
- Set your Price per tube (default: $3.49).
- Set the Beads per tube (default: 1400 — typical for 11/0 Delica tubes).
- The estimator calculates how many tubes each color needs and the per-color cost.
- If you have inventory data, owned colors are crossed out and excluded from the total.
Cost data is also included in the CSV export when a price is set.
20. Calculate Sizes and Counts
Bead Count
Click Counts to see a sortable table of every color in your pattern. The table shows the bead count and percentage for each color. Click column headers to sort. The app highlights low-count colors (default threshold: 5 beads) in orange — merge these 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 Type | Width × Height |
|---|---|
| 11/0 Miyuki Delica | 1.6mm × 1.3mm |
| 11/0 Toho Round | 2.2mm × 2.2mm |
| 11/0 Miyuki Rocailles | 2.0mm × 2.0mm |
| 11/0 Matsuno | 2.0mm × 2.0mm |
| 11/0 Mill Hill | 2.5mm × 2.5mm |
| 11/0 Toho Aiko | 1.75mm × 1.0mm |
| 11/0 Toho Treasure | 1.7mm × 1.3mm |
| 8/0 Round | 3.0mm × 3.0mm |
| 15/0 Round | 1.5mm × 1.5mm |
| 10/0 Delica | 2.2mm × 1.6mm |
| Custom | Enter 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 the other way around). 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:
- Size — larger patterns are harder (up to 30 points)
- Color count — more colors means more thread or needle changes (up to 25 points)
- Color complexity — frequent color changes within rows (up to 25 points)
- Confetti beads — isolated single beads surrounded by different colors (up to 10 points)
- Stitch type — advanced stitches like RAW and herringbone add difficulty (up to 10 points)
Ratings: Beginner (0–20), Easy (21–40), Intermediate (41–60), Advanced (61–80), Expert (81–100).
21. Export and Share Patterns
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.
Word Chart
Click Word Chart to export a formatted HTML word chart. The chart includes:
- A color legend with color blocks showing each bead color, ID, and name
- Row-by-row chart with colored bead blocks and run-length instructions (e.g., "3 Black, 5 Red, 2 White")
- A bead count summary table sorted by quantity
Open the HTML file in any browser and print it. The chart is styled for clear readability at the bead table, with alternating row shading and compact color blocks. This is the document beaders work from while stitching.
Export Pattern and Import Pattern
Export Pattern saves the current pattern as a .ks JSON file. This includes all grid data, colors, dimensions, and pattern settings. Use this to back up your work or transfer patterns between computers.
Import Pattern loads a previously saved .ks, .json, or .ksp package file and adds it to your saved patterns. See the next section for details on .ksp packages.
22. Share, Archive, and Import Patterns
Krazy Stitcher v1.1 introduces .ksp (Krazy Stitcher Package) files — a zip-based format that bundles everything related to a pattern into a single file for sharing or archiving.
What’s Inside a .ksp File
A .ksp package contains six files:
| File | Purpose |
|---|---|
PatternName.ks | The full pattern data (grid, colors, dimensions, color map). This is the file Krazy Stitcher uses to reconstruct the pattern. |
PatternName.png | A PNG preview image of the pattern. Useful for quick viewing without opening the app. |
PatternName.pdf | A print-ready PDF with the full color grid, symbol legend, and bead count summary. |
PatternName - Word Chart.txt | A text-based row-by-row chart with symbol mapping and run-length instructions. |
PatternName - Bead Count.csv | A CSV spreadsheet with color names, IDs, hex values, bead counts, and percentages. |
metadata.json | Machine-readable info: pattern name, type, dimensions, bead count, color count, export date, and Krazy Stitcher version. |
Sharing a Pattern
- Open the pattern you want to share.
- Click the ✉ Share button in the toolbar.
- A dialog appears with two options:
- Share via… — Uses your device’s native share menu (email, messaging apps, AirDrop, etc.). This option appears only on devices that support the Web Share API (most phones and modern desktop browsers).
- Download .ksp File — Saves the package to your computer. You can then attach it to an email, upload it to a forum, or send it any way you like.
.ksp file is a standard zip archive with a different extension. If someone wants to peek inside without using Krazy Stitcher, they can rename it to .zip and extract the PNG, PDF, or CSV normally.Archiving a Pattern
Archiving saves a complete .ksp package to your computer and then removes the pattern from your browser’s local storage. This is useful for keeping your pattern list clean while preserving finished work.
- Click the 📦 Archive button in the toolbar (archives the current pattern), or click the small 📦 icon next to any pattern in the sidebar list.
- Confirm the archive. The
.kspfile downloads automatically. - Krazy Stitcher removes the pattern from your browser storage.
.ksp file. Store it somewhere safe — a dedicated folder, cloud backup, or external drive.Importing a Pattern
To load a pattern from someone else, or to restore an archived pattern:
- Click Import Pattern in the toolbar.
- Select a
.ksp,.ks, or.jsonfile. - Krazy Stitcher imports the pattern and adds it to your saved patterns list. It assigns a new unique ID, so it will not overwrite any existing patterns.
When you load a .ksp file, Krazy Stitcher extracts the .ks data inside the package. The package includes PNG, PDF, and other files for convenience, but only the .ks file contains the pattern data.
A Note on Format Compatibility
There is no universal standard file format for bead patterns. Every beading software uses its own proprietary format:
- BeadTool uses an internal database file.
- Beadographer stores patterns on its own servers (web-based only).
- JBead uses
.jbbfiles, but only for bead crochet rope patterns. - Bead-n-Stitch has its own format as well.
The closest thing to an open standard in the broader craft space is the OXS (Open Cross Stitch) format, but it’s designed for cross-stitch, not beadwork.
Because of this, .ksp files can only be opened by Krazy Stitcher. However, every package includes a PNG preview and a print-ready PDF, so recipients can always see the pattern even without the app. To work with the pattern in a different tool, the PNG image can be imported into most beading software via their photo-import feature.
.ksp file along with a link to Krazy Stitcher. They can open the app in any browser, click Import Pattern, and load the package immediately — no install, no account.23. Manage Saved Patterns
Krazy Stitcher stores all patterns in your browser's IndexedDB. This provides virtually unlimited local storage (typically several hundred megabytes). Patterns persist across browser sessions — you do not need to save to a file every time.
Pattern Management
- Save — Saves the current pattern to IndexedDB. The status bar shows total storage used.
- Duplicate — Creates a copy of the selected pattern. Great for experimenting without risking your original.
- Delete — Click the red × button on any pattern in the list to remove it.
- Clear All — Removes all saved patterns (use with caution).
24. Keyboard Shortcuts
| Key | Action |
|---|---|
| D | Draw tool |
| E | Erase tool |
| F | Fill tool |
| I | Color picker / eyedropper |
| L | Line tool |
| R | Rectangle (outline) |
| Shift+R | Filled rectangle |
| O | Oval (outline) |
| Shift+O | Filled oval |
| G | Triangle (outline) |
| Shift+G | Filled triangle |
| M | Diamond (outline) |
| Shift+M | Filled diamond |
| S | Select tool |
| T | Text tool |
| Ctrl+Z | Undo |
| Ctrl+Y | Redo |
| Ctrl+C | Copy selection |
| Ctrl+V | Paste at selection |
| Delete | Clear selection |
| + or = | Zoom in |
| - | Zoom out |
| Home | Zoom to fit |
| Space (hold) | Pan mode (with any tool) |
| Scroll wheel | Zoom in or out |
| N | Toggle row and column numbers |
| M | Cycle symmetry mode (none → horizontal → vertical → both) |
| F11 | Toggle fullscreen mode |
| Esc | Exit fullscreen / close help panel |
25. Track Progress Row by Row
The Row Work Tracker helps you keep your place while beading. Click Tracker in the toolbar to open the tracking panel.
How to use
- Click Tracker to activate. The panel appears in the bottom-left corner.
- Click Next Row each time you finish a row. The tracker highlights your current row in green on the canvas and dims completed rows.
- Click Prev Row to go back if you made a mistake.
- Click Jump to Row to skip to a specific row number.
- Click Reset to start over from row 1.
Your progress saves automatically with the pattern. When you reopen the pattern later, the tracker picks up where you left off.
26. Search and Filter Patterns
When you have many saved patterns, use the search and filter controls above the pattern list in the sidebar.
Search by name
Type any part of a pattern name in the search box. The list filters instantly as you type.
Filter by stitch type
Select a stitch type from the dropdown to show only patterns of that type. Choose "All types" to clear the filter.
Search and filter work together — you can type a name and select a stitch type at the same time.
27. Realistic Bead Preview
Check the 3D checkbox in the toolbar to switch from flat square rendering to a realistic bead view. Each bead draws as a rounded ellipse with a highlight, shadow, and thread hole.
When to use
Realistic mode gives you a better sense of how the finished piece will look. It works best at medium to high zoom levels. At low zoom (below 4px per bead), the app falls back to flat rendering for performance.
28. Backup and Restore All Data
Click Backup All to export every pattern, custom palette, and bead inventory item as a single .ksbackup file. This is your complete workspace snapshot.
Create a backup
- Click Backup All in the toolbar.
- The app downloads a file named
KrazyStitcher-Backup-YYYY-MM-DD.ksbackup. - Store this file somewhere safe. For an automatic off-device backup, save it into a cloud-synced folder — Google Drive, Dropbox, and OneDrive all work — and that service will copy it off your computer for you. A USB drive or external drive works too, just without the automatic part.
Restore from a backup
- Click Restore in the toolbar.
- Select your
.ksbackupfile. - Confirm the restore. Existing patterns are preserved — if the backup contains a pattern with the same ID, the backup copy overwrites it.
29. Generate a Print Layout
Click Print Layout to generate a print-optimized HTML document you can open in any browser and send to your printer.
What the print layout includes
- Cover page — pattern name, dimensions, stitch type, color legend with symbols, bead count summary table, and pattern notes.
- Symbol grid pages — the pattern grid with each bead shown as its assigned symbol on a colored background. Large patterns split across multiple pages (50 columns × 60 rows per page). Each page shows column and row numbers and a page footer for reassembly.
How to print
- Open the downloaded HTML file in your browser.
- Press Ctrl+P (or Cmd+P on Mac).
- Set paper size to Letter or A4. The layout adapts to both.
- Print in color for the best readability. The symbols also work in grayscale.
Print… (configurable PDF export)
Click Print… for a PDF you can size to your own printer or binder, no browser print dialog required. Choose a cell size, paper size (US Letter, US Legal, A4, A3, or Tabloid), and orientation (portrait or landscape), then click Export PDF to download a ready-to-print PDF built to those exact dimensions.
Fullscreen Mode
Click the ⛶ Fullscreen button in the top toolbar to hide all browser chrome — tabs, address bar, and bookmarks bar — and give your pattern the entire screen. This is especially useful on smaller screens or laptops. Press Esc or click the button again to exit fullscreen. You can also press F11 in most browsers.
Tip: If you find the browser's bookmarks bar takes up too much space but don't want full fullscreen, press Ctrl+Shift+B (or Cmd+Shift+B on Mac) to toggle just the bookmarks bar on or off.
Touch & Pen Support
Krazy Stitcher works with touchscreens and digitizer pens (stylus devices). All drawing tools — Draw, Erase, Fill, Color Pick, Line, Rectangle, Oval, Triangle, Diamond, and Select — respond to touch and pen input alongside traditional mouse input.
No setup is required. Simply touch the canvas or use your stylus to draw, erase, or interact with the tools. Pan and zoom gestures work as expected on touch-enabled devices.
Scroll-Zoom Lock
If you find the scroll wheel accidentally zooming your canvas, click the lock icon (🔒) in the left toolbar, below the zoom-in and zoom-out buttons. When locked, scroll-wheel zoom is disabled and the icon changes to 🔓. Click it again to re-enable zoom.
View Lock
View Lock (📌) locks both panning and zooming at once, preventing any accidental repositioning of your pattern on the canvas. Click the pushpin icon in the left toolbar to engage it — when View Lock is on, scroll-wheel zoom is also automatically locked, so you don't need to set the zoom lock separately. Click the pushpin icon again to unlock.
30. Improve Your Workflow
Photo-to-Pattern Workflow
- Import with K-Means quantization and Floyd-Steinberg dithering for best results. Try the Sample Photo first to experiment with dithering styles.
- Adjust brightness, contrast, and saturation before importing — use the Side/Stack toggle and preview until it looks right.
- Run Cleanup immediately after import to remove confetti beads.
- Open Counts to find low-count colors (highlighted in orange).
- Use Merge to fold near-duplicate colors together.
- Hand-edit details with the Draw and Erase tools, using the trace overlay as a guide.
- Export as PDF for printing or Word Chart for row-by-row instructions with color blocks.
Design Tips
- Use Duplicate before making major changes so you can always go back.
- For symmetric patterns, press M to turn on Symmetric Drawing and draw in real time. Or build one half manually, then use Mirror to create the other side.
- Toggle Symbols on to verify color placement on complex patterns — each color gets a unique symbol overlay.
- Use the Color Pick tool (I) to quickly grab colors from existing parts of your pattern.
- Check the Size Calculator early — a pattern that looks small on screen might be surprisingly large (or small) in real beads.
Performance
Krazy Stitcher handles patterns up to 1000×1000 beads, but very large patterns may render slower. For best performance on complex patterns, keep the grid under 500×500 beads. Turn off the grid overlay at high zoom levels if rendering feels sluggish.
31. Solve Common Problems
| Problem | Solution |
|---|---|
| Pattern not saving | Click 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 out | Increase contrast and saturation in the photo import dialog. Try K-Means quantization for better color accuracy. |
| Too many colors after import | Lower the Max Colors setting, or import with a higher number and use Merge afterward for more control. |
| Fewer colors than I requested | The Max Colors setting is an upper limit, not an exact target. Two things reduce the final count: (1) if your image doesn't have enough color variation, the quantizer may produce fewer groups; (2) when quantized colors are mapped to the nearest bead in your palette, multiple quantized colors can land on the same bead. Check the status line below the preview to see the actual count before importing. If you need more colors, try increasing Max Colors beyond what you want, or switch to K-Means quantization for better color separation. |
| White dots scattered across pattern after import | This is caused by the Floyd-Steinberg dithering algorithm distributing quantization error to neighboring pixels. Three fixes: (1) Click Cleanup to automatically remove isolated single-color beads. (2) Use Recolor to replace all white beads with a specific color. (3) Try importing again with dithering set to None for cleaner color blocks (at the cost of less smooth gradients). |
| Grid lines obscure the pattern | Uncheck the Show Grid checkbox in the toolbar to hide grid lines entirely. Zoom in to see individual bead colors more clearly — grid lines become less dominant at higher zoom levels. You can toggle the grid on and off as needed while working. |
| Hard to compare pattern to original photo | After importing a photo, Krazy Stitcher automatically loads the original image as a trace overlay. Use the opacity slider in the trace controls (appears below the toolbar after import) to blend the original over your pattern. Set opacity to 0% to hide it, or higher to see the original more clearly. You can also keep a copy of the original open in another window for side-by-side reference. |
| Can't load photos from iCloud or network drive | Use any of these methods: (1) Drag and drop the image from a Finder window directly onto the canvas — Finder can browse iCloud Drive, network shares, and external drives. (2) Click Import Photo, then click the drop zone to open the file picker, which shows all mounted drives in the sidebar. (3) Copy the image in Finder or Photos and press Cmd+V to paste it directly. |
| Canvas feels sluggish | Zoom out or turn off the grid display. Very large patterns (800+ beads wide) require more rendering time. |
| Undo doesn't restore correctly after rotate | The current version fixes this. If you see issues, refresh the page to load the latest code. |
| Can't find my saved patterns | Krazy Stitcher stores patterns per browser and per domain. If you opened the file from a different location or browser, previous patterns won't appear. Use Export Pattern to save important work. |
| Share button says “Share via…” is missing | The native share option requires a browser that supports the Web Share API (Chrome, Edge, Safari on mobile). Use Download .ksp File instead. |
| .ksp file won’t import | Make sure the file has a .ksp or .zip extension and contains a .ks file inside. If the file was renamed or corrupted during transfer, try downloading it again. |
| PDF export opens blank | Some 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." |
32. Supplies & Resources
Ready to start stitching? We have curated a complete list of recommended beading supplies, tools, and books — all available on Amazon. The resource page covers seed beads (Miyuki, Toho, Preciosa), thread and stringing materials, needles, looms, workspace tools, lighting, pattern books, technique guides, and finishing supplies.
33. Explore the Full Krazy Stitcher Lineup
Krazy Stitcher Base — one-time purchase
Design bead patterns from any photo or from scratch — offline, no subscription.
- 22 stitch types, dark mode, configurable PDF export with branding & saved presets (cell size, paper size, orientation)
- Built-in Thread & Bead Estimator, Row/Round Progress Counter, and Backup All / Restore
- Commercial-use rights included — sell finished crafts and individual patterns you create
- Keyboard shortcuts overlay (press ?)
- One-time purchase, works fully offline
Krazy Stitcher Pro — one-time purchase
Everything in Base, plus 3 more stitch types (25 total — Ladder, Albion, and Bead Crochet Rope), rotatable 3D preview, live symmetric drawing, brand remapping, a difficulty score, bead inventory tracking, a cost estimator, gradient fill, custom bead palettes, real SVG/CSV export, Color Reduction (Median Cut/Bayer dithering), 300 DPI hi-res export, Enhanced Backup (Version History), and the 66-design Starter Pattern Library.
Krazy Stitcher Studio — one-time purchase
The full studio: everything in Pro (including the same 66-design Starter Pattern Library), plus multi-layer editing, a Multi-Pattern Workspace (tab between and compare up to 4 patterns), a 6-type Color Harmony Engine, and Batch Export (bulk PDF/PNG export of multiple saved patterns to a single .zip). Studio also adds the exclusive right to bulk/wholesale distribution and publishing pattern collections or books — a step beyond the individual-pattern commercial rights every edition includes.
Photo-to-Pattern Converter — standalone add-on, works with any edition
Turn any photo into a ready-to-stitch bead pattern. 9-brand, 1,814-color database, Median Cut/K-Means/Bayer Matrix dithering choice, full brightness/contrast/saturation control, WCAG AA audited.
Color Palette Tool — free standalone tool
Build a bead-accurate color palette before you open a pattern. 6 harmony types, Delta-E/Lab matching across 5 brands/1,269 colors. One-click “Send to Krazy Stitcher.”
PatternFolio — coming soon
In development — details to come once it's finished and merged into the lineup.
Bead Conversion Chart Bundles
Cross-brand conversion charts — currently 47 charts covering Miyuki, Toho, DMC, Perler, Hama, Artkal, Nabbi, and more — for matching colors when you switch bead or craft brands.
No pricing here — visit krazystitcher.com to compare editions and see current pricing.