# excel-to-vcards

> Convert .csv, .xls and .xlsx files to .vcf files

Latest version **1.0.1** (published 2018-10-24) · ISC license · 0 weekly downloads

## Install

```sh
npm install excel-to-vcards
pnpm add excel-to-vcards
yarn add excel-to-vcards
bun add excel-to-vcards
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2018-10-24 |
| First published | 2018-10-24 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 45.8 KB |
| Known vulnerabilities | 0 (+7 in 2 direct dependencies) |
| Install scripts | no |
| Author | Joris Palings |
| Maintainers | jorispalings |

## Links

- npm: https://www.npmjs.com/package/excel-to-vcards
- npm.io page: https://npm.io/package/excel-to-vcards

## Dependencies (3)

- [xlsx](https://npm.io/package/xlsx.md) ^0.14.0
- [commander](https://npm.io/package/commander.md) ^2.19.0
- [csv-parse](https://npm.io/package/csv-parse.md) ^3.1.3

## Recent versions

- 1.0.1 (latest) — 2018-10-24

## README

# Excel to vCards converter

Command-line tool to easily convert Excel files (.csv, .xls, .xlsx) to vCards (.vcf)

## Prerequisites

[npm and Node.js](https://nodejs.org/en/) are required to install and run the script.

## Installation

```
npm install
```

### Usage

```
node index [options]

Options:
    -v, -V, --version             output the version number
    -i, --input <path>            path to the .csv input file
    -d, --delimiter [delimiter]   delimiter used in the .csv input file
    -o, --output [directory]      output directory for the .vcf file (defaults to current directory)
    -s, --start [row]             1-based index of the first data row (defaults to first row)
    -e, --end [row]               1-based index of the last data row (defaults to last row with data)
    -t, --telephone               whether or not the telephone number should be formatted
    -h, --help                    output usage information
```

Only the `-i` or `--input` option is required.

For minimum required configuration, the input .csv, .xls or .xlsx file should look as follows:
![Input file example](/../screenshots/screenshots/sample-input.png?raw=true)

* To omit header rows, use the `-s` (or `--start`) option.
* To omit trailing rows, use the `-e` (or `--end`) option.

For example: to omit the first row, use `-s 2` or `--start 2` to start with the second row.

## Built with

* [Node.js](https://nodejs.org/en/) - JavaScript runtime
* [node-csv-parse](https://github.com/adaltas/node-csv-parse) - .csv parser
* [js-xlsx](https://github.com/sheetjs/js-xlsx) - .xls and .xlsx parser

## License

This project is licensed under the GNU GPL v3 License - see the [LICENSE](LICENSE) file for details

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