Troubleshooting Guide

macOS Issues

❌ “Apple could not verify ‘kachlan’ is free of malware”

This is expected! Kachlan is not notarized by Apple because:

Solution:

  1. Click “Done” on the warning
  2. Open System Settings → Privacy & Security
  3. Scroll down and click “Open Anyway”
  4. Click “Open” to confirm

After the first launch, macOS will remember your choice.

❌ “kachlan is damaged and can’t be opened”

The app bundle has quarantine attributes.

Solution:

xattr -cr /Applications/kachlan.app

Then try opening again using the “Open Anyway” method above.

🔍 App doesn’t appear in Spotlight or Launchpad

macOS needs to rebuild its app database.

Solution:

killall Dock

Wait a few seconds for Launchpad to reload.

🚫 “Operation not permitted” when running commands

Some commands need admin privileges.

Solution: Add sudo before the command:

sudo spctl --add /Applications/kachlan.app

Enter your Mac password when prompted.

Windows Issues

❌ Windows SmartScreen blocks the app

Windows Defender may show a warning because the app is not signed.

Solution:

  1. Click “More info” on the warning
  2. Click “Run anyway”

Linux Issues

⚠️ “kachlan is potentially unsafe” warning in Software Center

Ubuntu Software may show a warning because the package is from a third-party source (not Ubuntu’s official repositories).

This is expected and safe:

To install anyway:

  1. Click through the warning, or
  2. Install via command line: sudo apt install ./kachlan-gui_linux_amd64.deb

After installation, the app works normally.

❌ App won’t start after installing .deb

The app may not have execute permissions.

Solution:

chmod +x /usr/bin/kachlan

🔍 Can’t find app in application menu

The desktop file may need to be refreshed.

Solution:

sudo update-desktop-database

Or log out and log back in.

General Issues

❌ “ffmpeg not found” error (older versions)

If you’re using a version before v0.5.0, you need to install ffmpeg manually.

Solution - Upgrade: Download the latest version from releases

Solution - Manual install:

🐛 Found a bug?

Please open an issue with:

💬 Need help?