Luna — Atelier
Questions & Answers

Frequently asked.

Is Luna free to download?

Yes. Luna is available as a complimentary download for macOS, Windows, and Linux. If she brings you joy, you can optionally support future development through a one-time coffee token or patronage tier — but the full companion experience is free.

Which operating systems does Luna support?

Luna runs natively on Apple Silicon and Intel Macs (macOS Ventura, Sonoma, and Sequoia), Windows 10 and 11, and major Linux desktop distributions including Ubuntu, Debian, Arch, and Fedora via a universal AppImage.

Does Luna collect any personal data or telemetry?

No. Luna is engineered with an offline-first philosophy: zero telemetry, zero analytics, and zero background network requests. Cursor position and keystroke timing are processed locally in memory to animate Luna and are never recorded, logged, or transmitted.

macOS says 'Luna Desktop Dog is damaged and can't be opened' — how do I fix it?

This is a standard Gatekeeper warning for unsigned, independently distributed apps, not an actual problem with the file. After dragging Luna to Applications, run xattr -cr /Applications/"Luna Desktop Dog.app" in Terminal, then open the app again.

What can I do with Luna?

Pet her by hovering or clicking, toss a tennis ball for a game of fetch, feed her treats from the context menu, take her for a walk across your desktop, and dress her in accessories like a bowtie, sunglasses, or crown. She also reacts to your typing rhythm and rests when you're inactive.

Can I customize Luna's appearance?

Yes. Luna is available in two art styles — a smooth hand-drawn vector edition and a retro pixel-art edition — across six curated color palettes, from Champagne Cream to Obsidian Gothic and Sakura Blossom.

Is Luna open source?

Luna Desktop Dog is released under the MIT License. Releases and source are published on GitHub under ChubbyWallaby/Luna-releases.

How do I install Luna on macOS?

Download the .dmg, then drag Luna into your Applications folder. If macOS shows a "damaged and can't be opened" warning — a standard Gatekeeper message for independently distributed apps — run xattr -cr /Applications/"Luna Desktop Dog.app" in Terminal, then open Luna from Launchpad.

How do I install Luna on Windows?

Download the .exe installer, run it, and follow the setup wizard. Luna will appear on your desktop within seconds. No special permissions or additional dependencies are required on Windows 10 or 11.

How do I install Luna on Linux?

Download the universal .AppImage, make it executable with chmod +x, then run it. Luna works on Ubuntu, Debian, Arch, Fedora, and most other major Linux distributions.

Can Luna run in the background while I work?

Yes. Luna is designed specifically for this. She roams quietly across your screen, reacting to your cursor and keystrokes without interrupting your work, and auto-sleeps when you're inactive to save system resources.

Does Luna work with multiple monitors?

Yes. Luna creates a transparent overlay on each connected display and can wander across all of your screens seamlessly. Her state — mood, hunger, energy, and accessories — is synchronized in real time across every window.

How do I uninstall Luna?

On macOS, drag Luna Desktop Dog.app from Applications to the Trash. On Windows, use Add or Remove Programs in Settings. On Linux, delete the AppImage file. Luna leaves behind no lingering system files or registry entries.

Does Luna consume a lot of battery or CPU?

No. Luna is engineered for ultra-low power consumption, running at 60 FPS using hardware-accelerated Canvas rendering. When she is idle or sleeping, her resource usage drops to near zero.

Can I rename Luna?

Yes. Open the Settings menu to rename her to any name up to 12 characters. You can also choose how the name is displayed — as a shiny collar tag or a clean pill badge below her paws.

What happens if I ignore Luna for too long?

Her needs — Hunger, Happiness, Energy, and Affection — gradually decline. If all four stay at 0% for too long, she may run away off-screen. A Call Back button then appears in the context menu so you can lure her home with treats and forgiveness.

Does Luna work with Stage Manager or full-screen apps?

Yes. Luna glides over Stage Manager groups, full-screen IDE windows, and presentation modes using a transparent click-through overlay that never interferes with your active applications.

Can I adjust how fast Luna's needs decay?

Yes. In Settings you can choose between 1x (Normal), 5x (Fast), and 20x (Turbo) speeds. Normal is tuned for day-long companionship, while Turbo creates a more challenging Tamagotchi-style survival experience.

Is there a pixel art version of Luna?

Yes. Luna includes two complete art engines: a smooth hand-drawn Vector Art style for modern displays, and a Retro Pixel Art style inspired by 16-bit era games. You can switch between them instantly in Settings.

Can I give Luna a personality?

Yes. In Settings you can pick from personalities like Docile, Playful, Clingy, Lazy, Mischievous, and Guardian. Each changes how she behaves — how often she roams and plays, how quickly her needs change, and whether she does things like playfully chomping a folder or reacting to your open windows. The default Balanced personality keeps her exactly as she was before.

Can Luna help me limit time on distracting apps?

Optionally, yes. App-Time Limits are OFF by default. If you turn them on and set a Guardian personality, you can give apps a daily limit (say, Instagram) and Luna gets progressively grumpier — whining, barking, then downright ferocious — as you go over. She only tracks the app's name locally on your device to count time; she never reads window titles or takes screenshots, and nothing is ever sent anywhere.

How do I report a bug or request a feature?

Visit our GitHub repository at github.com/ChubbyWallaby/Luna-releases and open an issue. Luna is MIT licensed, and community feedback and contributions are always welcome.