# pxx

> store encrypted values in a json file.

Latest version **1.2.3** (published 2016-05-25) · ISC license · 0 weekly downloads

## Install

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

Provides the command `pxx`.

## 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.2.3 |
| Published | 2016-05-25 |
| First published | 2015-03-10 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | hij1nx |
| Maintainers | hij1nx |
| Keywords | passwords, password |

## Links

- npm: https://www.npmjs.com/package/pxx
- npm.io page: https://npm.io/package/pxx

## Dependencies (4)

- [rc](https://npm.io/package/rc.md) ^0.6.0
- [minimist](https://npm.io/package/minimist.md) ^1.1.0
- [cli-table](https://npm.io/package/cli-table.md) ^0.3.1
- [readline-sync](https://npm.io/package/readline-sync.md) ~0.7.5

## Recent versions

- 1.2.3 (latest) — 2016-05-25
- 1.1.3 — 2016-02-03
- 1.0.3 — 2015-03-11
- 1.0.2 — 2015-03-10
- 1.0.1 — 2015-03-10
- 1.0.0 — 2015-03-10

## README

# SYNOPSIS
Store encrypted values in a json file.

# USAGE
```bash
npm install pxx -g
```

## LIST ALL ITEMS
Provides a nice ascii table that shows the meta data for the contents
of the database.

```bash
pxx
```

```
┌─────────────────┬─────────────┬──────────────────┐
│ Key             │ Description │ Email            │
├─────────────────┼─────────────┼──────────────────┤
│ foobar          │ whatever    │ foobar@gmail.com │
├─────────────────┼─────────────┼──────────────────┤
│ instagram       │ foobar      │ paolo@async.ly   │
├─────────────────┼─────────────┼──────────────────┤
│ rd.io           │ music       │ paolo@gmail.com  │
├─────────────────┼─────────────┼──────────────────┤
│ reddit          │ crap        │ paolo@async.ly   │
├─────────────────┼─────────────┼──────────────────┤
│ speakerdeck.com │ slides      │ paolo@async.ly   │
├─────────────────┼─────────────┼──────────────────┤
│ typography.com  │ pretty      │ paolo@async.ly   │
└─────────────────┴─────────────┴──────────────────┘
```


## READ AN ITEM
Prompts you for the master password and then provides the decrypted data.

```bash
pxx <key>
```

## CREATE AN ITEM
Asks a series of questions about what you want to save to the database.

```bash
pxx --create
```

## DELETE AN ITEM
Completely remove an item from the database.

```bash
pxx --delete <key>
```

## UPDATE AN ITEM
To do... something like...
```
pxx --update <key>
```

# CONFIG
Create an `rc` file that points to a sync'd directory. The `columns` array
represents arbitrary fields that will be stored with the encrypted data.
They can help you describe the data and are displayed when listing the 
contents of the database.

```json
{
  "syncdir": "/Users/username/Google Drive/pxx",
  "algorithm": "aes-256-ctr",
  "columns": ["Key", "Description", "Email"]
}
```

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