# MoonCalendar

**Repository Path**: lx_Linlx-0628/moon-calendar

## Basic Information

- **Project Name**: MoonCalendar
- **Description**: Mac极简的菜单栏日历软件
- **Primary Language**: Swift
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: macOS

## README

# MenuBarCalendarNew for macOS

A clean and simple macOS menu bar calendar application with Chinese lunar calendar, solar terms, and traditional Chinese festivals.

## Features

- Displays a calendar icon in the macOS menu bar
- Shows a monthly calendar view when clicked
- Highlights the current date
- Keyboard shortcuts support
- Clean and minimalist interface design
- Supports month and year navigation
- Displays 24 solar terms and important festivals
- Click on dates to view detailed lunar information
- Festival dates are highlighted in red
- Optimized spacing and transparency
- Supports user customization settings (opacity, etc.)

## System Requirements

- macOS 11.3 or later
- Xcode 12.5 or later

## Building and Running

1. Open `MenuBarCalendarNew.xcodeproj` in Xcode
2. Select your development team (if you need to run on a real device)
3. Build and run the project (Cmd + R)

## Usage

- Click the 📅 icon in the menu bar to open the calendar
- Use the arrow buttons to navigate between months
- Click the "今天" (Today) button to return to the current date
- Click on any date to view detailed lunar information
- Click the "设置" (Settings) button to adjust opacity and other options
- Click the "退出" (Quit) button to exit the application
- Keyboard shortcuts:
  - `T`: Go to today
  - `Q`: Quit the application

## Code Structure

- `MenuBarCalendarNewApp.swift`: Application entry point and AppDelegate
- `CalendarView.swift`: Calendar interface view
- `ChineseCalendarHelper.swift`: Lunar calendar and festival calculation utility class
- `SettingsView.swift`: User settings interface
- `Info.plist`: Application configuration information
- `MenuBarCalendarNew.entitlements`: Application permission configuration

## License

MIT License