Skip to main content

Install the klipper-toolchanger plugin

Plugin Compatibility

The klipper-toolchanger plugin is updated frequently. Before upgrading, back up your printer configuration and review the upstream changelog. The upstream installation script refuses to run as root and defaults to ~/klipper, so it cannot be used directly with FLYOS-FAST.

The upstream no longer maintains Tapchanger configurations in Klipper/config-example. Software plugins and configuration examples are now provided by the klipper-toolchanger repository.

Install the plugin​

Pull or update the plugin​

cd /data
if [ -d /data/klipper-toolchanger/.git ]; then
  git -C /data/klipper-toolchanger pull --ff-only
else
  git clone https://github.com/viesturz/klipper-toolchanger.git /data/klipper-toolchanger
fi
Loading...

This step does not access the network. Once symbolic links are created, plugin updates no longer require copying Python files repeatedly.

for file in /data/klipper-toolchanger/klipper/extras/*.py; do
  name="$(basename "$file")"
  ln -sfn "$file" "/data/klipper/klippy/extras/$name"
  if [ -d /data/klipper/.git/info ]; then
    grep -qxF "klippy/extras/$name" /data/klipper/.git/info/exclude || \
      echo "klippy/extras/$name" >> /data/klipper/.git/info/exclude
  fi
done

systemctl restart klipper
Loading...

Verify the installation​

readlink -f /data/klipper/klippy/extras/toolchanger.py
systemctl is-active klipper

The symbolic link should point to /data/klipper-toolchanger/klipper/extras/toolchanger.py, and the service status should return active.

Plugin configuration options and macros may change with each version. Please refer to the /data/klipper-toolchanger/examples directory. There is no need to fetch the Tapchanger hardware repository separately, nor to delete or re-fetch the /data/klipper that comes with FLYOS-FAST.

Loading...