A tiny home for pixel pets

Guk! Meong!
Your notch has residents now.

Gukmeong turns the MacBook notch into a little neighbourhood. Pixel dogs and cats stroll beside the camera, hop through two glowing portals, nod along to your music and keep an eye on your battery. Pat them and hearts drift down your screen.

Gukmeong, say gook-meh-ong: a dog's guk and a cat's meong, the way you'd hear them in Indonesia.

Version 0.1.0 macOS 14+ · Apple Silicon MacBook with a notch Free · MIT

Try it right here

The same sprites and numbers as the app, redrawn in your browser. Click a pet to pat it, or pick a state.

Pixel pets walking on both sides of a MacBook notch.

Your pets

    What lives in your notch

    On the open notch, a shiba fetches a bouncing ball while a cat watches

    Pets and portals

    Up to six dogs and cats, each with a name. They wander, sit, yawn, groom and nap at night, meet each other (a sniff, a chase, a slap and a dash through the portal) and come when you throw a ball. Press and hold to pick one up.

    Album art and a pixel sound wave in the notch, with two pets peeking out of the portals

    Music in the notch

    Album art and a pixel sound wave while a song plays; point at the camera for the track, progress and play, pause and skip, plus synced lyrics if you want them. Works with the players you already use.

    Charging, 40 percent, with a pixel battery

    Charging at a glance

    Plug in and a little pixel plug slides into the battery: level, charging or on hold, and time until full or left.

    Light on your Mac

    One drawing clock for everything that moves: 30 frames a second while the pets are up, 15 in Low Power Mode or on a low battery, 4 when they all sleep, and nothing while the notch is hidden.

    Private by design

    No accounts, no analytics, no tracking. The only network request is one you can turn on: synced lyrics for the playing song, from the open LRCLIB service.

    Open source

    MIT licensed, built with Swift and no third-party packages. Read the code, build it yourself, or send a fix on GitLab.

    Install

    1. Download and drag

      Open Gukmeong.dmg and drag Gukmeong into Applications.

    2. Open it the first time

      Gukmeong isn't notarized by Apple yet (that needs a paid developer account), so macOS blocks the first launch. Right-click Gukmeong in Applications and choose Open, then Open again. Or open it once, then go to System Settings → Privacy & Security and click Open Anyway.

      Prefer Terminal? This removes the download flag instead:

      xattr -dr com.apple.quarantine /Applications/Gukmeong.app
    3. Meet your pets

      A paw appears in the menu bar: add pets, rename them, open Settings or quit from there. Point at the camera to open the notch.

    Questions

    Is it safe?

    The whole app is open source, so you (or someone you trust) can read every line and build it yourself. It collects nothing and makes no network requests unless you turn on lyrics (then it asks LRCLIB for the song you're playing). macOS warns about it only because it isn't notarized, which costs a yearly Apple fee; the warning isn't about anything the app does.

    Why isn't it on the App Store?

    Since macOS 15.4 apps can't read what's playing through public APIs. Gukmeong uses an open-source helper (mediaremote-adapter) that relies on a private Apple framework, which the App Store doesn't allow. Everything else uses public APIs only, and if a future macOS breaks the helper, Gukmeong falls back to asking Spotify and Music directly.

    What about Macs without a notch?

    On a screen without a notch, Gukmeong shows a small floating pill at the top centre instead, and the pets live beside that. It's made for notched MacBooks, though, where the portals hide the camera.

    Does it make sounds?

    Only if you want: turn on Settings → Sounds and a patted dog says "guk", a cat "meong". The voices are tiny chiptunes the app synthesises itself; there are no recordings.

    How do I uninstall it?

    Quit it from the paw menu (turn off Launch at login first if you enabled it) and delete Gukmeong from Applications. Its settings and last played track can go too:

    defaults delete com.zaidanzulhakim.gukmeong; rm -rf ~/Library/Application\ Support/com.zaidanzulhakim.gukmeong