🌐 Language / 언어 / 言語
English • 한국어 • 日本語
Christmas Desktop Buddy is a cute desktop companion app for macOS that brings Christmas spirit to your screen! A charming character lives on your desktop, delivering time-based messages and collecting scattered gift boxes.
🤖 100% Vibe Coded with Claude Code
This entire project was created through vibe coding with Claude Code - Anthropic's official CLI for Claude. From concept to implementation, every line of code was generated through natural conversation with AI.
⛄ Snowman • 🎅 Santa • 🦌 Rudolph
| Feature | Description |
|---|---|
| 💬 Time-based Messages | Receive different cute messages based on the time of day (morning, lunch, afternoon, evening, night) |
| 🎁 Gift Box Collection | Scatter gift boxes across the screen and watch your character collect them |
| 💃 Idle Animation | Characters move and breathe like they're alive |
| 😵💫 Dizzy Reaction | Drag the character for too long and they'll get dizzy! |
| 🔋 Battery Alert | Get notified when your battery is low |
| ❄️ Animated Menu Bar | Watch snow fall on the Christmas tree in your menu bar |
| 🎭 Multiple Characters | Choose between Snowman, Santa, and Rudolph |
| 💭 Random Greetings | Character randomly says hello every 15-30 minutes |
| 🌨️ Snow Effect | Beautiful snow falling effect across ALL connected monitors |
| 🖥️ Multi-Monitor Support | Automatically adapts when displays are connected/disconnected or resolution changes |
- Download the DMG file from the link above
- Open the DMG and drag the app to your Applications folder
- Right-click the app → Select "Open" → Click "Open" in the dialog
- Use the 🎄 icon in the menu bar to change characters and settings
Note: Since the app is not code-signed, macOS blocks it by default. Right-click → Open bypasses this for unsigned apps. You only need to do this once.
- macOS 13.0 (Ventura) or later
- Apple Silicon & Intel supported
# Clone the repository
git clone https://github.com/chattymin/ChristmasBuddy.git
cd ChristmasBuddy
# Build the app
./build_app.sh
# Run the app
open ChristmasDesktopBuddy.app
# Create DMG (for distribution)
./create_dmg.shChristmasDesktopBuddy/
├── Sources/
│ ├── App/ # App entry point
│ ├── Core/ # Core components
│ ├── Features/ # Feature modules
│ │ ├── InfoDisplay/ # Info display system
│ │ ├── Message/ # Message system
│ │ ├── Snow/ # Snow effect system
│ │ └── Box/ # Gift box system
│ ├── Models/ # Data models
│ └── Resources/ # Resources (SVG characters)
└── Package.swift
This project is a showcase of vibe coding - a new development paradigm where you describe what you want in natural language and AI generates the code.
Every feature in this app was created by simply describing the desired functionality to Claude Code:
- "Add a snowman character that moves around"
- "Make the character collect gift boxes"
- "Add time-based greeting messages"
- "Create an animated snow-falling tree icon for the menu bar"
- "Make snow fall on all connected monitors"
No manual coding required - just vibes! ✨
MIT License - See LICENSE for details.
- Built 100% with Claude Code by Anthropic
- Made with ❤️ for Christmas
🎄 Merry Christmas! 🎄