Maya on Mac — a short guide

Maya (माया) is a caring companion who lives at the top of your screen — a little heart with a face. Maya reminds you to eat, drink water, stretch, rest your eyes and call home.

Maya is free. There is no account, no subscription and no locked features. Maya works with the internet switched off, and nothing you do in Maya leaves your Mac.

1. Install

1. Download Maya.dmg from the website.
2. Open the file you downloaded and drag Maya into your Applications folder.
3. Open your Applications folder and right-click Maya → Open, then click Open again.

That right-click step matters. Maya is not yet signed with an Apple certificate, so if you double-click the first time, macOS says "Maya cannot be opened because it is from an unidentified developer" or "Maya is damaged". Right-click → Open tells macOS you trust it. You only do this once; after that, Maya opens normally.

If macOS still refuses, open Terminal and run: xattr -cr /Applications/Maya.app then try right-click → Open again.

2. What you will see

Maya has no Dock icon and no window in the background. Maya lives in the menu bar at the top right of your screen, as a small heart.

Click that मा to:

When Maya is paused or you are in a focus session, the menu says so, with the time it ends.

Closing the main window does not quit Maya. Maya keeps running in the menu bar. Use Quit Maya to stop Maya.

3. When Maya visits

A check-in slides down from the top of your screen with one line and three buttons:

• Done ✓ — you did it. It counts towards today's summary.
• Later — Maya comes back in 30 minutes.
• 15 min — Maya comes back in 15 minutes.

If you ignore it, it disappears on its own (after 60 seconds by default) and is not saved up for later. A missed check-in is simply skipped. That is deliberate: Maya should never become a pile of guilt waiting for you.

Maya will not interrupt you:

• during quiet hours (10pm–8am by default),
• while you are in a focus session,
• while a video, slideshow or game is playing full screen,
• when you are away from the computer — and the water and stretch timers reset when you come back,
• more than 5 times a day, with at least 30 minutes between check-ins.

Meals, bedtime and battery warnings have their own timing and are not counted against that limit. A nearly empty battery (5%) will reach you even during a presentation, because by then it matters more.

4. Making Maya yours

Open Maya → Personalize:

• Language — English, नेपाली, or Roman Nepali (Nepali written in English letters).
• Tone — Gentle, Playful, or Extra dramatic.
• What Maya calls you — babu, nani, your own name, or nothing.
• तिमी or तँ — how close Maya speaks to you (Nepali only).
• Maya's colour — the heart comes in six colours, from the classic tika red to brass, sunrise, pote green, silver and night.
• Maya's sound — a steel glass, a knock, a temple bell, a water drop, or silence.

Open Maya → Reminders to turn each reminder on or off, change its time, or write your own words for it. You can add your own reminders too. Built-in ones can be switched off but not deleted.

Open Maya → Settings:

• Daily limit and time between check-ins.
• Quiet hours.
• Presenting mode — stay silent during full-screen apps.
• Look — Notch, Floating pill, or Automatic (see below).
• Show on — the screen you are working on, or your main screen.
• Hide a check-in after — how long Maya waits before slipping away.
• Home time zone and call window — so "call home" never suggests 3am in Nepal.

5. The notch

On a MacBook with a notch, Maya emerges from around the notch, as though leaning over it.

Macs with a notch: MacBook Pro 14" and 16" (2021 and later), MacBook Air 13" and 15" (M2, 2022 and later), and the MacBook Pro models after them.

On any other Mac — an iMac, a Mac mini with an external screen, a MacBook Air M1, an older MacBook Pro — there is no notch, so Maya appears as a floating pill just under the menu bar instead.

If you prefer the notch look anyway, choose Settings → Look → Notch and Maya will draw one. Automatic uses the real notch when your Mac has one and the pill when it does not.

6. Notifications — please read

Maya's normal way of reaching you is the check-in card at the top of the screen.

There is also a Backup notification setting. If the card cannot be put on screen for any reason, Maya sends a normal Mac notification instead, so a check-in is never lost in silence.

On current macOS, this backup does not work yet in this build. macOS only allows notifications from apps signed with an Apple Developer certificate, and Maya is not signed yet. If you press Send a test notification in Settings, it will tell you it was blocked. That is expected and nothing is broken — the check-in card itself works normally.

This will start working, with no change from you, in the first signed release.

7. Start Maya with your Mac

Settings → Open at login. Maya then appears in the menu bar every time you log in.

If you move Maya.app to a different folder after switching this on, turn it off and on again so macOS learns the new location.

8. Where your things are kept

Everything stays on your Mac, in this folder:

~/Library/Application Support/np.maya.app/

To open that folder: in Finder press ⇧⌘G and paste the path above.

Maya makes no network connections. Maya never reads your keystrokes, your screen, your microphone, or the titles of your windows. To know whether you are at the computer Maya asks macOS one question — how long since the last key or mouse movement — and to stay quiet during videos Maya asks whether a window is filling the screen. Nothing is recorded about what that window is.

Settings → Copy settings as JSON puts a copy of your settings and reminders on the clipboard.

To remove Maya completely: quit Maya, drag Maya.app to the Bin, then delete the folder above.

9. When something is wrong

Maya never appears. Check the menu bar for the मा. If it is missing, Maya is not running — open Maya from Applications. If Maya is running, click मा → Preview a nudge. If the preview appears but real check-ins never do, you may be paused, in quiet hours, or at the daily limit — open Maya and look at Today.

Maya appeared once and never again. There is a minimum gap between check-ins (30 minutes by default) and a daily limit (5). Both are in Settings.

Maya interrupts at bad times. Turn on Presenting mode, widen quiet hours, or lower the daily limit. For one-off cases, use Pause reminders in the menu.

Nothing works and you want to report it. Open the folder in section 8 and send maya.log. It contains only timestamps, which reminder fired and window positions — never what you typed or what was on screen.

10. Which Macs are fully supported