v0.3.6

Platy v0.3.4 Release Guide

Contents:

This release has both the standalone and photoshop plugin for newer and older macbooks. If you are on a mac built pre November 2020 then you should install the x86_64 version of the dmg files. If you are on a mac built post November 2020 then you should use the arm64 dmg files.

Which one of these should you download?

To decide which tools you should download for your Mac you will need to do the following:

1. Press the Apple button in the top left part of the mac desktop and click on About This Mac
2. In the window that pops up, look for the words "Chip" or 'Processor"

• If your "Chip" says Apple M{*} where {*} is some number, you will download the arm64 dmg files
• If your "Processor" says "Intel" you will downoad the x86_64 dmg files

3. Then look at the macOS value:

• If macOS says Tahoe, then you will download the macos dmg files
• If macOS says Ventura, then you will download the macos13 dmg files

So if you have a chip M1 on macOS Tahoe then you will install Platypus-macos-arm64.dmg and Platypus-photoshop-macos-arm64.dmg.

So if you have a processor Intel on macOS Ventura then you will install Platypus-macos13-x86_64.dmg and Platypus-photoshop-macos13-x86_64.dmg.

For Macs made post-November 2020 that have an M1, M2, M{N} series cpu.

Platypus-macos-arm64.dmg: The standalone app
Platypus-photoshop-macos-arm64.dmg: The Photoshop plugin

For Macs made pre-November 2020 that have an intel cpu

Platypus-macos-x86_64.dmg: The standalone app
Platypus-photoshop-macos-x86_64.dmg: The Photoshop plugin

Standalone and Photoshop Install Instructions

The below instructions cover installs for the standalone and photoshop plugin for arm64 on Tahoe, but the same instructions should apply for the x86_64 and Ventura.

---

Standalone Install Instructions

Installation Guide for Platypus-macos-arm64.dmg

This guide explains how to install the standalone Platypus macOS application from Platypus-macos-arm64.dmg on an Apple silicon Mac. The Platypus repository describes the software as available both as a standalone application and as a Photoshop plug-in, and the current macOS build is produced as a native .app bundle for arm64. ([GitHub][1])

Close any running copy of Platypus before updating.
If you already have an earlier copy of the standalone app open, quit it before replacing it with a newer version. That is normal macOS app replacement practice and avoids file-in-use issues during copy. Apple’s uninstall and app-management guidance is based around applications living in the Applications folder. ([Apple Support][4])

Installation procedure

Step 1: Open the disk image

Locate Platypus-macos-arm64.dmg in Finder and double-click it. Apple explains that .dmg files are disk images and must be opened first so their contents appear on the desktop or in a Finder window. ([Apple Support][5])

Step 2: Open the mounted image and locate the application

After the disk image mounts, open it in Finder if it does not open automatically. The mounted image should contain the standalone Platypus application bundle. Based on the current build configuration and macOS release workflow, the visible app bundle may appear as PlatypusGui.app.

Step 3: Copy the application into Applications

Drag the Platypus application bundle from the mounted disk image into /Applications. If the mounted image shows an Applications shortcut, you can drag the app onto that shortcut. If it does not, open a second Finder window and drag the app into the Applications folder manually.

Step 4: Wait for the copy to finish

Let Finder complete the copy into Applications before launching the app. Running it directly from the mounted disk image is not recommended for normal use because the app should be installed in its final location first.

Step 5: Eject the disk image

After the copy finishes, eject the mounted Platypus disk image from Finder (you can just close the window). This confirms you are no longer launching the app from the temporary mounted image.

Step 6: Launch Platypus from Applications

Open Applications in Finder and double-click the Platypus application. On first launch, macOS may show a security approval prompt because the app was downloaded from the internet. Apple says this first-run check is normal for software downloaded outside the App Store. ([Apple Support][4])

First-launch behavior and macOS security prompts

Normal first-launch prompt

Apple says that when you first open a newly downloaded app from an identified developer outside the App Store, macOS may ask whether you are sure you want to open it. That prompt is expected and does not necessarily indicate a problem. ([Apple Support][6])

If macOS says it cannot verify the developer or check the app for malware

