A helping paw.
Start with the answers below. If you need a hand, get in touch directly.
Contact the developer
kashimuro@proton.meInclude your macOS and Purrlight versions, the steps you took, and what happened. Screenshots help; hide personal information first. Never send passwords or payment details.
Common questions
How do I open settings and the shelf?
Click the cat in the menu bar. You can also open the shelf with the tray button in Settings. If left-click toggles Keep Awake, right-click opens the controls.
Why isn’t brightness changing?
Allow Purrlight in System Settings → Privacy & Security → Accessibility. These commands simulate brightness keys, not measured percentages; results depend on your display and auto-brightness. Replacing a local build may require permission again. Use your Mac’s physical brightness-up key to restore visibility.
Keep Awake or Keep screen on?
Keep Awake prevents automatic idle sleep while allowing the display to turn off. Keep screen on additionally keeps the display awake. Neither overrides closing the lid or an explicit Sleep command.
Why didn’t I receive a notification?
Notifications are sent when a timed session ends naturally, not when you press Stop. Enable Purrlight notifications in macOS, check Focus, and use the test notification in Settings.
Does the shelf move or copy files?
Choose Move for Finder folders or Copy for attachments. The receiving app determines the final drag action. Use Move To… for an explicit move. Existing destination names are never overwritten.
What does Undo Last Move cover?
It reverses the most recent successful Move To… operation in the current session, not Finder operations. If an original path is occupied or the destination file was replaced, that file is not restored.
Does clearing the shelf delete my files?
No. Clearing removes references only; original files remain at their current locations. The shelf clears when the app quits and is not a backup. Sizes are read on addition; folder contents are excluded from totals.
How do I preview a video or image?
Select a file and press Space, or choose Preview from its right-click menu. If the file was moved or deleted outside Purrlight, add it again from its current location. Format support depends on macOS Quick Look.