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.
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):
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 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
