FAQ

FAQ

macOS says the app is "damaged and can't be opened"

This happens because the app is ad-hoc signed, not notarized with Apple. Fix it:

xattr -cr /Applications/KhmerCalendarBar.app
open /Applications/KhmerCalendarBar.app

Or: System Settings → Privacy & Security → Open Anyway

You only need to do this once.

The app doesn't appear in the menu bar

• Make sure you're running macOS 14.0 Sonoma or later
• Check if the app is running: pgrep -f KhmerCalendarBar
• Try quitting and reopening: pkill -f KhmerCalendarBar && open /Applications/KhmerCalendarBar.app

How do I change the menu bar format?

Click the calendar in the menu bar → click the gear icon → Menu Bar Format → select your preferred format.

How do I set a reminder?

Right-click any day in the calendar → កំណត់រំលឹក → enter a title → set the time → រក្សាទុក (Save).

Where are reminders stored?

Reminders are stored in UserDefaults under the key customReminders as JSON. They persist across app restarts.

How do I enable holiday notifications?

Settings → Notifications → toggle បុណ្យជាតិ on. The app sends a macOS notification at 6 PM the day before each public holiday.

Does it work on Intel Macs?

Yes. The app is built as a universal binary (Apple Silicon + Intel).

How do I make it start automatically?

Settings → General → toggle បើកពេលចាប់ផ្ដើម (Launch at Login) on.

How do I uninstall?

pkill -f KhmerCalendarBar
rm -rf /Applications/KhmerCalendarBar.app
defaults delete com.khmercalendar.bar

Is the Khmer calendar accurate?

The app uses the Chhankitek system based on astronomical epoch calculations including Aharkun, Bodethey, and Avoman. It correctly handles normal years (354 days), Adhikameas years (leap month, 384 days), and Adhikavar years (leap day, 355 days).

Can I contribute?

Yes! The project is open source under the MIT License. Open an issue or submit a pull request at github.com/RithyTep/KhmerCalendarBar.