Install Ink/Stitch on macOS

Video Guide

We also provide beginner tutorial videos on our YouTube channel. Watch the installation process for macOS.

Warning: The video for macOS users is outdated. Please read updated info “Additional Steps for Catalina and Big Sur”

Requirements

That’s it! All python libraries and external dependencies are bundled (using the excellent pyinstaller), so you shouldn’t need to set anything else up.

Installation

Download

Download the release archive.

Language macOS Catalina / Big Sur Sierra* High Sierra* Mojave*
English Catalina / Big Sur Sierra High Sierra Mojave
Finnish Catalina / Big Sur      
French Catalina / Big Sur Sierra High Sierra Mojave
German Catalina / Big Sur Sierra High Sierra Mojave
Italian Catalina / Big Sur      

* There are no recent versions of Ink/Stitch for Sierra, High Sierra or Mojave. The files are from an older Ink/Stitch release: Ink/Stitch v1.26.2 (2019-08-20).

Latest release: Ink/Stitch v1.29.1 (2020-08-19)

The LOCALE selected affects the menus shown inside Inkscape. Ink/Stitch dialogs are in the lanugage of your OS (if that language is supported).

Your language is not available? Help us to translate the dialogs into your native language.

Extract Files

Go to Edit > Preferences > System (Inkscape 0.9) or Inkscape > Preferences > System (Inkscape 1.0) and check where your User Extensions folder is.

Preferences: Extensions Folder

Extract the Ink/Stitch archive directly into this folder. In this folder the file structure should look similiar to this (just a lot more files):

File Structure

Addtitional Steps for Catalina / Big Sur

Newer macOS versions will complain about Ink/Stitch if it is downloaded through your browser. You will receive an error message like this: 'xxxx' cannot be opened, because the developer cannot be verified.

To avoid this error message open your Terminal App. Click on the small magnifying glass icon in your menu bar at the top right corner (or press Command (⌘)+Space). Search for Terminal and open the application.

In the Terminal enter the following command:

xattr -r -d com.apple.quarantine ~/Library/Application\ Support/org.inkscape.Inkscape/config/inkscape/extensions/

Replace ~/Library/Application\ Support/org.inkscape.Inkscape/config/inkscape/extensions/ if your Inkscape extension folder path has an other location (verify through Inkscape > Preferences > System).

Users of Big Sur will need to do one further step to complete the installation:

cd ~/Library/Application\ Support/org.inkscape.Inkscape/config/inkscape/extensions/
cd inkstitch/bin
ln -s libpython2.7.dylib libc.dylib

Run Ink/Stitch

Restart Inkscape.

You will then find Ink/Stitch under Extensions > Ink/Stitch.

Upgrade

Delete the old extension files first. Go to the extension directory and remove each inkstitch* file and folder.

Then, proceed as above.

Tip: Subscribe to a news feed channel to keep track on Ink/Stitch Updates:
GitHub Feed on new Releases
Ink/Stitch News

Or watch the project on GitHub:

Troubleshoot

Ink/Stitch doesn’t run / is greyed out

Confirm installation path

Check if files were possibly extracted into a sub-directory. You should see a lot of files starting with “inkstitch” directly inside the extension folder, beside of one folder called “inkstitch”.

Confirm version

Please verify if you have downloaded Ink/Stitch for macOS (Download).

‘xxxx’ cannot be opened, because the developer cannot be verified

Read “Additional Steps for Catalina and Big Sur”.

ValueError: Null geometry supports no operations

Ink/Stitch on macOS (Catalina) could raise the following error message: [...] ValueError: Null geometry supports no operations.

It was reported to us, that removing the file inkstitch/bin/shapely.speedups._speedups.so has been successfull in order to bring Ink/Stitch to work properly.

I installed Ink/Stitch in my native language, but the dialogue windows are displayed in English

Incomplete Translation

It is possible, that not all strings have been translated. This is indicated by some strings of text beeing in English and others in your native language. If you like to complete the translation, have a look at our description for translators.

Language Settings

We have to distinguish between the Extension menu in Inkscape and the dialogue windows. The selection of the ZIP file causes only the Extension menu to be in a certain language. The dialgoue windows are build differently. They will use the language of your operating system. If Ink/Stitch is uncertain, which language to support, it will fallback on English. You can tell Inkscape explicitly to use your native language as follows:

  • Go to Edit > Preferences > Interface (Ctrl + Shift + P)
  • Set your language
  • Restart Inkscape

Preferences > Interface