# Install ical-buddy with Homebrew

Get events and tasks from the macOS calendar database. Version 1.10.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:ical-buddy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ical-buddy
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:ical-buddy
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ical-buddy>
- **Version:** 1.10.1
- **Source summary:** Get events and tasks from the macOS calendar database
- **Homepage:** <https://hasseg.org/icalBuddy/>
- **Repository:** <https://github.com/dkaluta/icalBuddy64>
- **Upstream docs:** <https://hasseg.org/icalBuddy>
- **License:** MIT
- **Source archive:** <https://github.com/dkaluta/icalBuddy64/archive/refs/tags/v1.10.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- icalBuddy (cli)
- icalBuddy (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.10.1
- Local data: ok
- Upstream repository: https://github.com/dkaluta/icalBuddy64
- Upstream latest detected: v1.10.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

icalBuddy is a macOS command-line utility for reading events and tasks from the Calendar database used by iCal/Calendar. It occupies a small but durable niche in Mac automation: turning personal calendar data into scriptable terminal output.

### Project history

Ali Rantakari published icalBuddy as a native OS X command-line tool and documented it with a homepage, examples, FAQ, and manual pages. The author's usage text identifies the program as version 1.8.8 and gives a 2008-2012 copyright range, while the page's version log records 1.8.8 on March 09, 2013.

After the original project line, Homebrew tracks a maintained 64-bit continuation from the `dkaluta/icalBuddy64` repository, with tags that extend the release sequence beyond the original 1.8.x series. The package therefore represents both the original Mac automation tool and the later packaging work needed to keep it usable on newer macOS systems.

### Adoption history

The original site explicitly points users to examples, manual pages, configuration and localization manuals, and a blog post about displaying icalBuddy output on the desktop, showing adoption among users who wanted calendar data in scripts, widgets, and status displays.

Homebrew packaging made the tool installable as `ical-buddy`, preserving access for command-line Mac users even though the tool is platform-specific and depends on macOS calendar APIs.

### How it is used

The command set includes date-bounded event queries, task queries, calendar listing, custom formatting, calendar inclusion/exclusion, property selection, config editing, and localization support. Typical uses are shell scripts, desktop overlays, status bars, and other local automations that need Calendar data without opening the Calendar app.

### Why package nerds care

icalBuddy is a classic Homebrew-only productivity formula: small, Mac-specific, script-friendly, and tied to private Apple frameworks rather than a cross-platform ecosystem. Its significance is less about broad portability and more about exposing a GUI application's data model to Unix-style pipelines.

### Timeline

- 2008-2012: Original usage text carries Ali Rantakari's copyright range.
- 2010-2013: The author's changelog records frequent 1.7.x and 1.8.x releases with relative dates, localization, installer, and macOS compatibility fixes.
- 2013: Version 1.8.8 appears in the author's changelog.
- 2019-2021: The `icalBuddy64` continuation tags versions from 1.8.9 through 1.10.1 for maintained Homebrew builds.

### Related projects

- The project is related to Apple's iCal/Calendar database, Ali Rantakari's CalStoreHelper, and Mac desktop/status-display automation that consumes terminal output.

### Sources

- <https://formulae.brew.sh/formula/ical-buddy>
- <https://github.com/dkaluta/icalBuddy64>
- <https://hasseg.org/icalBuddy>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ical-buddy
- **Version Scheme:** 0
- **Revision:** 1
- **Head Version:** HEAD
- **Requirements:** macos
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [calcurse](https://www.automicvault.com/pkg/brew/calcurse/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [ccal](https://www.automicvault.com/pkg/brew/ccal/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [ddate](https://www.automicvault.com/pkg/brew/ddate/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [gcalcli](https://www.automicvault.com/pkg/brew/gcalcli/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [hebcal](https://www.automicvault.com/pkg/brew/hebcal/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [jcal](https://www.automicvault.com/pkg/brew/jcal/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [khal](https://www.automicvault.com/pkg/brew/khal/) - Shares av.db curated category or tags: calendar, cli, productivity.
- [pcal](https://www.automicvault.com/pkg/brew/pcal/) - Shares av.db curated category or tags: calendar, cli, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/ical-buddy.yml](https://github.com/automic-vault/db/blob/main/combined/ical-buddy.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