This would be a huge bad, please report this to me if it happens. Though following the instructions below will still allow you to use the app.

1. Try to open the app once.
2. Open Apple menu > System Settings > Privacy & Security.
3. Under Security, click Open Anyway.
4. Enter your password to approve the exception.

Verifying the installation

After launching from Applications, Platypus should open as a standalone desktop application. If your goal is to use Platypus from inside Adobe Photoshop’s Filter menu, that is a different installation path and requires the Photoshop plug-in package instead.

Troubleshooting

The DMG opens, but I do not know which file to install

Look for the .app bundle inside the mounted image. In the current build and GitHub macOS workflow, that bundle is PlatypusGui.app.

The app works when opened from the DMG, but not after ejecting it

That usually means the app was launched directly from the mounted image rather than copied into Applications. Reopen the DMG, drag the app into /Applications, then launch it from Applications. Apple’s install and uninstall guidance is centered on apps living in the Applications folder. ([Apple Support][4])

macOS blocks the app on first launch

Use the Privacy & Security > Open Anyway flow only if you trust the release source. Apple explicitly warns that overriding security settings for unverified apps increases risk. ([Apple Support][7])

I want to update to a newer version

Quit Platypus, mount the newer DMG, drag the newer app into Applications, and replace the old copy when Finder prompts you. This follows the same standard Applications-folder model Apple documents for managing apps downloaded from the internet. ([Apple Support][4])

---

Photoshop Install Instructions

NOTE: I do not own photoshop so cannot check the installation myself. Below is a summary of instructions from chatgpt about the procedure for adding a new plugin to photoshop. If this does not work let me know and I will see if anyone in my office has photoshop and will test the install process.

---

Platypus for Adobe Photoshop on macOS (Apple Silicon)

Installation Guide for Platypus-photoshop-macos-arm64.dmg

This guide explains how to install the Platypus Photoshop plug-in from the ARM64 macOS release package into Adobe Photoshop. Platypus is installed as a traditional third-party Photoshop plug-in, not through Adobe’s Plugin Marketplace, and the project’s install instructions require that the plug-in bundle and companion app remain together inside the same versioned folder. ([Adobe Help Center][1])

Before you begin

1. Close Adobe Photoshop completely.
   The Platypus installation instructions say Photoshop should be quit before installing or updating the plug-in. ([GitHub][3])

2. Choose an installation location.
   Adobe supports two standard macOS locations for third-party Photoshop plug-ins:

   • Version-specific location
     /Applications/Adobe Photoshop [version]/Plug-ins
     This loads the plug-in only for that specific Photoshop version.
   • Shared Creative Cloud location
     /Library/Application Support/Adobe/Plug-Ins/CC
     This loads the plug-in for all installed Photoshop versions. ([Adobe Help Center][4])

3. Recommended location.
   If you use only one Photoshop version, either location is fine. If you keep multiple Photoshop versions installed, the shared Creative Cloud location is usually the better choice because Adobe says it is loaded across all installed versions. ([Adobe Help Center][4])

Installation procedure

Step 1...

v0.3.4

Platy v0.3.4 Release Guide

Contents:

This release has both the standalone and photoshop plugin for newer and older macbooks. If you are on a mac built pre November 2020 then you should install the x86_64 version of the dmg files. If you are on a mac built post November 2020 then you should use the arm64 dmg files.

Which one of these should you download?

To decide which tools you should download for your Mac you will need to do the following:

1. Press the Apple button in the top left part of the mac desktop and click on About This Mac
2. In the window that pops up, look for the words "Chip" or 'Processor"

• If your "Chip" says Apple M{*} where {*} is some number, you will download the arm64 dmg files
• If your "Processor" says "Intel" you will downoad the x86_64 dmg files

3. Then look at the macOS value:

• If macOS says Tahoe, then you will download the macos dmg files
• If macOS says Ventura, then you will download the macos13 dmg files

So if you have a chip M1 on macOS Tahoe then you will install Platypus-macos-arm64.dmg and Platypus-photoshop-macos-arm64.dmg.

