olfuerniss / byrthdays

Command line tool for macOS to extract people with birthdays from your contacts

byrthdays

About

Command line tool for macOS to list people with birthdays from your contacts either human readable or as JSON / XML / CSV.

Install

Homebrew

Not allowed to publish it at the moment. :-(

> brew audit --new-formula byrthdays
byrthdays:
* GitHub repository not notable enough (<20 forks, <20 watchers and <50 stars)
* GitHub repository too new (<30 days old)
Error: 2 problems in 1 formula

Manual installation

1. Go to Releases and download the latest release
2. Unzip and place the byrthdays binary in /usr/local/bin or any other folder that is in your path

Usage

> byrthdays -h

Byrthdays is a tool to list people with birthdays from your macOS contacts.

Usage:
  byrthdays [-d <days>] [-o <pretty|json|xml|csv>] [-t <size>] [-g]

Options:
  -d  extract only birthdays within the given number of days (default 14; -1 for all)
  -o  to set the output format. Can be either 'pretty', 'json', 'xml' or 'csv' (default 'pretty')
  -t  to set the maximum thumbnail width/height of the contact images. It only prints the base64 encoded thumbnail data (PNG) when this option is used
  -g  to create grayscale thumbnails. Only in combination with '-t'
  -h  prints this help

byrthdays v1.0.8
Oliver Fürniß, 07/07/2018
Website: https://github.com/olfuerniss/byrthdays

I use the JSON output in my byrthdays widget for Übersicht. Could also be used in Alfred workflows or menu bar apps like BitBar.