Installing CatchTeX on Mac and Linux

macOS

CatchTeX for Mac is not yet notarised by Apple, so macOS asks you to confirm the first time you open it. You can check the file's SHA-256 hash on the release page.

1. Open the .dmg and drag CatchTeX onto the Applications folder.
2. Open CatchTeX from Applications. macOS says it "cannot be opened because Apple cannot check it" (or "is damaged"): click Done / Cancel.
3. Open System Settings › Privacy & Security, scroll down to the message about CatchTeX and click Open Anyway. Confirm with your password. You only do this once.
4. If macOS still refuses, open Terminal and run
   xattr -dr com.apple.quarantine /Applications/CatchTeX.app
   then open CatchTeX again.

Screen snips (snipping from any window, not only PDFs opened in CatchTeX) need System Settings › Privacy & Security › Screen Recording: switch on CatchTeX, then quit and reopen it. The global snip shortcut (Ctrl+Option+S by default) needs Input Monitoring in the same place.

Linux

1. Download the AppImage, right-click it › Properties › Permissions › tick Allow executing file as program. Or in a terminal:
   chmod +x CatchTeX-*-linux-x86_64.AppImage
2. Double-click it (or run ./CatchTeX-*-linux-x86_64.AppImage).
3. If it says FUSE is missing (Ubuntu 22.04 and newer): sudo apt install libfuse2 (24.04: libfuse2t64), or use the .tar.gz: extract it and run CatchTeX/CatchTeX.
4. If the window does not open with a message about the "xcb" plugin: sudo apt install libxcb-cursor0.

Wayland desktops (default on recent Ubuntu and Fedora): screen snips use your desktop's own screenshot picker, and the global shortcut is not available, because Wayland does not let apps watch the keyboard. Use the tray icon or the Screen snip button, or log in with an X11 session ("Ubuntu on Xorg") for the shortcut.

Still stuck? Write to [email protected] with your system version.