### Install icalPal using RubyGems Source: https://github.com/ajrosen/icalpal/blob/main/README.md Installs the icalPal gem for all users on the system. This command requires administrative privileges. ```bash gem install icalPal ``` -------------------------------- ### Install icalPal using Homebrew Source: https://github.com/ajrosen/icalpal/blob/main/README.md Installs icalPal using the Homebrew package manager. This involves tapping a custom repository and then installing the formula. ```bash brew tap ajrosen/tap brew install icalPal ``` -------------------------------- ### Get Help and Debug icalPal CLI Source: https://context7.com/ajrosen/icalpal/llms.txt Access help documentation, check the version, and enable debug logging for troubleshooting. The CLI supports various debug levels and provides examples of abbreviated options for common commands. ```bash # Show help icyPal --help # Show version icyPal --version # Enable debug logging icyPal events --debug debug --days 7 # Available debug levels: debug, info, warn, error, fatal icyPal events --debug info --days 7 # Abbreviated options (unique prefix) icyPal -c ev --da 3 # Same as: icalPal -c events --days 3 icyPal ev --fr today --to +7 # Same as: icalPal events --from today --to +7 ``` -------------------------------- ### Install icalPal for the current user using RubyGems Source: https://github.com/ajrosen/icalpal/blob/main/README.md Installs the icalPal gem only for the current user. This is useful for avoiding the need for administrative privileges. ```bash gem install --user-install icalPal ``` -------------------------------- ### Output Data in JSON, CSV, XML, YAML, HTML, Markdown (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Shows how to export calendar and reminder data using icalPal in various formats including JSON, CSV, XML, YAML, HTML, and Markdown. It also includes examples of piping JSON output to `jq` for further processing. ```bash # Events as JSONicalPal events --from today --days 7 -o json # Pretty-printed output (pipe to jq)icalPal events --from today --days 7 -o json | jq '.' # Extract specific fieldsicalPal events --from today --days 7 -o json | jq '.[] | {title, datetime, location}' # Events as CSVicalPal events --from today --days 30 -o csv > events.csv # Tasks as CSV with all propertiesicalPal tasks -o csv --iep all # XML formaticalPal events --from today --days 7 -o xml # YAML formaticalPal calendars -o yaml # HTML formaticalPal events --from today --days 7 -o html # Markdown formaticalPal events --from today --days 7 -o md # Remind format (for remind calendar program)icalPal events --from today --days 30 -o remind > ~/.remind/calendar # Hash format (Ruby hash representation)icalPal events --from today -o hash # ANSI colored outputicalPal events --from today -o ansi ``` -------------------------------- ### List Calendars and Accounts (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Demonstrates how to list all calendars and accounts (stores) from enabled accounts using icalPal. It covers showing all properties, filtering by account, and specifying output formats like JSON and YAML. ```bash # Show all calendarsicalPal calendars # Show all calendar propertiesicalPal calendars --iep all # Show calendars in JSON formaticalPal calendars -o json # Show calendars from a specific accounticalPal calendars --is "iCloud" # Show all accountsicalPal accounts # Using aliasicalPal stores # Show account details in YAML formaticalPal accounts -o yaml --iep all ``` -------------------------------- ### List enabled Calendar accounts with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Fetches and displays a list of all enabled Calendar accounts configured on the system. This command can also be run as 'icalPal stores'. ```bash icalPal accounts ``` -------------------------------- ### Configure icalPal with Files and Environment Variables Source: https://context7.com/ajrosen/icalpal/llms.txt Set default options for icalPal using a configuration file or environment variables. Users can specify custom config file locations, ignore existing configurations, or use environment variables to pass arguments. ```bash # Default config file location: ~/.icalpal # Example config file contents: # --days 7 # --sd # --df %Y-%m-%d # --ec Birthdays # Specify custom config file icyPal events --cf /path/to/config # Ignore environment variables and config file icyPal events --norc --days 7 # Environment variable usage export ICALPAL="--days 7 --sd --color" icyPal events # Config file via environment variable export ICALPAL_CONFIG="/path/to/icalpal.conf" icyPal events ``` ```bash # Use custom Calendar database icyPal events --db "/path/to/Calendar.sqlitedb" --days 7 # Use custom Reminders database directory icyPal tasks --db "/path/to/Stores" ``` -------------------------------- ### List all reminders with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Displays all reminders, including dated and undated tasks. This command is a general-purpose reminder listing tool. ```bash icalPal reminders ``` -------------------------------- ### Format and Sort Output with icalPal CLI Source: https://context7.com/ajrosen/icalpal/llms.txt Customize the grouping, sorting, and date/time formatting of icalPal output. Options allow separation by calendar or date, sorting by various properties, and applying custom date and time formats using strftime patterns. ```bash # Separate by calendar icyPal events --sc --days 7 # Separate by date icyPal events --sd --days 7 # Separate by any property icyPal events --sep "calendar" --days 7 icyPal tasks --sep "priority" icyPal tasks --sep "list_name" # Sort by property icyPal events --sort "title" --days 7 icyPal tasks --sort "due_date" # Sort tasks by due date icyPal tasks --std # Sort tasks by due date (ascending) icyPal tasks --stda # Reverse sort order icyPal events --sort "datetime" -r --days 7 # Show empty dates when separating by date icyPal events --sd --sed --days 7 # Separate by priority icyPal tasks --sp ``` ```bash # Custom date format icyPal events --df "%Y-%m-%d" --days 7 # Custom time format icyPal events --tf "%H:%M" --days 7 # ISO 8601 style icyPal events --df "%Y-%m-%d" --tf "%H:%M:%S" --days 7 # Verbose date format icyPal events --df "%A, %B %-d, %Y" --days 7 ``` ```bash # Custom bullet character icyPal events -b ">" --days 7 # Custom alert bullet icyPal events --ab "!" --days 7 # No bullets icyPal events --nb --days 7 # Enable ANSI colors (8-color) icyPal events -f --days 7 # Enable extended color palette (24-bit) icyPal events --color --days 7 # Limit number of items displayed icyPal events --li 10 --days 30 # Custom newline replacement in notes icyPal events --nnr " | " --days 7 ``` -------------------------------- ### List Calendar Events with Date Filtering (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Demonstrates how to list calendar events using icalPal, with options for filtering by date, time, and event type (all-day vs. regular). It covers showing events for today, the next 7 days, currently happening events, and custom date ranges. ```bash # Show all events for todayicalPal eventsToday # Show events for the next 7 daysicalPal eventsToday+7 # Show events currently happeningicalPal eventsNow # Show remaining events for today (from now until midnight)icalPal eventsRemaining # Show events with custom date rangeicalPal events --from today --to +14 # Show events from a specific dateicalPal events --from "2024-01-15" --days 30 # Exclude all-day eventsicalPal events --from today --days 7 --ea # Include only all-day eventsicalPal events --from today --days 7 --ia ``` -------------------------------- ### Match Field Content with Regex (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Demonstrates using regular expressions with icalPal to filter events and tasks based on the content of specific fields like notes, title, or location. This allows for precise matching of data. ```bash # Show only Zoom meetingsicalPal events --match "notes=zoom.us" --days 7 # Show events with specific title patternicalPal events --match "title=Team Meeting" --days 30 # Show tasks with specific tagsicalPal tasks --match "location=Office" ``` -------------------------------- ### List Tasks/Reminders with Filtering (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Shows how to list tasks and reminders from the macOS Reminders app using icalPal. It includes options for filtering by completion status, due dates, and reminder lists, as well as using the 'reminders' alias. ```bash # Show all uncompleted tasksicalPal tasks # Show tasks with a due dateicalPal datedTasks # Show tasks without a due dateicalPal undatedTasks # Show tasks due before a specific dateicalPal tasksDueBefore --to "2024-12-31" # Include completed remindersicalPal tasks --id # Show only completed remindersicalPal tasks --id --ed # Using 'reminders' aliasicalPal remindersicalPal datedRemindersicalPal undatedReminders ``` -------------------------------- ### Filter Events/Tasks by Account, Calendar, or Type (Bash) Source: https://context7.com/ajrosen/icalpal/llms.txt Illustrates how to filter calendar events and reminders using icalPal based on account names, calendar names, or calendar types. It also shows how to filter reminders by specific lists. ```bash # Include only specific accountsicalPal events --is "iCloud,Work" --days 7 # Exclude specific accountsicalPal events --es "Birthdays" --days 7 # Include only specific calendarsicalPal events --ic "Personal,Work" --days 7 # Exclude specific calendarsicalPal events --ec "Holidays" --days 7 # Filter by calendar type (Local, Exchange, CalDAV, MobileMe, Subscribed, Birthdays, Reminders)icalPal events --it "CalDAV,Exchange" --days 7 # Exclude specific calendar typesicalPal events --et "Subscribed,Birthdays" --days 7 # Filter reminders by listicalPal tasks --il "Shopping,Work" # Exclude reminder listsicalPal tasks --el "Completed Items" ``` -------------------------------- ### Control Event/Task Properties with icalPal CLI Source: https://context7.com/ajrosen/icalpal/llms.txt Manage which properties are displayed in the output for events and tasks. Options include including specific properties, listing all available properties, excluding certain properties, adding properties to the default list, or showing all properties. ```bash # Show only specific properties icyPal events --iep "title,datetime,location" --days 7 # List all available properties icyPal events --iep list # Exclude specific properties icyPal events --eep "notes,attendees" --days 7 # Add properties to the default list icyPal events --aep "url,uid" --days 7 # Show all properties icyPal events --iep all --days 7 ``` ```bash # Show task with extended properties icyPal tasks --iep "title,notes,due,priority,tags,assignee,section,group" # Show notification-related properties icyPal tasks --aep "alert,location,proximity,radius,messaging" # Show completion status icyPal tasks --id --aep "completed" # Show grocery list status icyPal tasks --aep "grocery" ``` -------------------------------- ### List dated reminders with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Retrieves and displays only those reminders that have a specific due date set. This command filters out undated tasks. ```bash icalPal datedTasks ``` -------------------------------- ### Query events within a date range with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Fetches events that fall within a specified date range. The '--from', '--to', and '--days' options control the time window for the query. ```bash icalPal --days 7 ``` -------------------------------- ### Filter reminders by list with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Filters the output to include only reminders from a specific reminder list. The '--il' option specifies the list name. ```bash icalPal --il "To Do List" ``` -------------------------------- ### Output events in JSON format with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Retrieves calendar events and formats the output as a JSON string. The '-o JSON' option specifies the desired output format. ```bash icalPal -o JSON ``` -------------------------------- ### Include completed reminders with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Modifies the reminder query to include tasks that have already been marked as completed. The '--id' option enables this. ```bash icalPal --id ``` -------------------------------- ### Include only all-day events with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Filters events to show exclusively all-day events. The '--ia' option ensures that only events spanning the entire day are displayed. ```bash icalPal --ia ``` -------------------------------- ### Filter events by Calendar type with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Filters the output to include only events from calendars of a specified type (e.g., Local, Exchange, CalDAV). The '--it' option specifies the type. ```bash icalPal --it Exchange ``` -------------------------------- ### Filter events by notes containing 'zoom.us' with icalPal Source: https://github.com/ajrosen/icalpal/blob/main/README.md Filters events to show only those where the 'notes' field matches the regular expression 'zoom.us'. This is useful for finding specific types of meetings. ```bash icalPal --match notes=zoom.us ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.