Skip to main content

InkSim

InkSim is a standalone embroidery simulator and preview renderer. It opens embroidery files, shows the stitch sequence, and lets you inspect or replay a design before production.

It is a normal Python desktop application installed from PyPI — not an Inkscape extension.

InkSim preview

The viewer includes an OpenGL textured renderer that draws stitches as realistic ribbon quads with normal-mapped thread and Blinn-Phong lighting. Press Z in the viewer to toggle between the CPU and GPU renderers. The GPU renderer requires OpenGL 3.3; older systems fall back to the CPU raster renderer automatically.

Thread texture detail
Detail of the normal-mapped thread texture used by the OpenGL renderer.

Install

uv tool install inksim

Requires Python 3.11+. See the installation guide for uv setup and alternative installers.

Run

inksim
inksim design.pes
inksim design.pes --play

On Windows, inksim-gui design.pes starts without a console window.

InkSim main window

Documentation

Background

The idea behind this tool dates back to 2013 with an experimental C++/Qt project called Orca, which originally explored graph algorithms for Inkscape on Linux before turning into a digitizer and stitch viewer. Here is an old recording of that early prototype in action:

Orca viewer demo

InkSim is a fresh, standalone rewrite of that viewer concept -- built from scratch using Python, PySide6, and Numba. The main goal is to provide a fast, lightweight way to preview embroidery files without heavy overhead.

It was built to fill a small workflow gap, and it's shared with the hope that others in the Inkscape and Ink/Stitch community might find it helpful as well.

Special thanks to the Ink/Stitch team and community for keeping open-source embroidery alive and inspiring.

License

InkSim is released under the GNU General Public License v3 or later.

Metadata

Release files for inksim 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for inksim 0.5.2
File Size Uploaded
inksim-0.5.2.tar.gz 602.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for inksim 0.5.2
File Interpreter ABI Platform
inksim-0.5.2-py3-none-any.whl Python 3 none any Details

Total release size: 1.3 MB

Release files / inksim-0.5.2.tar.gz

Download URL inksim-0.5.2.tar.gz
Size 602.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a0bb8d812aecaf3bf30539b580b85b52bf399c1a41f76d12de0d3d8a872776c5
BLAKE2b-256 checksum
How to use checksums
5b8cc17f4fddf0cd439fc441b1e43e1da4e8abab21d6d0dcfd7a844bcc7e499b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Release files / inksim-0.5.2-py3-none-any.whl

Download URL inksim-0.5.2-py3-none-any.whl
Size 744.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
48743b8802e83b655fd4f5c664b7d5bf7cdf98e2c1a67bf1aed95eb7bc278dfd
BLAKE2b-256 checksum
How to use checksums
26ec37beec07b5a27f4c72c14a97538e0756449b2770dc43681bc07c58d0dd7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Release history Release notifications | RSS feed

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

This release

0.5.2 This release

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.6

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page