WeekCal

A minimal macOS menu bar calendar inspired by Itsycal.

Shows the current ISO calendar week (e.g. KW 25) in the menu bar. Click it to open a compact calendar popover with week numbers and month navigation.

Features

• Current ISO calendar week in the menu bar
• Month view with ISO week number column (Mon–Sun)
• Today highlighted
• Click a day to select it; click again to deselect
• Continuous hover marking — no dead zones when moving between days
• Month navigation — click the month title to jump back to today
• Dark Mode / Light Mode support (automatic)
• No dock icon, no calendar integration, no configuration
• Quit via right-click → "WeekCal beenden"

Requirements

• macOS 12 Ventura or later
• Xcode Command Line Tools (xcode-select --install)

Build & Install

git clone https://github.com/yourname/weekcal.git
cd weekcal
./build.sh
cp -r WeekCal.app ~/Applications/
open ~/Applications/WeekCal.app

No admin rights required.

To launch automatically at login: System Settings → General → Login Items → add WeekCal.app.

Tests

./test.sh

Unit tests cover the deterministic calendar logic in CalendarModel (ISO week grid, week numbers across year boundaries, month navigation, day selection). They use swiftc directly with a tiny hand-rolled assert harness — no XCTest or Swift Package Manager required. The script exits non-zero on any failure.

Project Structure

weekcal/
├── Sources/
│   ├── main.swift           # Entry point (5 lines)
│   ├── AppDelegate.swift    # Menu bar item, panel, click handling
│   ├── CalendarModel.swift  # ISO week logic, month navigation
│   └── CalendarView.swift   # SwiftUI calendar grid
├── Tests/
│   └── CalendarModelTests.swift  # Unit tests (calendar logic)
├── Resources/
│   └── Info.plist
├── build.sh
└── test.sh

License

MIT