So if you have a processor Intel on macOS Ventura then you will install Platypus-macos13-x86_64.dmg and Platypus-photoshop-macos13-x86_64.dmg.

For Macs made post-November 2020 that have an M1, M2, M{N} series cpu.

Platypus-macos-arm64.dmg: The standalone app
Platypus-photoshop-macos-arm64.dmg: The Photoshop plugin

For Macs made pre-November 2020 that have an intel cpu

Platypus-macos-x86_64.dmg: The standalone app
Platypus-photoshop-macos-x86_64.dmg: The Photoshop plugin

Standalone and Photoshop Install Instructions

The below instructions cover installs for the standalone and photoshop plugin for arm64 on Tahoe, but the same instructions should apply for the x86_64 and Ventura.

---

Standalone Install Instructions

Installation Guide for Platypus-macos-arm64.dmg

This guide explains how to install the standalone Platypus macOS application from Platypus-macos-arm64.dmg on an Apple silicon Mac. The Platypus repository describes the software as available both as a standalone application and as a Photoshop plug-in, and the current macOS build is produced as a native .app bundle for arm64. ([GitHub][1])

Close any running copy of Platypus before updating.
If you already have an earlier copy of the standalone app open, quit it before replacing it with a newer version. That is normal macOS app replacement practice and avoids file-in-use issues during copy. Apple’s uninstall and app-management guidance is based around applications living in the Applications folder. ([Apple Support][4])

Installation procedure

Step 1: Open the disk image

Locate Platypus-macos-arm64.dmg in Finder and double-click it. Apple explains that .dmg files are disk images and must be opened first so their contents appear on the desktop or in a Finder window. ([Apple Support][5])

Step 2: Open the mounted image and locate the application

After the disk image mounts, open it in Finder if it does not open automatically. The mounted image should contain the standalone Platypus application bundle. Based on the current build configuration and macOS release workflow, the visible app bundle may appear as PlatypusGui.app.

Step 3: Copy the application into Applications

Drag the Platypus application bundle from the mounted disk image into /Applications. If the mounted image shows an Applications shortcut, you can drag the app onto that shortcut. If it does not, open a second Finder window and drag the app into the Applications folder manually.

Step 4: Wait for the copy to finish

Let Finder complete the copy into Applications before launching the app. Running it directly from the mounted disk image is not recommended for normal use because the app should be installed in its final location first.

Step 5: Eject the disk image

After the copy finishes, eject the mounted Platypus disk image from Finder (you can just close the window). This confirms you are no longer launching the app from the temporary mounted image.

Step 6: Launch Platypus from Applications

Open Applications in Finder and double-click the Platypus application. On first launch, macOS may show a security approval prompt because the app was downloaded from the internet. Apple says this first-run check is normal for software downloaded outside the App Store. ([Apple Support][4])

First-launch behavior and macOS security prompts

Normal first-launch prompt

Apple says that when you first open a newly downloaded app from an identified developer outside the App Store, macOS may ask whether you are sure you want to open it. That prompt is expected and does not necessarily indicate a problem. ([Apple Support][6])

If macOS says it cannot verify the developer or check the app for malware

This would be a huge bad, please report this to me if it happens. Though following the instructions below will still allow you to use the app.

1. Try to open the app once.
2. Open Apple menu > System Settings > Privacy & Security.
3. Under Security, click Open Anyway.
4. Enter your password to approve the exception.

Verifying the installation

After launching from Applications, Platypus should open as a standalone desktop application. If your goal is to use Platypus from inside Adobe Photoshop’s Filter menu, that is a different installation path and requires the Photoshop plug-in package instead.

Troubleshooting

The DMG opens, but I do not know which file to install

Look for the .app bundle inside the mounted image. In the current build and GitHub macOS workflow, that bundle is PlatypusGui.app.

The app works when opened from the DMG, but not after ejecting it

That usually means the app was launched directly from the mounted image rather than copied into Applications. Reopen the DMG, drag the app into /Applications, then launch it from Applications. Apple’s install and uninstall guidance is centered on apps living in the Applications folder. ([Apple Support][4])

macOS blocks the app on first launch

