This is "stitchcraft", a collection of interoperable tools for generating cross-stitch patterns.
"stitchcraft" is free-as-in-mattress. It is several bits of software the author created to satisfy her own needs; if it's useful to you, great!
dune build in the top-level directory of your cloned repository and follow any directions given in the Error lines until the build succeeds. Once that happens, you should be able to dune exec the individual programs from the project's top-level directory.
Pinning the package with opam pin and then installing should work as well.
Stitchcraft is written in OCaml and uses several OCaml tools including the [dune] ) build system. See documentation there to get started.
A better user experience for such folks is coming someday.
Stitchcraft bundles several executables for command-line use. Some are subcommands under stitchcraft; those are separated into commands for generating patterns, and those for manipulating them.
- assemble , for assembling color- and placement-free components into a full cross-stitch pattern
- embellish , for composing cross-stitch patterns in various ways
- estimator , which gives very loose time and materials estimates for cross-stitch patterns
- listing , which makes supplementary files useful in listing cross-stitch patterns on Etsy
- pat2stitchy , which reads some .pat files and converts them to Stitchy's format
- font2sqlite and font2postgres, for importing bitmap fonts to the font databases textstitch uses
- textstitch , for taking text input and making a cross-stitch pattern from it. This depends on a populated font database; see
font2postgresfor help.
- notty_canvas , for displaying patterns in the terminal
- stitchpattern , for converting patterns to PDFs
ih is a fabulous command-line tool for automatically generating cross-stitch patterns from raster images. There is a fork of ih available at https://github.com/yomimono/ih/tree/stitchy_interchange which adds a -o json output mode; the output of ih in this mode is a list of layers, which can be imported into a Stitchcraft workflow with the assemble tool.
All tools are built around the central stitchy library and a simple JSON-based interchange format. As a tool of last resort, it is possible to hand-build patterns understandable by Stitchcraft, but I hope it's easier to use the libraries to build tools instead.
- tries its best to not fuck up when confronted with unicode
- looks cool on your terminal
- generates usable PDFs
- nicer
listingpreview graphics - Etsy API integration (blocked on a bug either in Etsy's OpenAPI 3.0 or our implementation )
- Zoom in
notty_canvas - sensible names or possibly subcommands
- more full-featured composition binaries
- taking raster images and converting them to patterns.
ihdoes a great job and can interoperate withstitchcraft. - vector font scaling and rasterization.
kxstitchdoes this well. - backstitch support in
notty_canvas. I anticipate any othernotty_canvasusers also hating backstitch.
Most early work on this software was done at the Recurse Center, and supported financially by a fellowship from that organization. I am deeply grateful to RC for all its support in the past, present, and future.
The fonts included with this software were originally packaged by VileR and are available in their entirety at https://int10h.org. VileR has kindly packaged these fonts and provided them under a CC-BY-SA license.
This software depends heavily on notty, camlpdf, and various small and useful libraries from erratique.ch.
Lastly, the authors and maintainers of the OCaml langauge and its tooling have made an environment that I find joyful to work in. Thank you for helping me make things!