macOS Support

[NightMachinery]

I am just opening this issue to be notified if macOS ever gets supported.

BTW: Have you seen https://www.willus.com/k2pdfopt/? It's pretty good, though I mostly use it for non-mathy PDFs. It doesn't play that well with equations that take multiple vertical lines.

[arminstraub]

Unfortunately, I am not familiar with macOS at all (and have no plans to change that). However, since krop is written in python, there is a chance that it might just work on macOS provided that PyQt and the other required libraries are available. How you done any experiments and found anything that is preventing krop from working on macOS?

Thank you for pointing out k2pdfopt! It looks quite impressive!

[00sapo]

Try this: #37

[AndrewDDavis]

This issue title is ironic for me, because I found krop while looking for a replacement for a Linux replacement the built-in Preview.app on macOS. It has excellent cropping and general PDF functionality that preserves original quality for my typical workflow:

1. open a pdf in Preview
2. select a region
3. edit > copy
4. file > new from clipboard (opens a new window)
5. repeat 1-3 for other regions
6. show page thumbnails in document sidebars in the newly created document windows
7. drag page thumbnails between window sidebars to create one merged document with the cropped regions as pages
8. save or print, etc.

As far as I can tell, there's no other software for any platform that allows this workflow in such a concise way.

[bquast]

As of August 2025, on an M3 (2024) Macbook, I can install using:

brew install pipx
pipx install --system-site-packages git+https://github.com/arminstraub/krop
pip install install pyqt5
pipx inject krop PyMuPDF
cd /Users/[USERNAME]/.local/pipx/venvs/krop/bin
./krop

For MacPorts users, the pipx install and pyqt5 can be done using MacPorts instead of homebrew and pip.

[Zaakupendrak]

I have installed krop in 2025 Mac Mini M4 and 2020 M1.
Using Python 3.11 or 3.13

# create venv and activate it
python3.13 -m venv venv_krop
source venv_krop/bin/activate

# install dependencies
python -m pip install setuptools PyQt6 PyMuPDF

# clone repo 
git clone https://github.com/arminstraub/krop.git

# build and install into venv_krop directory
cd krop/
python3 setup.py -v build
python3 setup.py -v install

# run krop
cd ..
./venv_krop/bin/krop

[arminstraub]

Thank you @bquast and @Zaakupendrak for the reports on how to install krop on macOS! Given your success, I will close this issue.