Use the Privacy & Security > Open Anyway flow only if you trust the release source. Apple explicitly warns that overriding security settings for unverified apps increases risk. ([Apple Support][7])

I want to update to a newer version

Quit Platypus, mount the newer DMG, drag the newer app into Applications, and replace the old copy when Finder prompts you. This follows the same standard Applications-folder model Apple documents for managing apps downloaded from the internet. ([Apple Support][4])

---

Photoshop Install Instructions

NOTE: I do not own photoshop so cannot check the installation myself. Below is a summary of instructions from chatgpt about the procedure for adding a new plugin to photoshop. If this does not work let me know and I will see if anyone in my office has photoshop and will test the install process.

---

Platypus for Adobe Photoshop on macOS (Apple Silicon)

Installation Guide for Platypus-photoshop-macos-arm64.dmg

This guide explains how to install the Platypus Photoshop plug-in from the ARM64 macOS release package into Adobe Photoshop. Platypus is installed as a traditional third-party Photoshop plug-in, not through Adobe’s Plugin Marketplace, and the project’s install instructions require that the plug-in bundle and companion app remain together inside the same versioned folder. ([Adobe Help Center][1])

Before you begin

1. Close Adobe Photoshop completely.
   The Platypus installation instructions say Photoshop should be quit before installing or updating the plug-in. ([GitHub][3])

2. Choose an installation location.
   Adobe supports two standard macOS locations for third-party Photoshop plug-ins:

   • Version-specific location
     /Applications/Adobe Photoshop [version]/Plug-ins
     This loads the plug-in only for that specific Photoshop version.
   • Shared Creative Cloud location
     /Library/Application Support/Adobe/Plug-Ins/CC
     This loads the plug-in for all installed Photoshop versions. ([Adobe Help Center][4])

3. Recommended location.
   If you use only one Photoshop version, either location is fine. If you keep multiple Photoshop versions installed, the shared Creative Cloud location is usually the better choice because Adobe says it is loaded across all installed versions. ([Adobe Help Center][4])

Installation procedure

Step 1...

v0.3.3

Platy v0.3.3 Release Guide

Contents:

This release has both the standalone and photoshop plugin for newer and older macbooks. If you are on a mac built pre November 2020 then you should install the x86_64 version of the dmg files. If you are on a mac built post November 2020 then you should use the arm64 dmg files.

Which one of these should you download?

To decide which tools you should download for your Mac you will need to do the following:

1. Press the Apple button in the top left part of the mac desktop and click on About This Mac
2. In the window that pops up, look for the words "Chip" or 'Processor"

• If your "Chip" says Apple M{*} where {*} is some number, you will download the arm64 dmg files
• If your "Processor" says "Intel" you will downoad the x86_64 dmg files

3. Then look at the macOS value:

• If macOS says Tahoe, then you will download the macos dmg files
• If macOS says Ventura, then you will download the macos13 dmg files

So if you have a chip M1 on macOS Tahoe then you will install Platypus-macos-arm64.dmg and Platypus-photoshop-macos-arm64.dmg.

So if you have a processor Intel on macOS Ventura then you will install Platypus-macos13-x86_64.dmg and Platypus-photoshop-macos13-x86_64.dmg.

For Macs made post-November 2020 that have an M1, M2, M{N} series cpu.

Platypus-macos-arm64.dmg: The standalone app
Platypus-photoshop-macos-arm64.dmg: The Photoshop plugin

For Macs made pre-November 2020 that have an intel cpu

Platypus-macos-x86_64.dmg: The standalone app
Platypus-photoshop-macos-x86_64.dmg: The Photoshop plugin

Standalone and Photoshop Install Instructions

The below instructions cover installs for the standalone and photoshop plugin for arm64 on Tahoe, but the same instructions should apply for the x86_64 and Ventura.

---

Standalone Install Instructions

Installation Guide for Platypus-macos-arm64.dmg

This guide explains how to install the standalone Platypus macOS application from Platypus-macos-arm64.dmg on an Apple silicon Mac. The Platypus repository describes the software as available both as a standalone application and as a Photoshop plug-in, and the current macOS build is produced as a native .app bundle for arm64. ([GitHub][1])

