MacOS User

Latest version is from 03.05.2024

How to install eKnitter on a macOS

Open the terminal on your mac:

You will need brew as package manager, git to acccess github, anaconda for Python 3.5 in an virtual environment

install brew (not needed if git already installed):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

install git via brew (not needed if git already installed) :

brew install git
brew install esptool

install Xcode command line tools:

xcode-select --install

get ayab-desktop for eKnitter from github:

git clone -b eKnitter https://github.com/yekomS/ayab-desktop ayab-desktop-eknitter

change to ayab-desktop-eknitter directory:

cd ayab-desktop-eknitter

make directory for anaconda (python virtual environment):

mkdir -p ~/miniconda3

you can check your mac processor architecture (neede for next command):

arch

if you use mac with arm processor: get anaconda for arm64 processor:

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh -o ~/miniconda3/miniconda.sh

if you use mac with intel processor: get anaconda for x86_64 processor:

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda3/miniconda.sh

install anaconda (python virtual environment):

bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3

remove anaconda install script:

rm -rf ~/miniconda3/miniconda.sh

init anaconda:

~/miniconda3/bin/conda init bash
~/miniconda3/bin/conda init zsh

restart you terminal window and change to ayab-desktop-eknitter directory:

cd ayab-desktop-eknitter

create python 3.5 virtual environment:

conda create --name venv -c conda-forge python=3.5 pip

activate python environment:

conda activate venv

update your python environment with required tools:

python -m pip install --upgrade pip
pip install --upgrade setuptools
pip install -r requirements.txt

To solve pip3 SSL:TLSV1_ALERT_PROTOCOL_VERSION problem (dont know if neccessary):

curl https://bootstrap.pypa.io/get-pip.py | python

load patterns from github:

git clone https://github.com/AllYarnsAreBeautiful/ayab-patterns ./src/main/resources/base/patterns

start eKnitter version of ayab-desktop for eKnitter:

python -m fbs run

Install done 🙂

once all tools are installed, you can starte eKnitter version of ayab-desktop for eKnitter:

cd ayab-desktop-eknitter
conda activate venv
python -m fbs run

you can update the latest changes

git pull origin eKnitter

eKnitter on macOS — Users help Users

Installation on a MacBook with M1/M2 chip or newer

Error:

PackagesNotFoundError: python=3.5

Cause:
“there’s no native build for python below 3.8 for Apple Silicon”
Fix:

  1. Create a conda environment: conda create --name venv conda activate venv
  2. Force Intel builds inside this environment: conda config --env --set subdir osx-64
  3. Install Python 3.5 + pip: conda install python=3.5 pip

Update: new problem with installation on Mac

Error:

zsh: bad CPU type in executable

Cause:
Trying to run x86_64 binaries on Apple Silicon without Rosetta.
Fix:

  1. Install Rosetta: softwareupdate --install-rosetta Accept Apple’s license in the terminal.
  2. Re-run installation steps: python -m pip install --upgrade pip pip install --upgrade setuptools pip install -r requirements.txt

Problem installing eKnitter in Mac OS

Error:

/Users/.../python: No module named fbs

Cause:

  • You are not in the correct conda environment (still (base) instead of (venv)), or
  • fbs has not been installed.
    Fix (inside (venv)):
python -m pip install --upgrade pip
pip install --upgrade setuptools
pip install -r requirements.txt
python -m fbs run

Problem installing eKnitter in Mac OS (PyQt5)

Error:

ERROR: No matching distribution found for pyqt5==5.11.3

Cause:
Wrong platform — installed for osx-arm64 instead of osx-64.
Fix:

  1. Make sure you are inside (venv).
  2. Set environment to Intel packages: conda config --env --set subdir osx-64
  3. Re-run the installation commands: python -m pip install --upgrade pip pip install --upgrade setuptools pip install -r requirements.txt

Problem installing eKnitter in Mac OS (unzipping)

Issue:
“It isn’t an application, only a file xxx.7z …”
Cause:
Finder cannot extract .7z archives.
Fix:
Use a dedicated extractor like Keka or The Unarchiver, then continue with the instructions.

Debug page redirects back to Wi-Fi setup

Cause:
The address was entered without http://.
Fix:
Use the full URL:

http://<your-ip>/Debug

(The IP is shown inside the AYAB-eKnitter desktop app, not the example from the manual.)

ESP32 shows up under Bluetooth on Mac

Cause:
ESP32 is visible in Bluetooth, but connection must be via Wi-Fi.
Fix:
Ignore Bluetooth. Instead:

  1. Connect your Mac to the ESP32 Wi-Fi network.
  2. Enter your home Wi-Fi SSID and password.
  3. Reconnect your Mac to your home Wi-Fi.
  4. eKnitter will then use your saved network credentials.
0 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments
0 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments