Installation
Install globally with npm:
npm install -g calendarmap-cli
Verify installation:
calendarmap --version
Basic Usage
1. Generate mapping from your CSV headers:
calendarmap guess --schema calendar-ics < events.csv > mapping.json
2. Convert CSV to ICS using the mapping:
calendarmap map --schema calendar-ics --mapping mapping.json < events.csv > calendar.ics
Alternative: Use files instead of pipes:
calendarmap guess --schema calendar-ics --input events.csv --output mapping.json
calendarmap map --schema calendar-ics --mapping mapping.json --input events.csv --output calendar.ics
Commands
guess
Auto-detect CSV columns and generate mapping file
map
Convert CSV to ICS using field mapping
validate
Check CSV data for issues before conversion
Examples
Conference Schedule
# Convert conference sessions to calendar
calendarmap guess --schema calendar-ics < conference.csv > conf-mapping.json
calendarmap map --schema calendar-ics --mapping conf-mapping.json < conference.csv > conference2025.ics
Team Calendar with Validation
# Process team events with validation
calendarmap guess --schema calendar-ics --input team-events.csv --output team-mapping.json
calendarmap validate --schema calendar-ics --mapping team-mapping.json --input team-events.csv
calendarmap map --schema calendar-ics --mapping team-mapping.json --input team-events.csv --output team.ics
Batch Processing Script
#!/bin/bash
# Convert all CSV files in directory
for file in *.csv; do
name=$(basename "$file" .csv)
calendarmap guess --schema calendar-ics < "$file" > "$name-mapping.json"
calendarmap map --schema calendar-ics --mapping "$name-mapping.json" < "$file" > "$name.ics"
done
Why Use the CLI?
- •Automation
Integrate into scripts and workflows
- •Batch Processing
Convert multiple CSV files at once
- •Large Files
No size limits on CSV files
- •Privacy
All processing happens locally
Ready to get started?
Install the CLI tool and start converting your CSV files to calendar format
npm install -g calendarmap-cli