Close any running copy of Platypus before updating.
If you already have an earlier copy of the standalone app open, quit it before replacing it with a newer version. That is normal macOS app replacement practice and avoids file-in-use issues during copy. Apple’s uninstall and app-management guidance is based around applications living in the Applications folder. ([Apple Support][4])

Installation procedure

Step 1: Open the disk image

Locate Platypus-macos-arm64.dmg in Finder and double-click it. Apple explains that .dmg files are disk images and must be opened first so their contents appear on the desktop or in a Finder window. ([Apple Support][5])

Step 2: Open the mounted image and locate the application

After the disk image mounts, open it in Finder if it does not open automatically. The mounted image should contain the standalone Platypus application bundle. Based on the current build configuration and macOS release workflow, the visible app bundle may appear as PlatypusGui.app.

Step 3: Copy the application into Applications

Drag the Platypus application bundle from the mounted disk image into /Applications. If the mounted image shows an Applications shortcut, you can drag the app onto that shortcut. If it does not, open a second Finder window and drag the app into the Applications folder manually.

Step 4: Wait for the copy to finish

Let Finder complete the copy into Applications before launching the app. Running it directly from the mounted disk image is not recommended for normal use because the app should be installed in its final location first.

Step 5: Eject the disk image

After the copy finishes, eject the mounted Platypus disk image from Finder (you can just close the window). This confirms you are no longer launching the app from the temporary mounted image.

Step 6: Launch Platypus from Applications

Open Applications in Finder and double-click the Platypus application. On first launch, macOS may show a security approval prompt because the app was downloaded from the internet. Apple says this first-run check is normal for software downloaded outside the App Store. ([Apple Support][4])

First-launch behavior and macOS security prompts

Normal first-launch prompt

Apple says that when you first open a newly downloaded app from an identified developer outside the App Store, macOS may ask whether you are sure you want to open it. That prompt is expected and does not necessarily indicate a problem. ([Apple Support][6])

If macOS says it cannot verify the developer or check the app for malware

This would be a huge bad, please report this to me if it happens. Though following the instructions below will still allow you to use the app.

1. Try to open the app once.
2. Open Apple menu > System Settings > Privacy & Security.
3. Under Security, click Open Anyway.
4. Enter your password to approve the exception.

Verifying the installation

After launching from Applications, Platypus should open as a standalone desktop application. If your goal is to use Platypus from inside Adobe Photoshop’s Filter menu, that is a different installation path and requires the Photoshop plug-in package instead.

Troubleshooting

The DMG opens, but I do not know which file to install

Look for the .app bundle inside the mounted image. In the current build and GitHub macOS workflow, that bundle is PlatypusGui.app.

The app works when opened from the DMG, but not after ejecting it

That usually means the app was launched directly from the mounted image rather than copied into Applications. Reopen the DMG, drag the app into /Applications, then launch it from Applications. Apple’s install and uninstall guidance is centered on apps living in the Applications folder. ([Apple Support][4])

macOS blocks the app on first launch

Use the Privacy & Security > Open Anyway flow only if you trust the release source. Apple explicitly warns that overriding security settings for unverified apps increases risk. ([Apple Support][7])

I want to update to a newer version

Quit Platypus, mount the newer DMG, drag the newer app into Applications, and replace the old copy when Finder prompts you. This follows the same standard Applications-folder model Apple documents for managing apps downloaded from the internet. ([Apple Support][4])

---

Photoshop Install Instructions

NOTE: I do not own photoshop so cannot check the installation myself. Below is a summary of instructions from chatgpt about the procedure for adding a new plugin to photoshop. If this does not work let me know and I will see if anyone in my office has photoshop and will test the install process.

---

Platypus for Adobe Photoshop on macOS (Apple Silicon)

Installation Guide for Platypus-photoshop-macos-arm64.dmg

This guide explains how to install the Platypus Photoshop plug-in from the ARM64 macOS release package into Adobe Photoshop. Platypus is installed as a traditional third-party Photoshop plug-in, not through Adobe’s Plugin Marketplace, and the project’s install instructions require that the plug-in bundle and companion app remain together inside the same versioned folder. ([Adobe Help Center][1])

