CSV-to-ICS Converter is a simple and free tool for converting text files (CSV or TSV) into ICS calendars - all in the privacy of your own computer. The basic features are very easy to use and the following sections will help get you started.
CSV-to-ICS Converter also includes some advanced capabilities which could be overlooked. This documentation will help you get the most out of CSV-to-ICS Converter.
We hope you'll find this documentation useful. If you have any ideas or suggestions on how the documentation could be improved, please let us know.
CSV-to-ICS Converter runs on Windows XP, 7, 8.x, and 10. It requires .NET Framework 4.0 or later, which is already included on most Windows installations. If you're using Windows XP, you'll need to also make sure KB2468871 has been installed.
CSV-to-ICS Converter doesn't need to be installed like a traditional Windows app. It downloads as a single file that can be run from any location you'd like, including a local drive, network folder, cloud drive, etc. It doesn't need any elevated permissions and won't modify the Windows registry or do anything else to your system.
CSV-to-ICS Converter can process text files that are formatted with comma-separated values (CSV) or tab-separated values (TSV). These files can be created in any spreadsheet editor, such as Excel. The first row can be a header, defining the field names for data in the following rows. If a header row isn't specified, you'll need to first specify how the column indices map to data fields. The Free Edition can convert files that contain 100 or fewer events (rows). The Pro and Ultimate Editions have no file size limitation.
An example CSV file is shown below:
The table below defines the default field names supported by CSV-to-ICS Converter, along with the possible field name variations. The fields can be defined in any order and the only mandatory fields are Title and Start (or Start Date and Start Time). All other fields are optional. If your fields have different names or if your file doesn't include a header row, the column mappings can be customized when using the Ultimate Edition.
Additional custom fields can also be present. The values in those fields will be processed when using the Ultimate Edition, or ignored when using the Free or Pro Editions. Custom field labels and values will appear in the event descriptions of the generated ICS file.
Software-specific extention properties, such as X-MOZ-GENERATION, can also be present. Any field name that has an X- prefix will be treated as an extension property. If a value is specified, the extension property will be included within the corresponding VEVENT of the generated ICS file. This is an advanced feature and is only supported in the Ultimate Edition.
|Title||Subject, Summary, Event||The event title text.|
|Location||Address, Room||The event location.|
|Category||Categories||The event category. If there are multiple categories, separate them with semicolons. Example: "Work; Important; Follow-up"|
|Priority||Priority Level, Importance||The event priority ("High", "Medium", "Low", or blank).|
|Description||Body, Message, Detail, Details, Notes, Memo||The event description.|
|Start||Start Date/Time, Starting Date/Time, Begin||The event starting date and time. For an all-day event, just the date is needed. The format should match the date/time format used by Windows, as specified in the Control Panel, under "Clock, Language, and Region > Change date, time, or number formats".
Use this field when you want to combine the starting date and time into a single field. If you want to separate the date and time fields, use the Start Date and Start Time fields instead.
|Start Date||Starting Date, Begin Date||The event starting date.|
|Start Time||Starting Time, Begin Time||The event starting time. Leave blank for all-day events.|
|End||End Date/Time, Ending Date/Time, Finish, Due||The event ending date and time. For an all-day event, just the date is needed. The format should match the date/time format used by Windows, as specified in the Control Panel, under "Clock, Language, and Region > Change date, time, or number formats".
Use this field when you want to combine the ending date and time into a single field. If you want to separate the date and time fields, use the End Date and End Time fields instead. If none of these fields are included, the Duration field will be used to calculate the ending date/time.
|End Date||Ending Date, Finish Date, Due Date||The event ending date.|
|End Time||Ending Time, Finish Time, Due Time||The event ending time. Leave blank for all-day events.|
|Duration||Length||The event duration. The value should be formatted as "N span", where N is a number of span is "minutes", "hours", "days", "weeks", or "months". Example: "30 minutes".
This field can be used as an alternative to the End, End Date, and End Time fields. The ending date/time will be calculated when this field is present.
|Time Zone||Timezone, Time-Zone, Timezone Name, Timezone ID, TZ, TZID||The event time zone. The value should be one of the time zone names supported by Windows, such as "Central Standard Time".
Each event can have a time zone specified. A mix of multiple time zones is supported.
If not specified, the default time zone specified in the Options will be used. Unless you've changed the default time zone option, it will be the same as the local time zone used by Windows.
|All Day||All Day Event, Entire Day, All-Day, All-Day Event||An all-day flag used for events that occur over the span of an entire day, such as birthdays and holidays.
Values that are blank, "No", or "False" will be treated as non all-day events, while values of "X", "Yes", or "True" will be treated as all-day. This format is also used by the Reminder, Recurs Daily, Recurs Weekly, Recurs Monthly, and Recurs Yearly fields.
|Free/Busy||Busy, Busy Status||The busy status of an event. This status will be generated to a X-MICROSOFT-CDO-BUSYSTATUS property in the output. Compatible software, such as Outlook, will show the event status accordingly.
Supported values are "free", "tentative", "busy", and "OOF" (out of office).
|Reminder||Popup, Popup Reminder, Popup Reminder Time, Reminder Time, Alert, Alert Time, Notification, Notification Time||The time before the event starts when a reminder should appear. If blank, there will be no reminder. Otherwise, specify the length of time as either a time of day or "N span", similar to the Duration field's format. If a time of day is specified and a date is specified in the Reminder Date field, the reminder will appear at the specified time on that date. If only a time of day is specified, the reminder will appear at the specified time on the start date of the event.|
|Reminder Date||Popup Reminder Date, Alert Date, Notification Date||The date when a reminder should appear. The Reminder Time field can be used to also specify the time of day the reminder should appear on the reminder date. Leave blank if no reminder or if the Reminder Time field is an offset (such as "15 minutes") from the event start time.|
|Required Attendees||Attendee, Attendees, Recipients, Required, To||Required attendees for a meeting request. Multiple attendees can be separated with semicolons. Attendees can be specified with a name followed by an email address (example: "John Doe <email@example.com>") or just an email address.
Note: CSV-to-ICS Converter won't automatically send a meeting notice. This will be up to the software used to import the resulting ICS file. For example, if importing into Outlook, each imported meeting will need to be opened and the Send button clicked in order to send the converted meeting notices.
|Optional Attendees||Optional, CC||Optional attendees for a meeting request, formatted the same as Required Attendees. These attendees will be on the CC line when a meeting notice is sent.|
|Organizer||Meeting Organizer, From||The meeting organizer, formatted the same as Required Attendees. If left blank, the account or profile used in the software that imports the meeting notices from the ICS file will be the meeting organizer.
If importing into Outlook, do not include an Organizer column. If the Organizer column is specified, the required and optional meeting attendees won't import.
|Recurrence||Recurrence Summary, Recurs, Repeat, Repeats||This field specifies a basic recurrence pattern for the event. The first occurrence of the series is specified by the Start field. Supported values are "Daily", "Weekly", "Monthly", and "Yearly". This field should be blank for events that don't recur.
This field can be used as an alternative to the separate Recurs Daily, Recurs Weekly, Recurs Monthly, and Recurs Yearly fields.
|Recurs Daily||Daily, Recur Daily||A flag indicating an event that recurs daily. The first occurrence and day-of-week are determined by the Start field.|
|Recurs Weekly||Weekly, Recur Weekly||A flag indicating an event that recurs weekly. The first occurrence and day-of-week are determined by the Start field.|
|Recurs Monthly||Monthly, Recur Monthly||A flag indicating an event that recurs monthly. The first occurrence and day-of-month are determined by the Start field.|
|Recurs Yearly||Yearly, Recur Yearly||A flag indicating an event that recurs yearly. The first occurrence and day-of-year are determined by the Start field.|
|Recurrence End Date||Recurrence End, Recurrence Stop Date, Recurrence Stop||The date when the specified recurrence pattern should end. No additional events will occur after the specified date. Leave blank if the event isn't recurring, doesn't have a known ending date, or if a value has been specified in the Number of Occurrences field.|
|Number of Occurrences||Max Occurrences, Maximum Occurrences, Occurrence Count, Recurrence Count, Occurrences||The maximum number of occurrences of the specified recurring series. Leave blank if the event isn't recurring, doesn't have a known number of occurrences, or if a value has been specified in the Recurrence End Date field.|
|Recurrence Interval||Recur Interval, Repeat Interval, Interval||A number indicating the interval between occurrences of the specified recurrence pattern. For example, if the recurrence pattern is daily and recurrence interval is set to 4, the recurring event will repeat every 4 days. Leave this number blank if the event isn't recurring or should repeat without an interval.|
|ID||UID, Unique ID, Key||A unique identifier for the event. Specifying unique identifiers will help ensure events aren't duplicated when importing updated ICS files into other calendar programs.|
|X-label||Software-sprecfic extension properties can be specified. These fill map directly to corresponding extension properties in the generated ICS file. Any column that begins with a X- prefix will be treated as an extension property. Example: ICS X-MOZ-GENERATION. Note, this feature requires the Ultimate Edition. Extension properties will be ignored when using the Pro or Free Edition.|
If you have column headers that don't match the column names CSV-to-ICS Converter is expecting, or if your files don't include a row header, the mapping of input columns to data fields can be customized when using the Ultimate Edition.
To map column names, make sure the box labeled Input files include a header row containing column names is checked. Next, enter your column names in the list and pick the mapped data fields from the drop-down. You don't need to override the mapping of column names that CSV-to-ICS Converter already recognizes. To delete a mapping, select the row and then press the Delete key.
If your files don't include a header row, you can map fields based on column index, where the left-most column has an index of 1. Uncheck the Input files include a header row containing column names box. Enter the column index values and select the mapped data fields from the drop-down. The index values don't need to be in any particular order and you can skip index values for columns you don't want processed. Note: processing of custom fields and extension properties won't be performed when a column header isn't present.
Column mappings and other settings, such as the folder to monitor for automatic ICS generation, can be saved using the Save Settings button, or loaded using the Load Settings button. Settings are also saved automatically, but this feature makes it possible to transfer settings from one computer to another.
You can follow these simple steps to convert a single CSV or TSV file into an ICS file:
The generated ICS file can be imported into almost any calendar app, including Google Calendar, Outlook, VueMinder, PrintableCal, and more. You can send it by email to other people, put it on a website, or do anything else you'd like with the ICS file. If you haven't purchased a license, a small note will appear in the description of the converted events, indicating the ICS file was generated using the Free Edition of CSV-to-ICS Converter. This note can be removed by upgrading to the Pro or Ultimate Edition.
If you have many files to convert, doing them one at a time might become tedious. The Ultimate Edition can convert an entire folder containing CSV/TSV files into ICS files. CSV-to-ICS Converter can run in the background and continue to monitor the specified folder. If any files are added or modified within the folder, updated ICS files will be automatically generated. This automated processing could save untold hours of performing single file conversions. It's a premium feature, but one that could easily pay for itself by freeing up your time to do other more important things.
You can follow these steps to convert an entire folder of CSV/TSV files into corresponding ICS files:
CSV-to-ICS Converter can be minimized to the notification area rather than the task bar. While minimized, it will continue to run in the background, monitoring the input folder for new or modified CSV/TSV files and generating updating ICS files as needed. To configure CSV-to-ICS Converter to be minimized to the notification area, select the Options tab and check the box labeled Minimize to notification area instead of the task bar.
To redisplay the CSV-to-ICS Converter window, click the icon in the notification area, or right-click and select Open CSV-to-ICS Converter. You can review the Log to see if and when ICS files were automatically converted while CSV-to-ICS Converter was running in the background.
If you have a website or an external server where your converted ICS files need to reside, CSV-to-ICS Converter Ultimate Edition can be configured to automatically upload your converted ICS files via an FTP server. This works just like automatically converting CSV/TSV files into ICS files in a folder, except the ICS files will be uploaded.
You can follow these steps to configure CSV-to-ICS Converter to automatically upload converted ICS files to an FTP server:
The Free Edition is free for both personal and business use. It's capable of converting CSV and TSV files into ICS files and provides more functionality than any other free converter. However, event descriptions will include a small notification stating the ICS file was generated using CSV-to-ICS Converter Free Edition. Also, files containing more than 100 events cannot be converted by the Free Edition. The Pro Edition removes the notification and file size limitation. The Ultimate Edition provides many additional features:
If you'd like to try these features before deciding whether to purchase, you can request a free trial license. The trial license will be fully-functional for 30 days and will enable you to access all the features of the Ultimate Edition. If you decide not to purchase, the trial will automatically revert back to the Free Edition at the end of the 30 days.
We'll send you a trial license key within 24 hours. After you receive the license key, you can activate your trial period by clicking the Activate license tab and pasting your key.
The Free Edition can perform standard conversions of CSV to ICS files contaning fewer than 100 events. For many people, that's all that is needed. You're welcome to use the Free Edition and we hope it will help you out.
If you need more, here's a quick comparison of the features provided in each edition:
|Convert CSV and TSV files to ICS files|
|Convert files containing more than 100 events.|
|Remove the CSV-to-ICS Converter "Free Edition" notification from event descriptions.|
|Receive technical support directly from the people who built the product|
|Convert user-defined custom fields.|
|Convert software-specific extension properties (X-prefix).|
|Monitor folders for updated CSV/TSV files and automatically generate ICS files.|
|Customize how columns in input files are mapping to data fields in output files.|
|Automatically upload ICS files to an FTP server.|
|Price (per license, in USD)||Free||$79.95
After purchasing or requesting a free trial, you'll receive an email containing a license key within 24 hours. To activate your license, start CSV-to-ICS Converter, click the Activate tab, and paste your license key in the space provided. After entering your license key, the license will be activated. This might take a few seconds. The screen will update after successful activation. Additional features will be immediately unlocked. When using a trial license, the features will be available for 30 days before the license reverts to the Free Edition.
By default, CSV-to-ICS Converter will automatically check for updates when started. If an updated version is available, the Check for Updates tab will be displayed. Recent changes will be shown and you can choose if you'd like to update. To perform the update, click the Download Update button. The latest version will be downloaded and CSV-to-ICS Converter will be automatically updated. After updating, it will restart. The whole process should only take a few seconds, depending on your connection speed.
If you prefer CSV-to-ICS Converter to not automatically check for updates when started, this option can be disabled by unchecking the box near the bottom of the Check for Updates tab. You can manually check for updates at any time by clicking the Check for Updates button.
By default, CSV-to-ICS Converter will save its application data and settings to the "\Users\CurrentUserName\AppData\Local\VueSoft\CsvToIcsConverter" folder. This folder is tied to the account profile of the currently logged in Windows user. If you'd like to use a common folder for all user profiles, or if you'd like to run the application as a service, a different data folder can be specified via a "-dataDir" command-line option.
CsvToIcs.exe -dataDir C:\CsvToIcs\Data
CSV-to-ICS Converter already provides a lot of flexibility. It doesn't expect the fields in the input files to be in any specific order, it provides a mechanism to customize how input fields map to output fields, it supports a large variety of field types, and can also handle custom fields it doesn't recognize. However, we realize there may be cases where the format of your CSV file isn't quite compatible and can't be easily modified. There could be other cases where CSV-to-ICS Converter comes really close to what you need, but some minor tweaks would make it a perfect fit.
For those reasons, we offer a service where we can customize CSV-to-ICS Converter for your specific needs. Please contact us with details about your requirements. We'll analyze your requirements and provide you with an estimate on what it would cost to customize CSV-to-ICS Converter for your needs.
Since we're the team that CSV-to-ICS Converter, we're very familiar with how it works and what it would take to be customized. We can perform the customization at a fraction of the cost that paying your own in-house development team would require to implement something else from scratch. We'll also stand behind our work and correct any bugs - free of charge.
If you like what you see in CSV-to-ICS Converter, we can custom develop other software as well. It doesn't need to be a modification to CSV-to-ICS Converter. We're experts at modern Windows app development and can code up just about anything you can imagine. If you have an idea and a budget, but nobody to do the work, please contact us with the details. We'd be happy to help!
Still need help? Please contact us. One of the team members that developed CSV-to-ICS Converter will be happy to assist. If you've purchased a license, your support request will move to the front of the queue.
If you decide you no longer want to use CSV-to-ICS Converter, there's nothing to uninstall. You can simply delete the downloaded file and the desktop shortcut if one was created.
If you're really OCD or like to count the free space on your hard drive in units of KB instead of GB, open your AppData\Local folder and delete the VueSoft\CsvToIcsConverter subfolder and any other folders that start with CsvToIcs.
No other trace of the software will be left on your system - nothing in the Windows registry or anywhere else.
We're here to help. Please let us know if you have any questions, suggestions, or customization requests. You can contact us directly at firstname.lastname@example.org, or by submitting the form below. We'll respond as soon as we can.