Blog

To install K40 Whisperer on macOS, follow these steps:

Prerequisites

1. Python Installation:

1. • K40 Whisperer requires Python 3.x to run. Ensure Python is installed on your Mac.

   • Install Python via Homebrew. (Follow Step below)

2. Install Homebrew (if not already installed):

   • Open Terminal and run:

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

3. Install required dependencies:

• Install libusb via Homebrew

brew install libusb 

Installation Steps

1. Download K40 Whisperer:

   • Visit the K40 Whisperer GitHub page or the official website.

   • Download the latest .zip file for macOS.

2. Extract the Files:

   • Unzip the downloaded file into a directory of your choice.

3. Install Required Python Libraries:

   • Navigate to the extracted directory in Terminal:
     cd /path/to/k40whisperer

   • Install required Python libraries:
     pip3 install -r requirements.txt

4. Run K40 Whisperer:

   • In the same directory, run the program:
     python3 k40_whisperer.py

5. Create a Shortcut for Easier Access (Optional):

• Create a shell script or an alias to launch K40 Whisperer from anywhere:
  echo 'alias k40whisperer="python3 /path/to/k40whisperer/k40_whisperer.py"' >> ~/.zshrc 

  source ~/.zshrc

1. • Now, type k40whisperer in Terminal to start the program.

Tips

• Ensure the K40 laser machine is properly connected via USB to your Mac.

Install Python via Homebrew.

Step 1: Locate Python Installation

Find the current Python installation:

which python3

which pip3

These commands will show the installation paths for Python 3 and pip3.

Step 2: Uninstall Existing Python

If Python was installed via the official installer:

Remove the Python framework manually:

sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.x

Replace 3.x with the installed version (e.g., 3.12).

Remove symbolic links:

sudo rm /usr/local/bin/python3

sudo rm /usr/local/bin/pip3

Step 3: Reinstall Python Using Homebrew

1. Install Python 3 via Homebrew:
   
   brew install python

2. Verify the installation:
   python3 --version

pip3 --version

Step 4: Set Up a Clean Environment

1. Upgrade pip:
   python3 -m pip install --upgrade pip

2. Create a virtual environment for your project:
   python3 -m venv k40_env

source k40_env/bin/activate

1. Install required dependencies:
   pip install -r requirements.txt

Step 5: Confirm Installation

Test if pip3 works properly:

pip3 --version

Step 1: Check the Current Working Directory

Determine the directory where the command is running:

pwd

If this directory is restricted (e.g., a protected system directory or a mounted volume), move the project files to a user-owned directory like ~/Documents or ~/Projects.

Step 2: Change Directory

If your project is in a restricted folder, move it to a safe location:

1. Create a new directory:
   
   mkdir ~/Projects/K40Whisperer

2. Move the project files:
   
   mv /path/to/k40whisperer/* ~/Projects/K40Whisperer

3. Navigate to the new directory:
   
   cd ~/Projects/K40Whisperer

Step 3: Recreate the Virtual Environment

Recreate the virtual environment in the new location:

1. Delete the old environment:
   
   rm -rf k40_env

2. Create a new virtual environment:
   
   python3 -m venv k40_env

3. Activate the virtual environment:
   
   source k40_env/bin/activate

4. Upgrade pip:
   
   pip install --upgrade pip

5. Install the dependencies:
   
   pip install -r requirements.txt

Step 4: Adjust Permissions (if needed)

If the issue persists:

1. Check permissions for the directory:
   
   ls -ld $(pwd)

2. Ensure you own the directory and have write access. If not, change ownership:
   
   sudo chown -R $(whoami) $(pwd)

3. Set appropriate permissions:
   
   chmod u+rwx $(pwd)

Step 5: Retry the Installation

1. Run your pip command or script again:

pip install -r requirements.txt

Step 1: Verify if tkinter is Installed

Run the following command to check if tkinter is available:
python3 -m tkinter

If the command does not open a blank GUI window or shows an error, proceed to install tkinter.

Step 2: Install tkinter

macOS Homebrew Installation: If Python was installed via Homebrew, you'll need to ensure tkinter is installed with it:
brew install python-tk

Reinstall Python with tkinter Support: If the above doesn't work, reinstall Python using Homebrew with the tcl-tk dependency:
brew install tcl-tk

brew reinstall python

Verify Installation: After reinstalling Python, check if tkinter is now included:
python3 -m tkinter

Step 3: Configure Python to Use Tcl/Tk Framework

If you encounter further issues:

1. Find the Tcl/Tk installation directory:
   brew info tcl-tk

2. Note the directory (e.g., /opt/homebrew/opt/tcl-tk).

Set environment variables to link Python with Tcl/Tk:
export PATH="/opt/homebrew/opt/tcl-tk/bin:$PATH"

export LDFLAGS="-L/opt/homebrew/opt/tcl-tk/lib"

export CPPFLAGS="-I/opt/homebrew/opt/tcl-tk/include"

export PKG_CONFIG_PATH="/opt/homebrew/opt/tcl-tk/lib/pkgconfig"

3. Rebuild Python:
   brew reinstall python

Step 4: Activate the Environment and Retry

1. Activate the virtual environment:
   source k40_env/bin/activate

2. Run K40 Whisperer again:
   bash
   Copy code
   python3 k40_whisperer.py

Last but not least, need to edit the before execute code python3 k40_whisperer.py need to edit the  k40_whisperer.py file to suite with latest python program. You may download it here which I already edit it.