← Back to documentation

Installation

How to download and install EP-PatchStudio on macOS, Windows and Linux

Pre-Release Builds (Unsigned)

Current beta builds are not code-signed and will trigger security warnings from your operating system. This is temporary — production releases will be properly signed. Follow the platform-specific instructions below to install.

Download

Download the latest version for your platform:

  • macOS: EP-PatchStudio_macOS_universal.dmg (Intel and Apple Silicon)
  • Windows: EP-PatchStudio_Windows_x64_installer.exe
  • Linux: .deb, .rpm, or .AppImage

Only download from official sources: this website, or the GitHub releases page.

macOS Installation

macOS Gatekeeper blocks unsigned applications. You'll see an error like: "EP-PatchStudio.app" can't be opened because it is from an unidentified developer.

Method 1: Right-Click Open (Recommended)

  1. Double-click the DMG to mount it
  2. Drag EP-PatchStudio.app to your Applications folder
  3. Right-click (or Control+click) on EP-PatchStudio.app in Applications
  4. Select "Open" from the context menu
  5. Click "Open" in the security dialogue
  6. The app will now open and macOS will remember your choice

Method 2: System Settings (macOS 13+)

  1. Try to open the app normally (it will be blocked)
  2. Open System Settings → Privacy & Security
  3. Scroll to the Security section
  4. Click "Open Anyway" next to the EP-PatchStudio message
  5. Enter your password if prompted

Method 3: Terminal (Advanced)

Remove the quarantine attribute:

xattr -cr /Applications/EP-PatchStudio.app

Troubleshooting macOS

  • "The application is damaged" — Run the xattr command above, or re-download the DMG
  • "Application already open" — Quit completely (Cmd+Q) and try again

Windows Installation

Windows Defender SmartScreen blocks unsigned executables. You'll see: Windows protected your PC

Installation Steps

  1. Double-click the installer
  2. SmartScreen appears — click "More info" (small text link)
  3. Click "Run anyway"
  4. Follow the installation wizard
  5. If UAC appears, click "Yes"

The first time you run EP-PatchStudio from the Start Menu, SmartScreen may appear again. Click "More info" "Run anyway".

Troubleshooting Windows

  • "This app can't run on your PC" — You may have downloaded the wrong architecture. EP-PatchStudio requires Windows 10 x64 or later.
  • "Access denied" during install — Right-click the installer → "Run as administrator"
  • "Windows Defender blocked this app" — Open Windows Security → Virus & threat protection → Protection history → Find EP-PatchStudio → Actions → "Allow on device"

Linux Installation

Linux distributions generally don't enforce code signing for desktop applications.

Debian/Ubuntu (.deb package)

sudo dpkg -i ep-patchstudio_*.debsudo apt-get install -f # Install dependencies if needed

AppImage (Universal)

chmod +x EP-PatchStudio-*.AppImage./EP-PatchStudio-*.AppImage

RPM-based (Fedora, RHEL, openSUSE)

sudo rpm -i ep-patchstudio-*.rpm

Why Are These Steps Necessary?

Code signing verifies the publisher's identity and ensures software hasn't been tampered with. It requires purchasing certificates (Apple Developer ID costs $99/year, Microsoft Authenticode $200-400/year).

For beta testing, pre-release and initial release, I'm distributing unsigned builds to keep costs down and iterate quickly. I do plan to implement code siging in a future release.

Is This Safe?

Yes, if you downloaded from an official source.

Unsigned ≠ unsafe. It just means I haven't paid for a code signing certificate yet. You can verify the app's integrity by:

  • Checking the SHA-256 file hash (provided with downloads)
  • Scanning with antivirus if you're concerned

Never download from third-party sites

Only download EP-PatchStudio from ep-patch.studio, squarewave.studio, or the official GitHub releases.

Need Help?

If you're having trouble installing, email joe@squarewave.studio with:

  • Your operating system and version
  • The exact error message (a screenshot helps)
  • What you've tried so far

Next Steps

Ready to try EP-PatchStudio?

Free trial with full features. No credit card required.