Install Klixvr on Mac

Download the installer package and double-click it. It puts the klixvr command in /usr/local/bin, so any Terminal window can run it. Confirm you see klixvr 1.0.5.

v1.0.5

macOS pkg

Install

Double-click klixvr_macos_v1.0.5.pkg.
Follow the installer and type your Mac login password when asked. It creates /usr/local/bin if your Mac does not have it yet.
Open Terminal (Applications → Utilities → Terminal) and run klixvr --version.
You should see klixvr 1.0.5.

The installer also puts the README and HOW-TO-USE.md in /usr/local/share/doc/klixvr.

If Mac says the installer can’t be opened

Klixvr is not signed by Apple yet. That is Gatekeeper, not a broken download. Do this once:

macOS 15 (Sequoia) and later: double-click the .pkg and click Done. Open System Settings → Privacy & Security, scroll down, and click Open Anyway.
macOS 14 and earlier: in Finder, Control-click the .pkg → Open → confirm.

First scan

klixvr

Paste a path such as /Users/you/Pictures and press Return. Or pass the folder:

klixvr ~/Pictures

klixvr ~/Pictures --no-phash          # skip visual image matching (faster)
klixvr ~/Documents --min-size 1048576 # skip files smaller than 1 MB
klixvr ~/Pictures --rescan            # ignore the hash cache and start fresh

When it finds duplicates

Each group is one prompt. You choose:

Key	What it does
1, 2, …	Keep that file; move the others to staging
N	Not a duplicate — skip this group next time
L	Ask again later
Q	Quit (progress is saved)

Moved files go to a hidden folder named .klarvr_dups_tbd inside the folder you scanned. Review it yourself. Klixvr will not scan that folder again. It will not delete anything for you.

Uninstall

sudo rm /usr/local/bin/klixvr
sudo rm -r /usr/local/share/doc/klixvr
sudo pkgutil --forget com.mungryapps.klixvr

Optional: delete ~/.dedup_ignore if you do not want the ignore list.

Klixvr is provided as-is. Duplicate detection can be wrong. Review the staging folder before you delete anything.

Linux · Windows · The story