Before you begin

1. Close Adobe Photoshop completely.
   The Platypus installation instructions say Photoshop should be quit before installing or updating the plug-in. ([GitHub][3])

2. Choose an installation location.
   Adobe supports two standard macOS locations for third-party Photoshop plug-ins:

   • Version-specific location
     /Applications/Adobe Photoshop [version]/Plug-ins
     This loads the plug-in only for that specific Photoshop version.
   • Shared Creative Cloud location
     /Library/Application Support/Adobe/Plug-Ins/CC
     This loads the plug-in for all installed Photoshop versions. ([Adobe Help Center][4])

3. Recommended location.
   If you use only one Photoshop version, either location is fine. If you keep multiple Photoshop versions installed, the shared Creative Cloud location is usually the better choice because Adobe says it is loaded across all installed versions. ([Adobe Help Center][4])

Installation procedure

Step 1...

v0.3.2

Fix macOS 13 release artifact upload

v0.3.0

Platy v0.3.0 Release Guide

Contents:

This release has both the standalone and photoshop plugin for newer and older macbooks. If you are on a mac built pre November 2020 then you should install the x86_64 version of the dmg files. If you are on a mac built post November 2020 then you should use the arm64 dmg files.

Note: Going to the menu bar and selecting About This Mac should tell you if you are on an M-series arm CPU or an x86 Intel CPU.

For Macs made post-November 2020 that have an M1, M2, M{N} series cpu.

Platypus-macos-arm64.dmg: The standalone app
Platypus-photoshop-macos-arm64.dmg: The Photoshop plugin

For Macs made pre-November 2020 that have an intel cpu

Platypus-macos-x86_64.dmg: The standalone app
Platypus-photoshop-macos-x86_64.dmg: The Photoshop plugin

Standalone and Photoshop Install Instructions

The below instructions cover installs for the standalone and photoshop plugin for arm64, but the same instructions should apply for the x86_64.

---

Standalone Install Instructions

Installation Guide for Platypus-macos-arm64.dmg

This guide explains how to install the standalone Platypus macOS application from Platypus-macos-arm64.dmg on an Apple silicon Mac. The Platypus repository describes the software as available both as a standalone application and as a Photoshop plug-in, and the current macOS build is produced as a native .app bundle for arm64. ([GitHub][1])

Close any running copy of Platypus before updating.
If you already have an earlier copy of the standalone app open, quit it before replacing it with a newer version. That is normal macOS app replacement practice and avoids file-in-use issues during copy. Apple’s uninstall and app-management guidance is based around applications living in the Applications folder. ([Apple Support][4])

Installation procedure

Step 1: Open the disk image

Locate Platypus-macos-arm64.dmg in Finder and double-click it. Apple explains that .dmg files are disk images and must be opened first so their contents appear on the desktop or in a Finder window. ([Apple Support][5])

Step 2: Open the mounted image and locate the application

After the disk image mounts, open it in Finder if it does not open automatically. The mounted image should contain the standalone Platypus application bundle. Based on the current build configuration and macOS release workflow, the visible app bundle may appear as PlatypusGui.app.

Step 3: Copy the application into Applications

Drag the Platypus application bundle from the mounted disk image into /Applications. If the mounted image shows an Applications shortcut, you can drag the app onto that shortcut. If it does not, open a second Finder window and drag the app into the Applications folder manually.

Step 4: Wait for the copy to finish

Let Finder complete the copy into Applications before launching the app. Running it directly from the mounted disk image is not recommended for normal use because the app should be installed in its final location first.

Step 5: Eject the disk image

After the copy finishes, eject the mounted Platypus disk image from Finder (you can just close the window). This confirms you are no longer launching the app from the temporary mounted image.

Step 6: Launch Platypus from Applications

Open Applications in Finder and double-click the Platypus application. On first launch, macOS may show a security approval prompt because the app was downloaded from the internet. Apple says this first-run check is normal for software downloaded outside the App Store. ([Apple Support][4])

