🎄 Christmas Desktop Buddy

🌐 Language / 언어 / 言語
English • 한국어 • 日本語

🌐 Website • ⬇️ Download

---

✨ About

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.

🎬 Preview

⛄ Snowman • 🎅 Santa • 🦌 Rudolph

🎁 Features

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 & Installation

Download

👉 Download Latest Release

Installation Steps

1. Download the DMG file from the link above
2. Open the DMG and drag the app to your Applications folder
3. Right-click the app → Select "Open" → Click "Open" in the dialog
4. 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.

💻 System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon & Intel supported

🛠️ Build from Source

# 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.sh

📁 Project Structure

ChristmasDesktopBuddy/
├── 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

🤖 About Vibe Coding

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! ✨

📄 License

MIT License - See LICENSE for details.

🙏 Credits

• Built 100% with Claude Code by Anthropic
• Made with ❤️ for Christmas

---

🎄 Merry Christmas! 🎄