# csv2ics

> Convert CSV files into ICS calendars

Latest version **0.1.0** (published 2019-01-22) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install csv2ics
pnpm add csv2ics
yarn add csv2ics
bun add csv2ics
```

Provides the command `csv2ics`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.1.0 |
| Published | 2019-01-22 |
| First published | 2019-01-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 18 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 7 |
| Author | Dennis Ploeger |
| Maintainers | ploeger |
| Keywords | csv, ics, ical |

## Links

- npm: https://www.npmjs.com/package/csv2ics
- Repository: https://github.com/dploeger/csv2ics
- Issues: https://github.com/dploeger/csv2ics/issues
- npm.io page: https://npm.io/package/csv2ics

## Dependencies (6)

- [clime](https://npm.io/package/clime.md) ^0.5.10
- [bluebird](https://npm.io/package/bluebird.md) ^3.5.3
- [fast-csv](https://npm.io/package/fast-csv.md) ^2.4.1
- [loglevel](https://npm.io/package/loglevel.md) ^1.6.1
- [ical-toolkit](https://npm.io/package/ical-toolkit.md) ^1.0.9
- [moment-timezone](https://npm.io/package/moment-timezone.md) ^0.5.23

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 0.1.0 (latest) — 2019-01-22

## README

# csv2ics - Convert CSV files into ICS calendars

![](https://img.shields.io/npm/v/csv2ics.svg) [![Build Status](https://travis-ci.org/dploeger/csv2ics.svg?branch=master)](https://travis-ci.org/dploeger/csv2ics) [![Coverage Status](https://coveralls.io/repos/github/dploeger/csv2ics/badge.svg?branch=master)](https://coveralls.io/github/dploeger/csv2ics?branch=master)

## Introduction

Convert a CSV file into an ICS calendar.

## Header map

csv2ics needs to know which columns are mapped to which ICAL properties. This can not be easily specified through CSV headers, so we rely on the header map.

The header map is a comma separated list of strings that specify the matching ICAL-properties for each column. Certain mapping are detected and handled properly (e.g. the parsing of the date fields). If a mapping is unknown, it is simply added as a custom attribute.

These mappings are detected:

-   SUMMARY
-   DTSTART
-   DTEND
-   DESCRIPTION
-   LOCATION

## Usage

Install csv2ics using npm:

    npm install -g csv2ics

Run it using

    csv2ics <input file.csv> <output file.ics>

Input and output files are optional. If only one file is specified, it is used as an input file. If no file is specified, CSV data is taken from the STDIN.

For option help, use

    csv2ics --help

# Options

Supported options with defaults are:

-   -d, --delimiter \<delimiter\> - Delimiter used in CSV-file [,]
-   -h, --headers - CSV file has headers
-   -m, --header-map \<headerMap\> - A map of headers to ical properties [SUMMARY,DTSTART,DTEND,* DESCRIPTION,LOCATION]
-   --calendar-name \<calendarName\> - Name of calendar [My Calendar]
-   --timezone \<timezone\> - Timezone-ID of the dates of the calendar [UTC]
-   --dateformat \<dateformat\> - Date/Time-Format in CSV (see [https://momentjs.com/docs/#/parsing/string-format/](https://momentjs.com/docs/#/parsing/string-format/)) [YYYY-MM-DD HH:mm:ss]

## Building

To test and build this package, simply use grunt:

    grunt test

---
_Source: https://npm.io/package/csv2ics · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._