First-launch behavior and macOS security prompts

Normal first-launch prompt

Apple says that when you first open a newly downloaded app from an identified developer outside the App Store, macOS may ask whether you are sure you want to open it. That prompt is expected and does not necessarily indicate a problem. ([Apple Support][6])

If macOS says it cannot verify the developer or check the app for malware

This would be a huge bad, please report this to me if it happens. Though following the instructions below will still allow you to use the app.

1. Try to open the app once.
2. Open Apple menu > System Settings > Privacy & Security.
3. Under Security, click Open Anyway.
4. Enter your password to approve the exception.

Verifying the installation

After launching from Applications, Platypus should open as a standalone desktop application. If your goal is to use Platypus from inside Adobe Photoshop’s Filter menu, that is a different installation path and requires the Photoshop plug-in package instead.

Troubleshooting

The DMG opens, but I do not know which file to install

Look for the .app bundle inside the mounted image. In the current build and GitHub macOS workflow, that bundle is PlatypusGui.app.

The app works when opened from the DMG, but not after ejecting it

That usually means the app was launched directly from the mounted image rather than copied into Applications. Reopen the DMG, drag the app into /Applications, then launch it from Applications. Apple’s install and uninstall guidance is centered on apps living in the Applications folder. ([Apple Support][4])

macOS blocks the app on first launch

Use the Privacy & Security > Open Anyway flow only if you trust the release source. Apple explicitly warns that overriding security settings for unverified apps increases risk. ([Apple Support][7])

I want to update to a newer version

Quit Platypus, mount the newer DMG, drag the newer app into Applications, and replace the old copy when Finder prompts you. This follows the same standard Applications-folder model Apple documents for managing apps downloaded from the internet. ([Apple Support][4])

---

Photoshop Install Instructions

NOTE: I do not own photoshop so cannot check the installation myself. Below is a summary of instructions from chatgpt about the procedure for adding a new plugin to photoshop. If this does not work let me know and I will see if anyone in my office has photoshop and will test the install process.

---

Platypus for Adobe Photoshop on macOS (Apple Silicon)

Installation Guide for Platypus-photoshop-macos-arm64.dmg

This guide explains how to install the Platypus Photoshop plug-in from the ARM64 macOS release package into Adobe Photoshop. Platypus is installed as a traditional third-party Photoshop plug-in, not through Adobe’s Plugin Marketplace, and the project’s install instructions require that the plug-in bundle and companion app remain together inside the same versioned folder. ([Adobe Help Center][1])

Before you begin

1. Close Adobe Photoshop completely.
   The Platypus installation instructions say Photoshop should be quit before installing or updating the plug-in. ([GitHub][3])

2. Choose an installation location.
   Adobe supports two standard macOS locations for third-party Photoshop plug-ins:

   • Version-specific location
     /Applications/Adobe Photoshop [version]/Plug-ins
     This loads the plug-in only for that specific Photoshop version.
   • Shared Creative Cloud location
     /Library/Application Support/Adobe/Plug-Ins/CC
     This loads the plug-in for all installed Photoshop versions. ([Adobe Help Center][4])

3. Recommended location.
   If you use only one Photoshop version, either location is fine. If you keep multiple Photoshop versions installed, the shared Creative Cloud location is usually the better choice because Adobe says it is loaded across all installed versions. ([Adobe Help Center][4])

Installation procedure

Step 1: Open the release package

Locate Platypus-photoshop-macos-arm64.dmg in Finder and double-click it to mount the disk image. Once opened, you should see the packaged Platypus release contents, staged as a versioned folder. ([GitHub][2])

Step 2: Identify the folder you need to copy

Inside the mounted image, locate the versioned Platypus folder, for example:

Platypus v0.3.0

That folder is expected to contain at least:

Platypus.plugin
Platypus.app
User Guide.pdf
INSTALL Photoshop Plugin.txt

The project’s packaging configuration explicitly stages both Platypus.plugin and Platypus.app into that same folder. ([GitHub][2])

Step 3: Copy the entire folder into Phot...

v0.0.2

Full Changelog: v0.0.1...v0.0.2