Files
iceglass/README.md
T
rzen 8f8f8b2755 Initial commit: IceGlass NHL game tracker
macOS menu bar app providing NHL game situational awareness with
league-wide scoreboard, dynamic polling, notifications with team
logos, and configurable display options.
2026-04-13 21:44:08 -04:00

37 lines
1.3 KiB
Markdown

# IceGlass
A macOS menu bar app for NHL game situational awareness.
## Key Features
- NHL shield icon in the menu bar with game count
- Shows games from yesterday, today, and tomorrow grouped by date (configurable)
- Game format: `NYR @ WAS 0:2 (FINAL)` / `DAL @ TOR Today @ 7:30 PM`
- Click a game to open NHL GameCenter; option-click for NHL Videocast
- Goal scored notifications with scoring team logo
- Game start notifications on FUT→LIVE state transition
- Dynamic polling: 7s during live games, scales back when idle
- Display Options: choose which days to show (yesterday/today/tomorrow)
- Refresh Now (⌘R) for immediate updates
- Launch at Login support
- About window via IndieAbout
## Building
Requires XcodeGen to generate the project:
```bash
xcodegen generate
xcodebuild -scheme IceGlass -configuration Debug build
```
## Architecture
Menu bar app using singleton services pattern:
- **MainService** — polls NHL scoreboard API, manages game data
- **MenuManager** — builds dropdown menu with date-grouped games
- **StatusItemManager** — manages menu bar icon
- **NotificationManager** — game start and goal scored notifications with team logos
Uses the NHL Web API (`api-web.nhle.com/v1/scoreboard/now`) for league-wide schedule and score data.