99 lines
2.1 KiB
Markdown
99 lines
2.1 KiB
Markdown
# Calendar 📅
|
|
|
|
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
|
|
|
|
## Features
|
|
|
|
- Create events
|
|
- Schedule meetings
|
|
- Set reminders
|
|
- View availability
|
|
- Recurring events
|
|
- Calendar sync
|
|
|
|
## Supported Providers
|
|
|
|
- Google Calendar
|
|
- Apple Calendar (iCloud)
|
|
- Work/Corporate Calendars
|
|
|
|
## Quick Start
|
|
|
|
### Setup Google Calendar
|
|
```bash
|
|
export CALENDAR_TYPE=google
|
|
./cal.sh list
|
|
```
|
|
|
|
### Setup iCloud Calendar
|
|
```bash
|
|
export CALENDAR_TYPE=icloud
|
|
export CALENDAR_ICLOUD_ID='Anthony@martinwa.org'
|
|
export CALENDAR_ICLOUD_PASS='mvas-vwsk-ktiv-anex'
|
|
./cal.sh list
|
|
```
|
|
|
|
### Setup Work/Corporate Calendar
|
|
```bash
|
|
export CALENDAR_TYPE=work
|
|
export CALENDAR_WORK_EMAIL='your@email.com'
|
|
export CALENDAR_WORK_URL='https://your-calendar-server.com/calendars'
|
|
./cal.sh list
|
|
```
|
|
|
|
## Usage Examples
|
|
|
|
**View today's events:**
|
|
```bash
|
|
./cal.sh today
|
|
```
|
|
|
|
**View this week's agenda:**
|
|
```bash
|
|
./cal.sh agenda --days 7
|
|
```
|
|
|
|
**Schedule a meeting:**
|
|
```bash
|
|
./cal.sh create "Team Sync" "2026-02-05 10:00" "2026-02-05 11:00"
|
|
```
|
|
|
|
## Multiple Calendar Support
|
|
|
|
Now supports **multiple calendar sources**! Once configured, you can view events from all calendars or filter by type.
|
|
|
|
### Using iCloud
|
|
```bash
|
|
# Your credentials are already set:
|
|
export CALENDAR_TYPE=icloud
|
|
export CALENDAR_ICLOUD_ID='Anthony@martinwa.org'
|
|
export CALENDAR_ICLOUD_PASS='mvas-vwsk-ktiv-anex'
|
|
|
|
# View your iCloud calendar
|
|
./cal.sh today
|
|
|
|
# Or view combined with Google (if you add it later)
|
|
# Switch back to Google:
|
|
# unset CALENDAR_TYPE
|
|
# ./cal.sh today
|
|
```
|
|
|
|
### Using Work Calendar
|
|
```bash
|
|
# Set up your work calendar:
|
|
export CALENDAR_TYPE=work
|
|
export CALENDAR_WORK_EMAIL='anthony@pacificenergy.com.au'
|
|
export CALENDAR_WORK_URL='https://outlook.office365.com/EWS/Exchange.asmx'
|
|
./cal.sh today
|
|
```
|
|
|
|
### Viewing All Calendars
|
|
Want to see events from Google + iCloud + Work all at once? Ask me to combine them!
|
|
|
|
## Calendar Commands
|
|
|
|
- `./cal.sh today` - Show today's events
|
|
- `./cal.sh agenda [days]` - Show upcoming events
|
|
- `./cal.sh list` - List all configured calendars
|
|
- `./cal.sh create <title> <start> <end> [options]` - Create new event
|