Turn your photos into cross-stitch patterns – free and offline, on your Mac or in any browser.
Created by Zsolt Hoffmann · Instagram
▶ Try CraftDora in your browser – works on Windows, Mac, Linux and iPad, nothing to install · Download the Mac app
I'm a photographer. I spend my days thinking about light, colour and the moments worth keeping – and I've always admired how cross-stitchers turn those same moments into something you can hold, one tiny X at a time.
Most pattern makers are online services, subscriptions or apps that want an account and an internet connection. I wanted the cross-stitch community to have an option that is completely free, works offline and keeps your photos on your own computer.
We live in the age of AI, where images can be generated in seconds. CraftDora goes the other way: it uses the computer only to prepare the chart, so that people can create something slow, personal and handmade. If it helps even one new piece of embroidery come into the world, it has done its job.
From photo to pattern
- Open any image (JPEG, PNG, HEIC, …) or simply drag it onto the window
- Set the width in stitches (10–300) and the number of colours (2–40)
- Shape: original aspect ratio, square (1:1) or circle – drag and zoom to choose the crop
- Image adjustments: vibrance, contrast, highlights and shadows, applied before colour reduction, so thread choices follow your edits
- Stray stitch reduction – removes lonely single stitches that are tedious to sew
Real thread colours
- Matches every colour to the closest of 454 DMC threads, using the CIEDE2000 colour-difference formula, which is designed to follow human perception
- Thread list with DMC code, name and stitch count – one click copies it as a shopping list
Clear, printable charts
- Every colour gets its own distinct symbol (●, ■, ▲, ◆, ★ …), so the chart works in colour and in black-and-white
- Bold lines every 10 stitches, row and column numbers, centre markers
- Export as PNG or as a printable A4 PDF – page 1 is an overview with the key, followed by the chart split into numbered pages
- Estimated finished size on 14-count Aida
See it before you stitch it
- Preview shows roughly how the finished piece will look: shaded cross stitches on Aida fabric, circles shown in a wooden hoop
Track your progress
- Progress view: click or drag over finished stitches, or mark a whole connected colour area with a single click
- Finished areas fade away, so only what's left is visible – press ⌘K to show them again with a green tick
- Highlight one colour at a time, mark a whole colour as done, undo with ⌘Z
- Progress is saved automatically and restored when you reopen the same image with the same settings
Everything else
- English and Hungarian interface (follows your system language; can be changed in the sidebar)
- Native Mac app and a web version that runs in any modern browser
- 100% offline – no account, no tracking, no network access
Pattern view – settings on the left, the chart with symbols and the DMC key on the right
![]() |
![]() |
| Preview – roughly how it will look stitched | Progress – finished areas fade away |
Thread list with DMC codes and stitch counts
How much detail? It's up to you. The same photo at two widths – fewer stitches make a quicker, bolder project; more stitches capture fine detail:
![]() |
![]() |
| 80 × 80 stitches (≈ 14.5 cm on 14-count Aida) | 300 × 300 stitches (≈ 54 cm on 14-count Aida) |
Subtle shades, clearly separated. Even with 28 DMC colours of similar browns and greys, every thread has its own symbol, so the chart stays easy to follow:
Sample photos © Zsolt Hoffmann – see more of my photography at zsolthoffmann.com and on Instagram @zsolthoffmanncom
Open zsohoffmann.github.io/CraftDora – that's it. The web version has the same features as the Mac app: shapes and crop, image adjustments, DMC thread matching, the stitched preview and progress tracking.
- Your photos never leave your device. Everything is processed inside your browser; nothing is uploaded.
- Works offline. Once the page has loaded, you don't need an internet connection. You can also save the page (File → Save Page As…, or download
docs/index.html) and open the file from your computer any time. - Export a PNG, or use Print / PDF and choose Save as PDF in your browser's print dialog.
- Your progress is saved in the browser you use. Clearing your browser data also clears the saved progress.
- Works best in an up-to-date Chrome, Edge, Firefox or Safari. HEIC photos open in Safari; in other browsers, use JPEG or PNG.
Requirements: a Mac with Apple silicon (M1, M2, M3, M4 …) and macOS 12 Monterey or later. Intel Macs are not supported – please use the web version instead.
- Download
CraftDora.dmgfrom the Releases page. - Open the DMG and drag CraftDora into your Applications folder.
- The first time you open it, macOS will warn you that it can't verify the app. This is expected: CraftDora is a free, independent project and isn't signed with a paid Apple Developer ID. To open it anyway:
- macOS 15 Sequoia and later: try to open CraftDora once, then go to System Settings → Privacy & Security, scroll down and click Open Anyway next to the CraftDora message. Confirm with your password.
- macOS 12–14: right-click (or Control-click) CraftDora in Applications, choose Open, then click Open in the dialog.
- Or, in Terminal:
xattr -dr com.apple.quarantine /Applications/CraftDora.app
You only need to do this once. The full source code is right here, so you can check exactly what the app does – or build it yourself.
You need the Xcode Command Line Tools (the full Xcode app is not required):
xcode-select --install
git clone <this repository>
cd CraftDora
bash build.shThe script compiles the app, signs it ad hoc for your own Mac and creates build/CraftDora.app and build/CraftDora.dmg. You can also double-click Build DMG.command in Finder.
Apps you build yourself don't trigger the Gatekeeper warning on your own Mac.
- Open an image – click Open Image… (⌘O) or drop a photo onto the window.
- Choose the shape – Original, Square or Circle. For square and circle, drag the frame on the thumbnail and use Crop zoom to pick the part you want.
- Set the size and colours – the width in stitches decides the finished size (see the estimate in the sidebar); fewer colours means an easier project.
- Fine-tune the image – vibrance, contrast, highlights and shadows. Faded or hazy photos often benefit from +15–25% contrast.
- Check the Preview to see how it will look stitched.
- Export – PNG… (⌘S) or PDF… (⌘E) for printing. Copy the thread list for shopping.
- Stitch! Switch to Progress and mark what you've finished as you go.
Tips
- Simple subjects with clear shapes and good contrast give the best results: portraits with a plain background, flowers, pets, logos and pixel art.
- On 14-count Aida, 100 stitches are about 18 cm (7 in).
- Screens and threads never match perfectly – compare with a real DMC colour card before buying.
CraftDora never sends anything over the internet. Your images are processed only on your own device – in the Mac app or inside your browser – and are never uploaded anywhere. The only data it stores is your stitching progress and a few preferences: the Mac app keeps them in ~/Library/Application Support/CraftDora/Progress, the web version in your browser's local storage.
CraftDora is my idea and my project – the concept, the features, the look and every design decision come from me, a photographer with a clear picture of what the cross-stitch community could use.
I also used Claude, Anthropic's AI assistant, while building it.
CraftDora is free, and it will stay free. I'm an independent photographer, not a company, so the best way to support the project is to help it reach people:
-
⭐ Star this repository – it helps others find it.
-
🧵 Share what you make! If you post a pattern or a finished piece made with CraftDora, I'd be really grateful for a mention, for example:
Pattern made with CraftDora by Zsolt Hoffmann – zsolthoffmann.com
On Instagram, tag @zsolthoffmanncom and use the hashtag #CraftDora, so I can find and admire your work.
-
💬 Tell a friend or share it in your favourite cross-stitch group.
For someone working on their own, every mention means a lot. Thank you!
When I'm not building tools like this, I'm behind the camera. If you enjoy images – the kind that might even become your next cross-stitch project – please visit my portfolio at zsolthoffmann.com and follow me on Instagram at @zsolthoffmanncom. I'd love to have you there.
Found a bug or have an idea? Please open an issue. Pull requests are welcome too, especially translations into more languages.
CraftDora is a personal, non-commercial project maintained in my free time, so replies may take a little while – thank you for your patience.
CraftDora © 2026 Zsolt Hoffmann – zsolthoffmann.com
CraftDora is free software, licensed under the GNU General Public License v3.0 – see LICENSE. You may use, study, share and modify it. If you distribute it or a modified version, you must keep the copyright notice and release your changes under the same licence.
The DMC thread colour data comes from sharlagelfand/dmc (MIT licence) – see THIRD_PARTY_NOTICES.txt.
“DMC” is a trademark of DMC Corporation. CraftDora is not affiliated with, endorsed by or sponsored by DMC Corporation.




