Improve README

This commit is contained in:
Trevor Vallender 2024-03-04 09:50:46 +00:00
parent b7ae662fc9
commit 4897d81741
1 changed files with 34 additions and 0 deletions

View File

@ -2,3 +2,37 @@
Birthdaze is a tool to generate a calendar of your contacts birthdays
from a CardDAV server account.
## Installation
```bash
gem install ruby
```
Note Birthdaze relies on the `curb` gem, which requires `libcurl4-openssl-dev` to be installed.
## Setup
Youll need a config file in the `~/.config/birthdaze.yaml` that looks like the below:
```yaml
username: <username>
password: <password>
url: <url>
ical_output: <path to output file>
```
## Usage
Print a list of all birthdays.
```bash
birthdaze list
```
Generate an iCalendar file of your contacts birthdays.
## Notes
- If a contact has a birthdate, the birthday will be set as recurring from that year. Otherwise,
it will be set as recurring from the current year.